NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Population Data API

GET

Look up country demographic records by ISO country code.

A country population and demographic data API. Look up any country by ISO code to get its population data, with total population, world population rank and share, growth rate, density, urban/rural breakdown, and life expectancy on paid plans.

Try it — live request, no key required

Request
GETapi.apiverve.com/v1/population?country=US
Query parameters
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "country": "US",
    "countryName": "United States",
    "year": 2025,
    "count": 1,
    "historical": [
      {
        "year": 2025,
        "population": 341784857,
        "populationFormatted": "341.78 million",
        "growthRate": 0.52,
        "urbanPercent": 80.19
      }
    ]
  }
}

About the Population Data API

Population API provides detailed demographic data from the World Bank for every country. Send a two- or three-letter country code and get the latest year on record, or retrieve data for a specific year dating back to 1960.

Each record holds total population as an exact count and a readable string such as 341.78 million, the annual growth rate, population density per square kilometre, the share of people living in urban areas, and life expectancy at birth. It also ranks the country by population among all countries for that year, with the number of countries ranked and its percentage of world population. It suits country profile pages, per-capita calculations, market sizing, education apps and demographic research.

The Free plan resolves the country and returns the latest year available for it. Paid plans return the figures themselves, the population count, world rank and share, growth rate, density, urban share and life expectancy, and add lookups for any year from 1960 onward.

How it works

A collector pulls five World Bank indicators daily: total population (SP.POP.TOTL), annual growth (SP.POP.GROW), urban population share (SP.URB.TOTL.IN.ZS), population density (EN.POP.DNST) and life expectancy at birth (SP.DYN.LE00.IN). It stores one record per country per year from 1960 and keeps the newest year as the latest record.

country accepts ISO 3166 alpha-2 or alpha-3 codes; two-letter codes are mapped to three-letter ones before lookup, and Kosovo is handled as XK. Without year you get the newest stored year. year (paid) must be between 1960 and the current year, otherwise the request is rejected with a 400, and a year with no record returns a 404.

The response always wraps the figures in a historical array with one entry, and count is 1. population is the raw count and populationFormatted its readable form. growthRate is the year-on-year change in percent and can be negative. density is people per square kilometre of land and urbanPercent is the urban share in percent, both rounded to two decimals. Indicators publish on different schedules, so the newest year often has a population count before density or life expectancy are released; those fields are null until the World Bank fills them, and a reported zero is kept as zero rather than treated as missing.

worldRank ranks the country by population among the countries and territories that report a population that year (about 217); World Bank regional, income and lending aggregates are excluded. Ranking is per year, so a historical lookup returns the rank for that year. Ties share a rank and the next rank is skipped. rankedCountries is the number ranked, and worldPercent is the population divided by the World Bank world total (WLD) for the year, as a percentage to four decimals; the world total also counts Taiwan, which the World Bank does not list separately, so the shares of all ranked countries add up to slightly under 100. All three are null when the year has no ranking or the code is not a ranked country.

What people use it for

Market Expansion Sizing
When evaluating entry into emerging markets, retail planners pull total population and urban percentage to gauge addressable customer density.
Demographic Trend Modeling
Academic research tools query historical growth rates and life expectancy across decades to model regional aging patterns.
Broadband Network Planning
Telecom planners cross-reference population density and urban shares to prioritize where to deploy new broadband fiber networks.
Sovereign ESG Scoring
To assess national health and development indicators, sovereign ESG platforms fetch country life expectancy and population growth figures.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Population Data

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Population Data API.

Read the docs →
Which countries and date ranges can I query?
You can query any country using standard two-letter or three-letter ISO country codes, such as US or USA. Every plan gets the latest year; paid plans can query data from 1960 to the present.
Where does the population data come from and how often is it updated?
The data is sourced directly from the World Bank. Records are updated on a monthly basis to keep demographic figures current.
Are growth rates, life expectancy, and historical records available on the Free plan?
No. The Free plan only returns current high-level country information. Detailed metrics like population counts, growth rates, population density, urban percentages, life expectancy, and specific year queries require a Starter plan or higher.
How far does the Starter plan go for population lookups?
Each query costs 2 credits, giving you 100,000 population lookups each month on the Starter plan. That works out to about $0.30 per 1,000 lookups. The Free plan includes 100 lookups per month to test your integration.
What data is returned if I omit the year parameter?
If you do not specify a year, the query automatically returns the latest available demographic statistics for that country.
How is the world population rank calculated?
Countries are ranked by total population within the same year as the record, so a 1990 lookup returns the 1990 rank. Only the roughly 217 countries and territories in the World Bank data are ranked; regional and income-group aggregates such as World, Euro area or High income are excluded. Countries with identical populations share a rank. The share of world population divides by the World Bank's world total for that year. If no ranking exists for a year, the rank fields are null.
Can I use this population data inside a commercial application?
Yes, provided you are on a paid plan. You can display and use demographic data inside your own apps, reports, and dashboards, but you cannot resell or redistribute the raw data as a standalone product.

Ready to build with Population Data? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog

300+ APIs on the same key and the same response shape.

Browse all APIs