Get started
Location data for every country, state and city
Geocoded is a free JSON API for countries, states, cities, airports, ports, border crossings, timezones, currencies, languages and population statistics. There is no sign-up and no API key: send a request and read the JSON.
Every endpoint lives under /v2. Lists come back in the same { data, meta } shape, and single records come back as one object. Try the panel on the right: it sends a real request.
All 39 endpoints
GET/v2Get caller's geo infoGET/v2/reverseReverse geocode a pointGET/v2/searchSearch placesGET/v2/countriesList countriesGET/v2/countries/{id}Get one countryGET/v2/statesList statesGET/v2/states/{id}Get one stateGET/v2/countries/{country}/statesList states in a countryGET/v2/countries/{country}/states/{state}Get one state in a countryGET/v2/citiesList citiesGET/v2/cities/{id}Get one cityGET/v2/countries/{country}/citiesList cities in a countryGET/v2/countries/{country}/cities/{city}Get one city in a countryGET/v2/countries/{country}/states/{state}/citiesList cities in a stateGET/v2/countries/{country}/states/{state}/cities/{city}Get one city in a stateGET/v2/continentsList continentsGET/v2/continents/{id}Get one continentGET/v2/regionsList regionsGET/v2/regions/{id}Get one regionGET/v2/airportsList airportsGET/v2/airports/{id}Get one airportGET/v2/portsList portsGET/v2/ports/{id}Get one portGET/v2/border-crossingsList border crossingsGET/v2/border-crossings/{id}Get one border crossingGET/v2/airlinesList airlinesGET/v2/airlines/{id}Get one airlineGET/v2/timezonesList timezonesGET/v2/timezones/{id}Get one timezoneGET/v2/timezones/{id}/nowCurrent time in a timezoneGET/v2/currenciesList currenciesGET/v2/currencies/{id}Get one currencyGET/v2/languagesList languagesGET/v2/languages/{id}Get one languageGET/v2/statisticsList country statisticsGET/v2/statistics/{id}Get one country statistics rowGET/v2/migrant-stocksList country migrant stocksGET/v2/migrant-stocks/{id}Get one country migrant stock rowGET/v2/metaData version and datasets