World Happiness Report — Rankings & Factors

Official World Happiness Report rankings for every edition with published data (2012, 2015–2026): rank, score, and the six factor contributions (GDP per capita, social support, life expectancy, freedom, generosity, corruption). One row per country-year, clean JSON out.

---

Why use this scraper

• Official data. Downloads the World Happiness Report's own published Excel files — no scraping, no parsing HTML.
• All editions. 2012, 2015–2026. Scrape one edition or all of them.
• Full factor breakdown. Each row has the happiness score plus all six factor contributions: GDP per capita, social support, healthy life expectancy, freedom, generosity, and corruption perception.
• Historical data. Each edition contains multiple years of data (e.g. the 2026 edition has 2011–2025), so you get time-series for every country.
• No login, no API key. Reads the public Excel files directly.

---

Overview

The World Happiness Report is an annual publication that ranks countries by their happiness score, based on Gallup World Poll data. This actor downloads the official Excel files and outputs one row per country-year with the rank, score, and six factor contributions.

---

Use cases

• Academic research — analyze happiness trends across countries and years.
• Data journalism — visualize happiness rankings and factor breakdowns.
• Policy analysis — compare countries on GDP, social support, life expectancy, freedom, generosity, and corruption.
• Benchmarking — use happiness scores as a quality-of-life indicator in dashboards.

---

How it works

1. You provide edition years (e.g. 2026, 2025) or leave empty for all.
2. The actor downloads the official WHR Excel file for each edition.
3. It parses the Excel with the xlsx library.
4. Each country-year becomes one row in the dataset with rank, score, and all six factors.

---

Input

Field	Type	Default	Notes
editions	array	all	Edition years to scrape (e.g. 2026, 2025). Leave empty for all (2012, 2015–2026).
maxItems	integer	10000	Maximum country-year rows to output.
proxy	object	Apify proxy	Proxy configuration (not needed — files are public).

{
  "editions": ["2026", "2025"],
  "maxItems": 10000
}

---

Output

One row per country-year:

{
  "type": "happiness-ranking",
  "edition": "2026",
  "year": 2025,
  "rank": 1,
  "countryName": "Finland",
  "happinessScore": 7.764,
  "gdpPerCapita": 1.915,
  "socialSupport": 1.638,
  "healthyLifeExpectancy": 0.939,
  "freedom": 1.105,
  "generosity": 0.093,
  "corruption": 0.491,
  "dystopiaResidual": 2.583,
  "lowerWhisker": 7.69,
  "upperWhisker": 7.837
}

Key output fields

• edition — WHR edition year (e.g. 2026).
• year — the data year (editions contain multiple years).
• rank — happiness rank for that year.
• countryName — country name.
• happinessScore — happiness score (0–10 scale).
• gdpPerCapita / socialSupport / healthyLifeExpectancy / freedom / generosity / corruption — the six factor contributions to the score.
• dystopiaResidual — the residual (unexplained) component.

---

Available editions

2012, 2015, 2016, 2017, 2018, 2019, 2020, 2022, 2023, 2024, 2025, 2026

---

⚠️ Disclaimer

This Actor downloads publicly available Excel files from the World Happiness Report's official website. The data is © World Happiness Report and is used here under their published terms. You are responsible for using the output in line with their terms and any applicable law in your jurisdiction.

---

SEO Keywords

world happiness report, happiness rankings, happiness score, happiness data, whr data, country happiness, gdp per capita, social support, life expectancy, freedom index, generosity, corruption perception, happiness factors, happiness time series, country rankings, quality of life index, well-being data, gallup world poll