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

$0.001 per call with a key ($0.01 paid per call from a wallet) · failed calls are never charged · no account needed: a card key or USDC

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

Get a country's total population, growth rate and urban share for the last 1-10 years
Compute per-capita figures from a total you already have
Compare countries by ISO code or English name

Run it free (3 free calls) Buy credits by card (from $1) Example result (JSON)

$0.001 per call with prepaid credits: $1 by card pays for 1,000 calls, with no account and no subscription.

Inputs

Name	Type	Description
`country` (required)	string	ISO 3166 code (SE, SWE) or English country name (Sweden)
`years`	integer	Years of history to return, 1-10 (default 5)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://glyphcall.com/econ/population?country=SE"

Or one of your 3 free calls, no key:

curl "https://glyphcall.com/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 or Solana over x402; Base or Tempo over MPP) 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-11-10"
}

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://glyphcall.com/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 3 calls are free (25 through an MCP client). Then pay with card credits (from $1; the key goes in an Authorization header or, for clients that can only fetch a URL, as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.