Cities API
Everything is a place. The Cities API gives you unified access to 13+ million geographic features — cities, lakes, mountains, airports, parks — through one consistent interface. Query any feature type the same way: search, filter, calculate distances, find what's nearby. Plus 252 countries, 418 timezones, and 1.8 million postal codes. 84 fast REST endpoints. View API Documentation ## Everything…
Cities API endpoints
| Method | Endpoint | Description |
|---|---|---|
| validate | ||
| GET |
/validate/postal-code/{country}/{code} /validate/postal-code/{country}/{code} |
Check if a postal code exists for a given country |
| GET |
/validate/coordinates /validate/coordinates |
Validate geographic coordinates and check if they are on land |
| convert | ||
| GET |
/convert/temperature /convert/temperature |
Convert between temperature units: c (Celsius), f (Fahrenheit), k (Kelvin) |
| GET |
/convert/coordinates /convert/coordinates |
Convert between decimal degrees (dd) and degrees-minutes-seconds (dms) formats |
| GET |
/convert/distance /convert/distance |
Convert between distance units: km, mi, nm, m, ft |
| GET |
/convert/area /convert/area |
Convert between area units: sqkm, sqmi, ha, acre |
| GET |
/convert/speed /convert/speed |
Convert between speed units: kmh, mph, knots, ms |
| GET |
/convert/elevation /convert/elevation |
Convert between elevation units: m, ft |
| places | ||
| GET |
/places/{id}/shipping-hub /places/{id}/shipping-hub |
Analyzes if a place is a shipping hub based on nearby ports, airports, and population |
| GET |
/places/{id}/parent /places/{id}/parent |
Get parent place |
| GET |
/places/{id}/utc-offset /places/{id}/utc-offset |
Get UTC offset and timezone information |
| GET |
/places/{id}/antipode /places/{id}/antipode |
Get the antipode (opposite point on Earth) for a place |
| GET |
/places/{id}/hemisphere /places/{id}/hemisphere |
Get hemisphere and geographical position information |
| GET |
/places/route /places/route |
Calculate route between waypoints |
| GET |
/places/by-currency /places/by-currency |
Find places by currency |
| GET |
/places /places |
Search all geographic features with flexible filtering |
| GET |
/places/along-route /places/along-route |
Find places along a route |
| GET |
/places/bearing /places/bearing |
Calculate bearing between places |
| GET |
/places/nearby /places/nearby |
Find all places near given coordinates |
| GET |
/places/{id}/population-rank /places/{id}/population-rank |
Get population rank for place |
| GET |
/places/time-at /places/time-at |
Get current time at specific geographic coordinates |
| GET |
/places/{id}/nearby /places/{id}/nearby |
Find places near a specific place |
| GET |
/places/midpoint /places/midpoint |
Calculate geographic midpoint |
| GET |
/places/same-timezone /places/same-timezone |
Find places in same timezone |
| GET |
/places/{id}/climate-zone /places/{id}/climate-zone |
Get climate zone |
| GET |
/places/distance /places/distance |
Calculate distance between two places |
| GET |
/places/extremes /places/extremes |
Get extreme places |
| GET |
/places/sun-times /places/sun-times |
Get sun times for coordinates |
| GET |
/places/bbox /places/bbox |
Search places in bounding box |
| GET |
/places/reverse /places/reverse |
Find the nearest place to coordinates |
| GET |
/places/compare /places/compare |
Compare two places |
| GET |
/places/{id} /places/{id} |
Get detailed information about a specific place |
| GET |
/places/{id}/local-info /places/{id}/local-info |
Get timezone, currency, phone code, and language information |
| GET |
/places/{id}/sun-times /places/{id}/sun-times |
Get sunrise, sunset, and day length information |
| GET |
/places/{id}/local-time /places/{id}/local-time |
Get the current local time at a place |
| GET |
/places/{id}/metro-area /places/{id}/metro-area |
Get metro area information including nearby populated places and aggregated population statistics |
| GET |
/places/{id}/names /places/{id}/names |
Get alternate names |
| GET |
/places/{id}/children /places/{id}/children |
Get child places |
| timezones | ||
| GET |
/timezones/{id} /timezones/{id} |
Get detailed information about a specific timezone, including current time. The ID can use hyphens instead of slashes (e.g., America-New_York) |
| GET |
/timezones /timezones |
Get a paginated list of all timezones, optionally filtered by country code |
| timezone-at | ||
| GET |
/timezone-at /timezone-at |
Find the timezone at a specific geographic location by finding the nearest city with timezone information |
| time-difference | ||
| GET |
/time-difference /time-difference |
Calculate the time difference between two places, showing their current local times and UTC offsets |
| postal-codes | ||
| GET |
/postal-codes /postal-codes |
Get a paginated list of postal codes for a specific country, with optional search prefix |
| GET |
/postal-codes/nearby /postal-codes/nearby |
Find postal codes near a geographic location, sorted by distance |
| GET |
/postal-codes/{country}/{code} /postal-codes/{country}/{code} |
Get detailed information about a specific postal code in a country. A single postal code may cover multiple places. |
| countries | ||
| GET |
/countries/g20 /countries/g20 |
List G20 countries |
| GET |
/countries/commonwealth /countries/commonwealth |
List Commonwealth countries |
| GET |
/countries/eu-members /countries/eu-members |
List EU member countries |
| GET |
/countries/islands /countries/islands |
List island nations |
| GET |
/countries/localization/{code} /countries/localization/{code} |
Get country names in all languages |
Cities API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 1 / second |
|
| PRO | $19.99 / month | 10 / second |
|
| ULTRA | $39.99 / month | 20 / second |
|
| MEGA | $79.99 / month | 30 / second |
|