City Population Annual Timeseries (UN Statistics Division)

Part of these Data Solutions

Global Country & Region Reference Data Solution
Authoritative country codes, regions and location reference data to power your location-based solutions.
Explore →
Logistics Data Solution
Comprehensive reference for shipping codes, container standards and more.
Explore →

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-city/

├ .gitignore

https://datahub.io/core/population-city/_r/-/.gitignore

├ ATTRIBUTION.txt

https://datahub.io/core/population-city/_r/-/ATTRIBUTION.txt

├ README.md

https://datahub.io/core/population-city/_r/-/README.md

├ UPDATE_SCRIPT_MAINTENANCE_REPORT.md

https://datahub.io/core/population-city/_r/-/UPDATE_SCRIPT_MAINTENANCE_REPORT.md

├ data/unsd-citypopulation-year-both-footnotes.csv

https://datahub.io/core/population-city/_r/-/data/unsd-citypopulation-year-both-footnotes.csv

├ data/unsd-citypopulation-year-both.csv

https://datahub.io/core/population-city/_r/-/data/unsd-citypopulation-year-both.csv

├ data/unsd-citypopulation-year-fm-footnotes.csv

https://datahub.io/core/population-city/_r/-/data/unsd-citypopulation-year-fm-footnotes.csv

├ data/unsd-citypopulation-year-fm.csv

https://datahub.io/core/population-city/_r/-/data/unsd-citypopulation-year-fm.csv

└ datapackage.json

https://datahub.io/core/population-city/_r/-/datapackage.json

Key Files

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

datapackage.json— metadata & schema

https://datahub.io/core/population-city/_r/-/datapackage.json

README.md— documentation

https://datahub.io/core/population-city/_r/-/README.md

Typical Usage

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 AI

unsd-citypopulation-year-both

Field	Type	Description
Country or Area	string	Country or area, as named by the UN.
Year	integer	Reference year of the figure.
Area	string	Part of the city covered, for example Total.
Sex	string	Both Sexes in the first file; Female or Male in the second.
City	string	City name, as given by the UN (often in capitals).
City type	string	City proper or Urban agglomeration.
Record Type	string	Kind of record, for example Estimate - de jure or Census - de facto - complete tabulation.
Reliability	string	Reliability of the figure, for example Final figure, complete or Provisional figure.
Source Year	integer	Year of the source the figure was taken from.
Value	number	Population. A few figures have a decimal part.
Value Footnotes	string	Footnote numbers for this figure, separated by commas (for example 4,5); empty when there is none. The numbers are explained in the footnotes file that goes with the data file.

Download

Download CSV

About

City population for both sexes, one row per figure.
Last updated: 15 October 2026
Total rows: ...
Format: CSV
File size: 4.63 MB
Source: UN data: UNSD Demographic Statistics, City population by sex, city and city type (table 240)
License: Open Data Commons Public Domain Dedication and License v1.0. Applies only to the maintainers' own work (the update script, the column definitions and the file layout). It does not replace the UN data conditions of use; see README.md and ATTRIBUTION.txt.

unsd-citypopulation-year-both-footnotes

Field	Type	Description
footnoteSeqID	string	Footnote number, as used in the Value Footnotes column of the matching data file.
Footnote	string	Text of the footnote.

Download

Download CSV

About

Footnotes for the figures in unsd-citypopulation-year-both.csv.
Last updated: 15 October 2026
Total rows: ...
Format: CSV
File size: 28.9 kB
Source: UN data: UNSD Demographic Statistics, City population by sex, city and city type (table 240)
License: Open Data Commons Public Domain Dedication and License v1.0. Applies only to the maintainers' own work (the update script, the column definitions and the file layout). It does not replace the UN data conditions of use; see README.md and ATTRIBUTION.txt.

unsd-citypopulation-year-fm

Field	Type	Description
Country or Area	string	Country or area, as named by the UN.
Year	integer	Reference year of the figure.
Area	string	Part of the city covered, for example Total.
Sex	string	Both Sexes in the first file; Female or Male in the second.
City	string	City name, as given by the UN (often in capitals).
City type	string	City proper or Urban agglomeration.
Record Type	string	Kind of record, for example Estimate - de jure or Census - de facto - complete tabulation.
Reliability	string	Reliability of the figure, for example Final figure, complete or Provisional figure.
Source Year	integer	Year of the source the figure was taken from.
Value	number	Population. A few figures have a decimal part.
Value Footnotes	string	Footnote numbers for this figure, separated by commas (for example 4,5); empty when there is none. The numbers are explained in the footnotes file that goes with the data file.

Download

Download CSV

About

City population for females and males, one row per figure.
Last updated: 15 October 2026
Total rows: ...
Format: CSV
File size: 7.33 MB
Source: UN data: UNSD Demographic Statistics, City population by sex, city and city type (table 240)
License: Open Data Commons Public Domain Dedication and License v1.0. Applies only to the maintainers' own work (the update script, the column definitions and the file layout). It does not replace the UN data conditions of use; see README.md and ATTRIBUTION.txt.

unsd-citypopulation-year-fm-footnotes

Field	Type	Description
footnoteSeqID	string	Footnote number, as used in the Value Footnotes column of the matching data file.
Footnote	string	Text of the footnote.

Download

Download CSV

About

Footnotes for the figures in unsd-citypopulation-year-fm.csv.
Last updated: 15 October 2026
Total rows: ...
Format: CSV
File size: 27.5 kB
Source: UN data: UNSD Demographic Statistics, City population by sex, city and city type (table 240)
License: Open Data Commons Public Domain Dedication and License v1.0. Applies only to the maintainers' own work (the update script, the column definitions and the file layout). It does not replace the UN data conditions of use; see README.md and ATTRIBUTION.txt.

About this dataset

Update Script Maintenance Report

Date: 2026-03-04

Root cause: automation used broad triggers and had no explicit workflow write permissions.
Fixes made: narrowed workflow to schedule + manual dispatch, upgraded action versions, added permissions: contents: write, and preserved commit paths for generated files.
Validation: reviewed workflow run sequence and staged-file scope (data, datapackage.json, README.md).
Known blockers: none identified in this remediation pass.