Quick Start
Get up and running with Geog in under 5 minutes. No credit card required.
1
Get Your API Key
Create an account and generate your API key
Create your account and generate an API key:
- Sign up for a free account
- Create an organization (or use your default personal organization)
- Go to the "API Tokens" section
- Click "Create Token" and give it a descriptive name
- Copy your API key (you won't be able to see it again)
Free tier: 1,000 vector tiles/day + 100 places queries/day. No credit card required.
2
Make Your First Request
Test your API key with a simple search query
Search for a place
curl "https://api.geog.dev/v1/places/search?q=San Francisco" \
-H "X-API-Key: your-api-key-here"Example response (GeoJSON)
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"name": "San Francisco",
"country": "United States",
"region": "California",
"category": "locality",
"confidence": 0.95
},
"geometry": {
"type": "Point",
"coordinates": [-122.4194, 37.7749]
}
}
]
}3
Explore More Endpoints
Try reverse geocoding with coordinates or load vector tiles for mapping
Reverse Geocoding
GET /v1/places/reverse?lat=37.7749&lon=-122.4194Convert coordinates to place details
Vector Tiles
GET /v1/tiles/{z}/{x}/{y}.mvtStandard XYZ tile endpoints (MVT format)
Next Steps
Dive deeper into the API with detailed reference docs and working code samples