Population by country API: World Bank totals, growth and urban share

$0.01 per call · failed calls are never charged · no account or API key needed

Population of any country from World Bank data: total population, annual population growth in % and the urban share of the population in %, for the last 1-10 years with the newest year first. Country by ISO code (SE, SWE) or English name. Read from a committed World Bank Open Data snapshot (CC BY 4.0), so every call answers at once; the snapshot date is in the answer. Use for market sizing, per-capita figures and demographics.

When to use it

Run it free (25 free calls) Buy credits by card (from $5) Example result (JSON)

Try it with your own inputs

ISO 3166 code (SE, SWE) or English country name (Sweden)

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
country (required)stringISO 3166 code (SE, SWE) or English country name (Sweden)
yearsintegerYears of history to return, 1-10 (default 5)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/econ/population?country=SE"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/econ/population?country=SE&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.

Example result

{
  "country": {
    "code": "SWE",
    "name": "Sweden",
    "iso2": "SE",
    "region": "Europe & Central Asia",
    "incomeLevel": "High income",
    "capital": "Stockholm"
  },
  "population": {
    "indicator": "Population, total",
    "latest": {
      "year": 2025,
      "value": 10596620
    },
    "values": [
      {
        "year": 2025,
        "value": 10596620
      }
    ]
  },
  "populationGrowth": {
    "indicator": "Population growth (annual %)",
    "latest": {
      "year": 2025,
      "value": 0.25
    },
    "values": [
      {
        "year": 2025,
        "value": 0.25
      }
    ]
  },
  "urbanShare": {
    "indicator": "Urban population (% of total population)",
    "latest": {
      "year": 2025,
      "value": 89
    },
    "values": [
      {
        "year": 2025,
        "value": 89
      }
    ]
  },
  "source": "World Bank Open Data (CC BY 4.0), snapshot 2026-10-22"
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is econ_population, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Questions

Where does the data come from?

A committed snapshot of World Bank Open Data (CC BY 4.0); the snapshot date is in every answer.

Which countries are covered?

The 217 World Bank economies; aggregates such as regions are not included.

How do I pay?

Each successful call costs $0.01; failed calls are not charged. The first 25 calls are free. Then pay with card credits (from $5) or per call in USDC over x402 or MPP. No account or API key is needed.

Related tools