Skip to content
Geocoded
Free location data API

Location data for every country, state and city.

Clean, consistent data for 252 countries, 5,056 states and provinces and 235,669 cities, plus airports, ports, timezones, currencies and population statistics. No sign-up. No API key. Just JSON.

Get started Explore the data
  • Free to use
  • No API key
  • Open source
  • Updated daily
GET api.geocoded.me/v2/ 
{
  "ip": "203.0.113.42",
  "city": "Tokyo",
  "region": "Tokyo", "regionCode": "13",
  "country": "JP", "continent": "AS", "isEU": false,
  "latitude": "35.68536", "longitude": "139.75309",
  "timezone": "Asia/Tokyo",
  "countryInfo": { "name": "Japan", "currency": "JPY", "…" },
  "stateInfo": { "…" }, "cityInfo": { "…" }
}

One request tells you where a visitor is: country, region, city, timezone and currency. Use it to prefill forms, pick a default currency or show local time.

Coverage that goes all the way down.

From capitals to small towns. Every point on this map is a city in Geocoded, plotted from its real coordinates.

Countries and territories
252
States and provinces
5,056
Cities and towns
235,669
TokyoMexico CitySão PauloNew YorkLagosDelhi
Use cases

Built for the location features every product needs.

01

Address and sign-up forms

Country, state and city pickers that stay in sync, with postal code formats and phone prefixes for validation.

Countries · States · Cities
02

Localisation

Set the right currency, timezone, clock format and first day of the week for every visitor automatically.

IP lookup · Currencies · Timezones
03

Travel and logistics

Airports with IATA codes, seaports and border crossings, each with coordinates and country.

Airports · Ports · Airlines
04

Research and dashboards

Population, age, income, life expectancy and migration for every country, ready to chart.

Statistics · Migration
What's included

Ten datasets, one consistent API.

Browse the API reference →
Countries 252 Names, ISO codes, capitals, flags, calling codes and languages. States and provinces 5,056 Every first-level region with ISO 3166-2 codes. Cities 235,669 Coordinates, population and timezone for each. Airports 23,574 IATA codes, elevation and location. Ports 17,500 Seaports and river ports with UN/LOCODE codes. Border crossings 484 Official land crossing points. Airlines 377 IATA member airlines with designators. Timezones 312 UTC offsets and daylight saving rules. Currencies 178 Symbols, decimals and where each is used. Languages 7,927 Every living and historic language code.
For developers

Ask for exactly what you need.

Filter by country or state, sort by any field and return only the fields you use. Every list comes back paginated in the same shape, so your code stays simple.

  • Look up places by name or ISO code
  • Nested routes: country, state, city
  • Cached at the edge for fast responses worldwide
  • OpenAPI 3.1 spec and a TypeScript client
curl "https://api.geocoded.me/v2/countries/JP/states/Tokyo/cities
  ?sort=-population&fields=name,population&limit=3"
{
  "data": [
    { "name": "Tokyo",    "population": 9733276 },
    { "name": "Setagaya", "population": 940071 },
    { "name": "Ōta",      "population": 748081 }
  ],
  "meta": { "total": 221, "limit": 3, "hasMore": true }
}

Instant search for any place.

Type a name and get matching countries, states and cities in one request. Ideal for location autocomplete.

    The world in numbers

    More than places: the people in them.

    See all insights →
    Japan 30%

    of Japanese residents are 65 or older, the second-highest share in the world after Monaco.

    Source: World Bank, 2025
    Qatar 91.6%

    of people living in Qatar were born in another country.

    Source: UN DESA, 2024
    Central African Republic 48.7%

    of the population is under 15, the youngest country in the world.

    Source: World Bank, 2025
    Questions

    Frequently asked.

    Is Geocoded really free?

    Yes. The API is free to use, with no sign-up and no API key. The source code is open under the MIT licence.

    Can I use it in a commercial product?

    Yes. The data is published under CC BY 4.0, which allows commercial use. Credit Geocoded and its sources when you redistribute the data.

    Where does the data come from?

    GeoNames, the World Bank, UN DESA, UN/LOCODE, IATA, IANA, ISO and Unicode CLDR. Every dataset lists its source and year.

    How current is it?

    Datasets are refreshed from their sources and republished daily.

    How fast is it?

    Responses are served and cached at the edge, close to your users, so repeat requests return almost instantly.

    Make your first request in under a minute.

    Read the quick start