Geographic data API
Locations API
Countries, regions, states, and cities — structured geo data you can query in one playground.
Playground
Query countries, regions, states, and cities live.
Optional — try the API without a key (shared tools quota). Public signup is closed during beta — learn more.
All countries
Names, ISO codes, phone codes, and emoji flags for every country.
/locations/countries
API response
Hit fetch to stream JSON here.
Geographic regions
Africa, Americas, Asia, Europe, Oceania, and more — used to group countries.
/locations/regions
API response
Hit fetch to stream JSON here.
States & provinces
Pull every state worldwide, or scope to one country by ID.
/locations/states
Or filter by country
/locations/countries/{id}/states
API response
Fetch all states or pick a country first.
Cities by state
Return every city nested under a state ID.
/locations/states/{id}/cities
API response
Enter a state ID, then fetch cities.
Global geo dataset
Countries, regions, states, and cities ready for production lookups
250+ Countries
ISO codes, dial codes, emoji flags, and names for every recognized country worldwide.
5,000+ States
Provinces, territories, and admin divisions nested under each country ID.
150K+ Cities
City catalogs keyed by state — ready for address forms and geo pickers.
99.9% Uptime
Stable endpoints with fast responses — built for production location lookups.