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.",
  "capital_lat": 38.89,
  "capital_lon": -77.05,
  "continent": "NA",
  "region": "Americas",
  "subregion": "Northern America",
  "population": 340110988,
  "area": 9629091,
  "currency": "USD",
  "currency_name": "United States Dollar",
  "currency_symbol": "$",
  "tld": ".us",
  "calling_code": "+1",
  "emoji": "🇺🇸",
  "languages": [
    "en"
  ],
  "borders": [
    "CA",
    "MX"
  ],
  "blocs": [
    "G7",
    "NATO",
    "OECD"
  ],
  "timezones": [
    "America/Adak",
    "America/Anchorage",
    "America/Boise",
    "America/Chicago",
    // ... 25 more
  ],
  "week_start": "sunday",
  "units": "imperial",
  "driving_side": "right",
  "plugs": [
    "A",
    "B"
  ],
  "voltage": 120,
  "frequency": 60,
  "emergency": {
    "police": "911",
    "ambulance": "911",
    "fire": "911"
  },
  "postal_format": "#####",
  "postal_regex": "^(?:(\\d{5})(?:[ \\-](\\d{4}))?)$",
  "tax": null,
  "tax_rate": null,
  "tax_id_format": null,
  "tax_id_regex": null,
  "ioc": "USA",
  "fifa": "USA",
  "plate": "USA"
}

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

{
  "state": "CO",
  "name": "Colorado",
  "local_name": "Colorado",
  "type": "state",
  "country": "US",
  "country_name": "United States",
  "latitude": 38.725178,
  "longitude": -105.607716,
  "population": 5957493,
  "area": 269837,
  "timezone": "America/Denver",
  "timezones": [
    "America/Denver"
  ],
  "iso_3166_2": "US-CO",
  "fips": "08",
  "capital": "Denver",
  "area_codes": [
    "303",
    "719",
    "720",
    "970"
  ],
  "tax": "Sales tax",
  "tax_rate": 2.9
}

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

{
  "name": "Charlotte",
  "local_name": null,
  "type": "city",
  "capital_of": null,
  "state": "NC",
  "state_name": "North Carolina",
  "district": "37119",
  "district_name": "Mecklenburg",
  "country": "US",
  "country_name": "United States",
  "latitude": 35.209045,
  "longitude": -80.83099,
  "elevation": 209,
  "elevation_ft": 686,
  "population": 943476,
  "area": 813.48,
  "land_area": 808.33,
  "water_area": 5.15,
  "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",
  "country_name": "United States",
  "latitude": 25.779391,
  "longitude": -80.151566,
  "elevation": 6,
  "elevation_ft": 20,
  "population": 33753,
  "area": 15.3,
  "land_area": 7.21,
  "water_area": 8.09,
  "timezone": "America/New_York",
  "currency": "USD",
  "tax": "Sales tax",
  "tax_rate": null,
  "tax_rate_state": null,
  "tax_rate_county": null,
  "tax_rate_city": null,
  "tax_rate_special": null,
  "neighbors": [
    "33132",
    "33109",
    "33131",
    "33137",
    "33140",
    "33101",
    "33128",
    "33130"
  ]
}

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