City API

GET /city/{name}

Find a city by exact name, typeahead search (?q=), or coordinates. Name lookups pin one city (the largest, if there is a tie). Coordinate lookups return the nearest place plus distance in miles and kilometers.

Every city comes from its official national gazetteer. name is the English catalog name, local_name carries the native form when it differs, Tokyo's local_name reads 東京.

Need the state or postal record itself? Use /state/{code} or /postal/{code}.

480k+
official gazetteer places: 27
countries curated: 100%
official national sources: 100%
timezone coverage

Try it

$ curl "https://api.parseapi.com/city/charlotte" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~17ms · USA
{
  "name": "Charlotte",
  "local_name": null,
  "state": "NC",
  "state_name": "North Carolina",
  "country": "US",
  "latitude": 35.2271,
  "longitude": -80.8431,
  "population": 874579,
  "timezone": "America/New_York",
  "id": "city_mb8mbqrkz8zb"
}

Response fields

name: City name
local_name: Local-language name (null when same as name)
state: State or province code
state_name: State or province name
country: ISO2 country code
latitude: Latitude
longitude: Longitude
population: Population
timezone: Timezone identifier
distance: Kilometers from query point (coords only)
distance_mi: Miles from query point (coords only)
id: Stable city id (city_...). Fetch again at /city/id/{id}

SPEED

Fast from everywhere.

Median time for a /city response to reach a real city, first byte back, measured live from 16 cities. Not a lab benchmark. The whole trip.

17ms

24ms

APAC

48ms

LatAm

21ms

125ms

See live status →

Coverage

Twenty-seven countries, each from its official national gazetteer.

United States
Puerto Rico
Canada
Mexico
Brazil
United Kingdom
Ireland
France
Spain
Portugal
Belgium
Netherlands
Germany
Austria
Switzerland
Liechtenstein
Italy
Denmark
Sweden
Norway
Finland
Poland
Czechia
Japan
Taiwan
Australia
New Zealand

Create a free key Docs