Population Growth

API Access

Access dataset files directly from scripts, code, or AI agents.

Browse dataset files

Dataset Files

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.

/core/population-growth-estimates-and-projections/

├ .datahub/datapackage.json

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/.datahub/datapackage.json

├ .datahub/flow.yaml

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/.datahub/flow.yaml

├ README.md

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/README.md

├ UPDATE_SCRIPT_MAINTENANCE_REPORT.md

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/UPDATE_SCRIPT_MAINTENANCE_REPORT.md

├ data/population-constant-fertility.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-constant-fertility.csv

├ data/population-constant-mortality.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-constant-mortality.csv

├ data/population-estimates.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-estimates.csv

├ data/population-high-fertility.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-high-fertility.csv

├ data/population-instant-replacement.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-instant-replacement.csv

├ data/population-low-fertility.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-low-fertility.csv

├ data/population-medium-fertility.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-medium-fertility.csv

├ data/population-momentum.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-momentum.csv

├ data/population-no-change.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-no-change.csv

├ data/population-zero-migration.csv

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/data/population-zero-migration.csv

├ datapackage.json

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/datapackage.json

├ pipeline-spec.yaml

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/pipeline-spec.yaml

└ population_estimates_flow.py

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/population_estimates_flow.py

Key Files

Start with these files — they give you everything you need to understand and access the dataset.

.datahub/datapackage.json— metadata & schema

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/.datahub/datapackage.json

README.md— documentation

https://datahub.io/core/population-growth-estimates-and-projections/_r/-/README.md

Typical Usage

1. Fetch .datahub/datapackage.json to inspect schema and resources
2. Download data resources listed in .datahub/datapackage.json
3. Read README.md for full context

Data Previews

population-estimates

Loading data...

Schema

name	type	format
Region	string	default
Country Code	string	default
Year	string	default
Population	string	default

population-low-fertility

Loading data...

Schema

name	type	format
Region	string	default
Country Code	string	default
Year	string	default
Population	string	default

population-medium-fertility

Loading data...

Schema

name	type	format
Region	string	default
Country Code	string	default
Year	string	default
Population	string	default

population-high-fertility

Loading data...

Schema

name	type	format
Region	string	default
Country Code	string	default
Year	string	default
Population	string	default

population-constant-fertility

Loading data...

Schema

name	type	format
Region	string	default
Country Code	string	default
Year	string	default
Population	string	default

Data Files

File	Size	Last modified	Download
population-estimates	583 kB	26 days ago	population-estimates
population-low-fertility	761 kB	26 days ago	population-low-fertility
population-medium-fertility	763 kB	26 days ago	population-medium-fertility
population-high-fertility	764 kB	26 days ago	population-high-fertility
population-constant-fertility	764 kB	26 days ago	population-constant-fertility
population-instant-replacement	762 kB	26 days ago	population-instant-replacement
population-momentum	763 kB	26 days ago	population-momentum
population-zero-migration	762 kB	26 days ago	population-zero-migration
population-constant-mortality	763 kB	26 days ago	population-constant-mortality
population-no-change	764 kB	26 days ago	population-no-change

Files	Size	Format	Created	Updated	License	Source
10	7.45 MB	csv		1 day ago

Total Population - Both Sexes. De facto population in a country, area or region as of 1 July of the year indicated. Figures are presented in thousands.

Data

Data comes from United Nations' Population Division datasets. Total population (both sexes combined) by region, subregion and country, annually for 1950-2100 (thousands). Data is cleaned, normalized, "un-pivoted", and represented in nice machine readable way in CSV format. Dataset represented here has several resources:

Estimates from 1950 - 2015. Original
Medium fertility variant, 2015 - 2100
High fertility variant, 2015 - 2100
Low fertility variant, 2015 - 2100
Constant fertility variant, 2015 - 2100
Instant replacement fertility variant, 2015 - 2100
Momentum fertility variant, 2015 - 2100
Zero Migration variant, 2015 - 2100
Constant Mortality variant, 2015 - 2100

Preparation

You will need Python 3.6 or greater and dataflows library to run the script

To update the data run the process script locally:

# Install dataflows
pip install dataflows

# Run the script
python population_estimates.py
Several steps will be done to get the final data.

Licence

United Nations, Department of Economic and Social Affairs, Population Division (2017). World Population Prospects: The 2017 Revision, DVD Edition.