API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.
Start with these files — they give you everything you need to understand and access the dataset.
- 1. Fetch datapackage.json to inspect schema and resources
- 2. Download data resources listed in datapackage.json
- 3. Read README.md for full context
Data Files
Explore with AIPopulation growth (annual %) by entity and year
| Field | Type | Description |
|---|---|---|
| country_code | string | World Bank 3-letter entity code (ISO 3166-1 alpha-3 for countries; World Bank codes such as WLD, HIC, SSF for aggregates). |
| country_name | string | World Bank entity name. |
| is_aggregate | boolean | true for regions, income groups and other World Bank aggregates; false for individual economies. |
| year | year | Calendar year t. |
| population_growth_pct | number | Annual population growth, percent: exponential growth rate of midyear population from year t-1 to t. Empty where the World Bank publishes no estimate. |
Download
Download CSVAbout
- Last updated
- 10 October 2026
- Total rows
- ...
- Format
- CSV
- File size
- 796 kB
- Sources
- World Bank, World Development Indicators — Population growth (annual %) (SP.POP.GROW), via the Indicators API v2
- World Bank Data Catalog — World Development Indicators (licence: CC BY 4.0)
- Upstream: United Nations Population Division, World Population Prospects; national statistical offices; Eurostat; UN Statistics Division (as listed in the indicator metadata)
World Bank entities (economies and aggregates)
| Field | Type | Description |
|---|---|---|
| country_code | string | World Bank 3-letter entity code. |
| iso2_code | string | World Bank 2-letter code (ISO 3166-1 alpha-2 for economies; World Bank codes for aggregates, e.g. XD = High income). |
| country_name | string | World Bank entity name (trailing spaces in the API trimmed). |
| is_aggregate | boolean | true when the API places the entity in the placeholder region "Aggregates". |
| region_code | string | World Bank region code; empty for aggregates. |
| region_name | string | World Bank region name; empty for aggregates. |
| income_level_code | string | World Bank income group code; empty for aggregates. |
| income_level_name | string | World Bank income group name; empty for aggregates. |
| lending_type_code | string | World Bank lending type code; empty for aggregates. |
| lending_type_name | string | World Bank lending type name; empty for aggregates. |
| capital_city | string | Capital city; empty where not given. |
| longitude | number | Capital city longitude, decimal degrees; empty where not given. |
| latitude | number | Capital city latitude, decimal degrees; empty where not given. |
Download
Download CSVAbout
- Last updated
- 10 October 2026
- Total rows
- ...
- Format
- CSV
- File size
- 28.1 kB
- Sources
- World Bank, World Development Indicators — Population growth (annual %) (SP.POP.GROW), via the Indicators API v2
- World Bank Data Catalog — World Development Indicators (licence: CC BY 4.0)
- Upstream: United Nations Population Division, World Population Prospects; national statistical offices; Eurostat; UN Statistics Division (as listed in the indicator metadata)
About this dataset
Annual population growth, as a percentage, for 217 economies and 48 World Bank aggregates (regions, income groups and the World), 1960–2025. This is World Bank World Development Indicators series SP.POP.GROW: the exponential rate of growth of midyear population from year t-1 to t. Snapshot of the World Bank Indicators API taken 2026-09-18 (WDI last updated 2026-07-13).
| Resource | Content |
|---|---|
data/population-growth.csv | One row per entity and year (17,490 rows), keyed on country_code + year, with country_name, is_aggregate and population_growth_pct |
data/countries.csv | One row per World Bank entity (295, of which 78 aggregates), keyed on country_code: 2-letter code, region, income level, lending type, capital city and its coordinates |
World population growth peaked at 2.12% in 1963 and was 0.91% in 2025. In 2025, 49 of the 217 economies shrank. Every field is typed and described in datapackage.json.
Reading the data
- Do not sum aggregates with countries. Rows for regions, income groups and the World have
is_aggregatetrue. Filter on it before adding anything up. - Missing values are empty cells. An empty
population_growth_pct(362 rows) means the World Bank publishes no estimate for that entity and year. A0is a real value. - Aggregates have no region, income level or lending type. The API gives them a placeholder region
NA, "Aggregates", which would collide with Namibia's 2-letter codeNA, so those columns are left empty for aggregates. - Codes.
country_codeis the World Bank's 3-letter code: ISO 3166-1 alpha-3 for economies, World Bank codes such asWLD,HICandSSFfor aggregates. The API leaves the 3-letter code empty for the five income-group aggregates; the build maps them from their 2-letter codes (for exampleXDtoHIC).
How it is built
fetch.ts snapshots the paged API responses, the country metadata and the indicator metadata into archive/, recording each URL, retrieval time and SHA-256. build.ts reads only that snapshot, asserts the shape it expects (one-to-one code mapping, constant unit and decimal fields, every observation matched to an entity) and writes both CSVs deterministically. No dependencies:
node fetch.ts # reuses the snapshot unless --refresh
node build.ts
The scripts and raw snapshot live in the DataPressr repository, not on DataHub.
Source and licence
World Bank, World Development Indicators, indicator SP.POP.GROW, via the Indicators API v2. The World Bank compiles it from the UN Population Division's World Population Prospects, national statistical offices, Eurostat and the UN Statistics Division. Licensed CC BY 4.0: attribute the World Bank.
Relation to core datasets
DataHub has no core/population-growth. core/population is a different World Bank indicator (total population, SP.POP.TOTL), not growth rates.