Quick Start

Create your account and generate an API key:

1. Sign up for a free account
2. Create an organization (or use your default personal organization)
3. Go to the "API Tokens" section
4. Click "Create Token" and give it a descriptive name
5. Copy your API key (you won't be able to see it again)

Free tier: 2,000 vector tiles/day + 1,000 places queries/day. No credit card required.

Search for a place

curl -X POST "https://api.geog.dev/v1/places/search" \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"query": "San Francisco", "location": {"lat": 37.7749, "lon": -122.4194}}'

Example response

{
  "results": [
    {
      "id": "8529a969fffffff_n26819236",
      "name": "San Francisco",
      "location": { "lat": 37.7749, "lon": -122.4194 },
      "categories": ["locality"],
      "address": {
        "city": "San Francisco",
        "state": "CA",
        "country": "US"
      },
      "score": 0.95
    }
  ],
  "total": 1,
  "executionTime": 32,
  "metadata": {
    "shardsSearched": 2,
    "cacheHit": false
  }
}