Global Demographic Transition Tracker

Demographic transition scoring and aging analytics from 4 international public data sources.

Overview

Analyzes population aging, fertility decline, and mortality transition across 195+ countries. Provides demographic transition stage scoring (0-100: youth-focused to aging-focused).

Data Sources

1. The World Bank (CC-BY 4.0)

   • Total Population (SP.POP.TOTL)
   • Fertility Rate (SP.DYN.TFRT.IN)
   • Population Ages 65+ (SP.POP.65UP.TO.ZS)
   • Life Expectancy (SP.DYN.LE00.IN)
   • Urban Population % (SP.URB.TOTL.IN.ZS)

2. Our World in Data (CC-BY 4.0)

   • Population time series (graceful skip if unavailable)

3. US CDC National Center for Health Statistics (Public Domain)

   • Life Expectancy (US only)

4. UNESCO UIS (CC-BY-SA 4.0 — Share-Alike required)

   • Primary Education Enrollment (Female %)

Input

Parameter	Type	Default	Description
countryCode	string	"JP"	ISO 3166-1 alpha-2 country code (e.g., JP, US, DE, NG)

Output

{
  "countryCode": "JP",
  "countryName": "Japan",
  "demographicTransitionScore": 85.3,
  "indicators": {
    "totalPopulation": 123456789,
    "fertilityRate": 1.2,
    "populationAges65Plus": 28.5,
    "lifeExpectancy": 84.6,
    "urbanPopulationPercent": 82.1,
    "primaryEnrollmentFemale": 101.2
  },
  "dataAvailability": {
    "worldBank": true,
    "owid": true,
    "cdc": false,
    "unesco": false
  },
  "successfulSourceCount": 2,
  "timestamp": "2024-04-08T12:34:56.789Z"
}

Demographic Transition Score

Scale: 0–100

• 0–20 = Stage 1–2 (High fertility, youth-focused). Example: Niger (NG)
• 20–40 = Stage 2–3 (Declining fertility, youth-focused). Example: Nigeria (NG)
• 40–60 = Stage 3 (Low fertility, transition). Example: Mexico (MX)
• 60–80 = Stage 4 (Very low fertility, aging). Example: South Korea (KR)
• 80–100 = Stage 4–5 (Lowest fertility, highest aging). Example: Japan (JP)

Pricing

• Event: demographic_query
• Price: $0.14 USD per query
• Charge: Only if ≥1 data source succeeds

Legal Disclaimer

NOT demographic policy, pension, healthcare, or investment advice. Historical data aggregation only.

Data Sources Attribution

• Data source: The World Bank (CC BY 4.0)
• Data source: Our World in Data (CC BY 4.0)
• Data source: US CDC National Center for Health Statistics
• Data source: UNESCO UIS (CC-BY-SA 4.0 — Share-Alike required)

Share-Alike Notice (UNESCO)

UNESCO UIS data requires derivative work licensing under CC-BY-SA 4.0. Any derivative publication must apply the same Share-Alike license.

Examples

Japan (aging)

$apify call --input='{"countryCode":"JP"}'

Nigeria (youth-focused)

$apify call --input='{"countryCode":"NG"}'

Notes

• World Bank data is most comprehensive; always fetches 5 demographic indicators
• OWID provides additional population verification (graceful skip if unavailable)
• CDC data is US-only
• UNESCO data is limited; graceful skip if unavailable
• All APIs implement exponential backoff retry (3 attempts, 1s–8s delay)
• Timeout: 20 seconds per request
• No data caching; real-time retrieval only

Version

1.0.0