Open data

Every table behind Macroscope. CSV files are UTF-8, comma-separated, with a decimal point and English column names. Machine-readable catalog: /data/catalog.json; a short description for AI assistants: /llms.txt.

Data as of 1 October 2026

For programs and AI agents

No need to scrape pages: the same data is served by an API and an MCP server. No key or sign-up; JSON or CSV responses with units and links to primary sources.

• REST API — /api/v1/: every operation with examples; machine-readable description — OpenAPI.
• MCP server — https://macroscope.reasonful.com/mcp: 11 tools — location search, country profile, time series, country rankings, forecasts vs actual, UN 2024 vs actual, key findings, sources and scenarios with the calculator's model.
• Connect: in Claude — Settings → Connectors → Add custom connector with this URL; in Claude Code — claude mcp add --transport http macroscope https://macroscope.reasonful.com/mcp; elsewhere — a remote MCP server (Streamable HTTP) without authorization.
• A short description of the site for AI assistants — /llms.txt.

Example requests

• /api/v1/locations?query=korea
• /api/v1/locations/KOR
• /api/v1/series?location=KOR,JPN&indicator=tfr&from_year=2000
• /api/v1/countries?sort_by=tfr_latest&limit=10&min_population_k=1000
• /api/v1/forecasts/jpn_births
• /api/v1/scenario?location=KOR&fertility=freeze

population · births · tfr · mean_age_childbearing · sex_ratio_at_birth · life_expectancy_male · life_expectancy_female · net_migration · median_age

Series by country and region

One file per country or region: /data/demography/series/<code>.csv, where the code is the country ISO3 (e.g. KOR) or un-<id> for UN regions (world: un-900). Columns: indicator, year, value, unit, kind, source.

Values of kind: estimate — UN estimate (1950–2023); projection_medium, projection_low, projection_lower95, projection_upper95 — UN projection variants (2024–2100); national_final, national_provisional, national_estimate — national statistics.

World and regions

Countries