180,000

cities, states, districts, and
neighborhoods indexed worldwide.

180,000 cities, states, districts, and neighborhoods across the globe — with administrative hierarchy, geographic coordinates, and typo-tolerant search. A simple REST API with a free tier.

Free tier
50 req / day
Place types
4 categories
Endpoints
3 REST

Three ways to consume the catalog

Select the endpoint suited to each use case.

POST /geo/resolve

Find the smallest region a list of cities share

Given a list of place names, the API returns the smallest administrative region they have in common — state, region, or country. Common applications include geographic segmentation and territorial coverage analysis.

# Request
Cuiabá
Sinop
Rondonópolis

# Response
{
  "region": "Mato Grosso",
  "type": "state",
  "region_id": 3457419
}
GET /geo/search?q=cmpinas

Search by name, tolerating typos and accents

Locate cities, states, districts, and neighborhoods while tolerating typos, missing accents, and spelling variations. Suitable for autocomplete inputs, address validation, and data normalization.

# Response
[
  { "id": 6320, "name": "Campinas",        "type": "city" },
  { "id": 7104, "name": "Campinas do Sul",  "type": "city" }
]
GET /geo/place/3457419

Retrieve full details for any place

Returns geographic coordinates, population, administrative type, and parent hierarchy for any place in the catalog. Used for record enrichment, detail pages, and reference data lookups.

# Response
{
  "id": 3457419,
  "name": "Mato Grosso",
  "type": "state",
  "lat": -12.6,
  "lon": -55.4,
  "population": 3658649,
  "parent": {
    "id": 76,
    "name": "Brasil",
    "type": "country",
    "parent": null
  }
}

Simple, prepaid pricing

Buy credits upfront. Pay only for what you use.

Free
R$ 0
50 requests / day
Get started
R$ 10
10.000 credits
Get started
R$ 15
25.000 credits
Get started
R$ 25
50.000 credits
Get started