Population

A field on country, state, city, postal, and continent.

Need a population estimate? Look up the place. Country, state, city, postal, and continent responses all include a population field. No separate endpoint, and no extra query param. Estimates, refreshed on a schedule.

Where it lives

GET

api.parseapi.com/country/{code}

Country, includes population

GET

api.parseapi.com/state/{code}?country={iso2}

State or province, includes population

GET

api.parseapi.com/city/{name}

City, includes population

GET

api.parseapi.com/postal/{code}?country={iso2}

Postal / ZIP, includes population

GET

api.parseapi.com/continent/{code}

Continent, includes population

curl "https://api.parseapi.com/country/us" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "country": "US",
  "iso3": "USA",
  "numeric": 840,
  "name": "United States",
  "full_name": "United States of America",
  "local_name": "United States",
  "demonym": "American",
  "capital": "Washington, D.C.",
  "continent": "NA",
  "region": "Americas",
  "subregion": "Northern America",
  "population": 331002651,
  "area": 9833520,
  "currency": "USD",
  "currency_name": "United States Dollar",
  "currency_symbol": "$",
  "tld": ".us",
  "emoji": "🇺🇸",
  "languages": [
    "en"
  ],
  "borders": [
    "CA",
    "MX"
  ]
}

curl "https://api.parseapi.com/state/nc?country=US" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "state": "NC",
  "name": "North Carolina",
  "local_name": "North Carolina",
  "type": "state",
  "country": "US",
  "country_name": "United States",
  "latitude": 35.5,
  "longitude": -79.8,
  "population": 10439388,
  "area": 139391,
  "timezone": "America/New_York"
}

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

{
  "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"
}

curl "https://api.parseapi.com/postal/33139?country=US" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "postal": "33139",
  "city": "Miami Beach",
  "city_local": null,
  "district": "12086",
  "district_name": "Miami-Dade",
  "district_name_local": null,
  "state": "FL",
  "state_name": "Florida",
  "state_name_local": null,
  "country": "US",
  "latitude": 25.7823,
  "longitude": -80.1375,
  "elevation": 1,
  "elevation_ft": 3,
  "population": 38000,
  "timezone": "America/New_York",
  "currency": "USD",
  "neighbors": [
    "33140",
    "33141",
    "33154"
  ]
}

curl "https://api.parseapi.com/continent/na" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "continent": "NA",
  "name": "North America",
  "region": "Americas",
  "subregion": "Northern America",
  "population": 600000000,
  "area": 24709000,
  "emoji": "🌎"
}

District lists under /state/{code}/districts also carry population when available.

Questions? Email