---
type: "firecrawl-provider"
description: "Official WHR dashboard aggregate rankings, country-year indicators and edition appendix metadata; not Gallup respondent microdata."
use_when: "Official WHR dashboard aggregate rankings, country-year indicators and edition appendix metadata; not Gallup respondent microdata."
categories: "Public records"
capabilities: 4
credits_per_call: 5
---
# World Happiness Report on Firecrawl Alexandria

Official WHR dashboard aggregate rankings, country-year indicators and edition appendix metadata; not Gallup respondent microdata.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `worldhappiness-report`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/worldhappiness-report)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/openapi.json)

## Capabilities

- [Countries](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/countries): List the dashboard's geographies as ISO 3166-1 alpha-3 codes with display names (164 entries incl. XKX Kosovo, TWN Taiwan Province of China, HKG Hong Kong SAR of China). Use it to resolve names before calling rankings or panel.
- [Editions](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/editions): List every World Happiness Report edition (2012 onwards) with its appendix and data file downloads, the citation string and the licence note, read live from worldhappiness.report/data-sharing.
- [Panel](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/panel): Gallup World Poll country-year panel for up to 10 countries (ISO3) from the dashboard country view: annual life ladder, three-year average, GDP per capita, social support, healthy life expectancy, freedom, generosity, corruption, positive/negative affect, benevolence and inequality, 2005 onwards. Only the current vintage is served; edition, if given, must match it.
- [Rankings](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/rankings): One page of a World Happiness Report edition's ranking table (three-year average Cantril ladder score and rank) with the six explanatory-factor shares and raw factor levels from the dashboard country view. edition N reads dashboard data year N-1. Paginate with next_cursor; filter to ISO3 codes with countries.

## 1. Choose this provider when

Official WHR dashboard aggregate rankings, country-year indicators and edition appendix metadata; not Gallup respondent microdata.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "worldhappiness-report",
  "capability": "happiness/countries",
  "options": {}
}
```

## 3. Add provider options

Use only the options needed for the task:


## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "worldhappiness-report",
    capability: "happiness/countries",
    options: {},
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "worldhappiness-report",
  "capability": "happiness/countries",
  "options": {}
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "worldhappiness-report",
    "capability": "happiness/countries",
    "options": {}
  }
}'
```

### CLI

```sh
firecrawl scrape 'worldhappiness-report/happiness/countries' \
  --options '{}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "worldhappiness-report",
  "capability": "happiness/countries",
  "options": {}
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "worldhappiness-report",
  "capability": "happiness/countries",
  "options": {}
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "complete": true,
  "count": 164,
  "next_cursor": null,
  "observed_at_ms": 1789178518688,
  "records": [
    {
      "country": "Afghanistan",
      "iso3": "AFG",
      "source_url": "https://data.worldhappiness.report/country/AFG"
    },
    {
      "country": "Angola",
      "iso3": "AGO",
      "source_url": "https://data.worldhappiness.report/country/AGO"
    },
    {
      "country": "Albania",
      "iso3": "ALB",
      "source_url": "https://data.worldhappiness.report/country/ALB"
    },
    {
      "country": "United Arab Emirates",
      "iso3": "ARE",
      "source_url": "https://data.worldhappiness.report/country/ARE"
    },
    {
      "country": "Argentina",
      "iso3": "ARG",
      "source_url": "https://data.worldhappiness.report/country/ARG"
    },
    {
      "country": "Armenia",
      "iso3": "ARM",
      "source_url": "https://data.worldhappiness.report/country/ARM"
    },
    {
      "country": "Australia",
      "iso3": "AUS",
      "source_url": "https://data.worldhappiness.report/country/AUS"
    },
    {
      "country": "Austria",
      "iso3": "AUT",
      "source_url": "https://data.worldhappiness.report/country/AUT"
    },
    {
      "country": "Azerbaijan",
      "iso3": "AZE",
      "source_url": "https://data.worldhappiness.report/country/AZE"
    },
    {
      "country": "Burundi",
      "iso3": "BDI",
      "source_url": "https://data.worldhappiness.report/country/BDI"
    },
    {
      "country": "Belgium",
      "iso3": "BEL",
      "source_url": "https://data.worldhappiness.report/country/BEL"
    },
    {
      "country": "Benin",
      "iso3": "BEN",
      "source_url": "https://data.worldhappiness.report/country/BEN"
    },
    {
      "country": "Burkina Faso",
      "iso3": "BFA",
      "source_url": "https://data.worldhappiness.report/country/BFA"
    },
    {
      "country": "Bangladesh",
      "iso3": "BGD",
      "source_url": "https://data.worldhappiness.report/country/BGD"
    },
    {
      "country": "Bulgaria",
      "iso3": "BGR",
      "source_url": "https://data.worldhappiness.report/country/BGR"
    },
    {
      "country": "Bahrain",
      "iso3": "BHR",
      "source_url": "https://data.worldhappiness.report/country/BHR"
    },
    {
      "country": "Bosnia and Herzegovina",
      "iso3": "BIH",
      "source_url": "https://data.worldhappiness.report/country/BIH"
    },
    {
      "country": "Belarus",
      "iso3": "BLR",
      "source_url": "https://data.worldhappiness.report/country/BLR"
    },
    {
      "country": "Belize",
      "iso3": "BLZ",
      "source_url": "https://data.worldhappiness.report/country/BLZ"
    },
    {
      "country": "Bolivia",
      "iso3": "BOL",
      "source_url": "https://data.worldhappiness.report/country/BOL"
    },
    {
      "country": "Brazil",
      "iso3": "BRA",
      "source_url": "https://data.worldhappiness.report/country/BRA"
    },
    {
      "country": "Bhutan",
      "iso3": "BTN",
      "source_url": "https://data.worldhappiness.report/country/BTN"
    },
    {
      "country": "Botswana",
      "iso3": "BWA",
      "source_url": "https://data.worldhappiness.report/country/BWA"
    },
    {
      "country": "Central African Republic",
      "iso3": "CAF",
      "source_url": "https://data.worldhappiness.report/country/CAF"
    },
    {
      "country": "Canada",
      "iso3": "CAN",
      "source_url": "https://data.worldhappiness.report/country/CAN"
    },
    {
      "country": "Switzerland",
      "iso3": "CHE",
      "source_url": "https://data.worldhappiness.report/country/CHE"
    },
    {
      "country": "Chile",
      "iso3": "CHL",
      "source_url": "https://data.worldhappiness.report/country/CHL"
    },
    {
      "country": "China",
      "iso3": "CHN",
      "source_url": "https://data.worldhappiness.report/country/CHN"
    },
    {
      "country": "Côte d’Ivoire",
      "iso3": "CIV",
      "source_url": "https://data.worldhappiness.report/country/CIV"
    },
    {
      "country": "Cameroon",
      "iso3": "CMR",
      "source_url": "https://data.worldhappiness.report/country/CMR"
    },
    {
      "country": "DR Congo",
      "iso3": "COD",
      "source_url": "https://data.worldhappiness.report/country/COD"
    },
    {
      "country": "Congo",
      "iso3": "COG",
      "source_url": "https://data.worldhappiness.report/country/COG"
    },
    {
      "country": "Colombia",
      "iso3": "COL",
      "source_url": "https://data.worldhappiness.report/country/COL"
    },
    {
      "country": "Comoros",
      "iso3": "COM",
      "source_url": "https://data.worldhappiness.report/country/COM"
    },
    {
      "country": "Costa Rica",
      "iso3": "CRI",
      "source_url": "https://data.worldhappiness.report/country/CRI"
    },
    {
      "country": "Cuba",
      "iso3": "CUB",
      "source_url": "https://data.worldhappiness.report/country/CUB"
    },
    {
      "country": "Cyprus",
      "iso3": "CYP",
      "source_url": "https://data.worldhappiness.report/country/CYP"
    },
    {
      "country": "Czechia",
      "iso3": "CZE",
      "source_url": "https://data.worldhappiness.report/country/CZE"
    },
    {
      "country": "Germany",
      "iso3": "DEU",
      "source_url": "https://data.worldhappiness.report/country/DEU"
    },
    {
      "country": "Djibouti",
      "iso3": "DJI",
      "source_url": "https://data.worldhappiness.report/country/DJI"
    },
    {
      "country": "Denmark",
      "iso3": "DNK",
      "source_url": "https://data.worldhappiness.report/country/DNK"
    },
    {
      "country": "Dominican Republic",
      "iso3": "DOM",
      "source_url": "https://data.worldhappiness.report/country/DOM"
    },
    {
      "country": "Algeria",
      "iso3": "DZA",
      "source_url": "https://data.worldhappiness.report/country/DZA"
    },
    {
      "country": "Ecuador",
      "iso3": "ECU",
      "source_url": "https://data.worldhappiness.report/country/ECU"
    },
    {
      "country": "Egypt",
      "iso3": "EGY",
      "source_url": "https://data.worldhappiness.report/country/EGY"
    },
    {
      "country": "Spain",
      "iso3": "ESP",
      "source_url": "https://data.worldhappiness.report/country/ESP"
    },
    {
      "country": "Estonia",
      "iso3": "EST",
      "source_url": "https://data.worldhappiness.report/country/EST"
    },
    {
      "country": "Ethiopia",
      "iso3": "ETH",
      "source_url": "https://data.worldhappiness.report/country/ETH"
    },
    {
      "country": "Finland",
      "iso3": "FIN",
      "source_url": "https://data.worldhappiness.report/country/FIN"
    },
    {
      "country": "France",
      "iso3": "FRA",
      "source_url": "https://data.worldhappiness.report/country/FRA"
    },
    {
      "country": "Gabon",
      "iso3": "GAB",
      "source_url": "https://data.worldhappiness.report/country/GAB"
    },
    {
      "country": "United Kingdom",
      "iso3": "GBR",
      "source_url": "https://data.worldhappiness.report/country/GBR"
    },
    {
      "country": "Georgia",
      "iso3": "GEO",
      "source_url": "https://data.worldhappiness.report/country/GEO"
    },
    {
      "country": "Ghana",
      "iso3": "GHA",
      "source_url": "https://data.worldhappiness.report/country/GHA"
    },
    {
      "country": "Guinea",
      "iso3": "GIN",
      "source_url": "https://data.worldhappiness.report/country/GIN"
    },
    {
      "country": "Gambia",
      "iso3": "GMB",
      "source_url": "https://data.worldhappiness.report/country/GMB"
    },
    {
      "country": "Greece",
      "iso3": "GRC",
      "source_url": "https://data.worldhappiness.report/country/GRC"
    },
    {
      "country": "Guatemala",
      "iso3": "GTM",
      "source_url": "https://data.worldhappiness.report/country/GTM"
    },
    {
      "country": "Guyana",
      "iso3": "GUY",
      "source_url": "https://data.worldhappiness.report/country/GUY"
    },
    {
      "country": "Hong Kong SAR of China",
      "iso3": "HKG",
      "source_url": "https://data.worldhappiness.report/country/HKG"
    },
    {
      "country": "Honduras",
      "iso3": "HND",
      "source_url": "https://data.worldhappiness.report/country/HND"
    },
    {
      "country": "Croatia",
      "iso3": "HRV",
      "source_url": "https://data.worldhappiness.report/country/HRV"
    },
    {
      "country": "Haiti",
      "iso3": "HTI",
      "source_url": "https://data.worldhappiness.report/country/HTI"
    },
    {
      "country": "Hungary",
      "iso3": "HUN",
      "source_url": "https://data.worldhappiness.report/country/HUN"
    },
    {
      "country": "Indonesia",
      "iso3": "IDN",
      "source_url": "https://data.worldhappiness.report/country/IDN"
    },
    {
      "country": "India",
      "iso3": "IND",
      "source_url": "https://data.worldhappiness.report/country/IND"
    },
    {
      "country": "Ireland",
      "iso3": "IRL",
      "source_url": "https://data.worldhappiness.report/country/IRL"
    },
    {
      "country": "Iran",
      "iso3": "IRN",
      "source_url": "https://data.worldhappiness.report/country/IRN"
    },
    {
      "country": "Iraq",
      "iso3": "IRQ",
      "source_url": "https://data.worldhappiness.report/country/IRQ"
    },
    {
      "country": "Iceland",
      "iso3": "ISL",
      "source_url": "https://data.worldhappiness.report/country/ISL"
    },
    {
      "country": "Israel",
      "iso3": "ISR",
      "source_url": "https://data.worldhappiness.report/country/ISR"
    },
    {
      "country": "Italy",
      "iso3": "ITA",
      "source_url": "https://data.worldhappiness.report/country/ITA"
    },
    {
      "country": "Jamaica",
      "iso3": "JAM",
      "source_url": "https://data.worldhappiness.report/country/JAM"
    },
    {
      "country": "Jordan",
      "iso3": "JOR",
      "source_url": "https://data.worldhappiness.report/country/JOR"
    },
    {
      "country": "Japan",
      "iso3": "JPN",
      "source_url": "https://data.worldhappiness.report/country/JPN"
    },
    {
      "country": "Kazakhstan",
      "iso3": "KAZ",
      "source_url": "https://data.worldhappiness.report/country/KAZ"
    },
    {
      "country": "Kenya",
      "iso3": "KEN",
      "source_url": "https://data.worldhappiness.report/country/KEN"
    },
    {
      "country": "Kyrgyzstan",
      "iso3": "KGZ",
      "source_url": "https://data.worldhappiness.report/country/KGZ"
    },
    {
      "country": "Cambodia",
      "iso3": "KHM",
      "source_url": "https://data.worldhappiness.report/country/KHM"
    },
    {
      "country": "Republic of Korea",
      "iso3": "KOR",
      "source_url": "https://data.worldhappiness.report/country/KOR"
    },
    {
      "country": "Kuwait",
      "iso3": "KWT",
      "source_url": "https://data.worldhappiness.report/country/KWT"
    },
    {
      "country": "Lao PDR",
      "iso3": "LAO",
      "source_url": "https://data.worldhappiness.report/country/LAO"
    },
    {
      "country": "Lebanon",
      "iso3": "LBN",
      "source_url": "https://data.worldhappiness.report/country/LBN"
    },
    {
      "country": "Liberia",
      "iso3": "LBR",
      "source_url": "https://data.worldhappiness.report/country/LBR"
    },
    {
      "country": "Libya",
      "iso3": "LBY",
      "source_url": "https://data.worldhappiness.report/country/LBY"
    },
    {
      "country": "Sri Lanka",
      "iso3": "LKA",
      "source_url": "https://data.worldhappiness.report/country/LKA"
    },
    {
      "country": "Lesotho",
      "iso3": "LSO",
      "source_url": "https://data.worldhappiness.report/country/LSO"
    },
    {
      "country": "Lithuania",
      "iso3": "LTU",
      "source_url": "https://data.worldhappiness.report/country/LTU"
    },
    {
      "country": "Luxembourg",
      "iso3": "LUX",
      "source_url": "https://data.worldhappiness.report/country/LUX"
    },
    {
      "country": "Latvia",
      "iso3": "LVA",
      "source_url": "https://data.worldhappiness.report/country/LVA"
    },
    {
      "country": "Morocco",
      "iso3": "MAR",
      "source_url": "https://data.worldhappiness.report/country/MAR"
    },
    {
      "country": "Republic of Moldova",
      "iso3": "MDA",
      "source_url": "https://data.worldhappiness.report/country/MDA"
    },
    {
      "country": "Madagascar",
      "iso3": "MDG",
      "source_url": "https://data.worldhappiness.report/country/MDG"
    },
    {
      "country": "Maldives",
      "iso3": "MDV",
      "source_url": "https://data.worldhappiness.report/country/MDV"
    },
    {
      "country": "Mexico",
      "iso3": "MEX",
      "source_url": "https://data.worldhappiness.report/country/MEX"
    },
    {
      "country": "North Macedonia",
      "iso3": "MKD",
      "source_url": "https://data.worldhappiness.report/country/MKD"
    },
    {
      "country": "Mali",
      "iso3": "MLI",
      "source_url": "https://data.worldhappiness.report/country/MLI"
    },
    {
      "country": "Malta",
      "iso3": "MLT",
      "source_url": "https://data.worldhappiness.report/country/MLT"
    },
    {
      "country": "Myanmar",
      "iso3": "MMR",
      "source_url": "https://data.worldhappiness.report/country/MMR"
    },
    {
      "country": "Montenegro",
      "iso3": "MNE",
      "source_url": "https://data.worldhappiness.report/country/MNE"
    },
    {
      "country": "Mongolia",
      "iso3": "MNG",
      "source_url": "https://data.worldhappiness.report/country/MNG"
    },
    {
      "country": "Mozambique",
      "iso3": "MOZ",
      "source_url": "https://data.worldhappiness.report/country/MOZ"
    },
    {
      "country": "Mauritania",
      "iso3": "MRT",
      "source_url": "https://data.worldhappiness.report/country/MRT"
    },
    {
      "country": "Mauritius",
      "iso3": "MUS",
      "source_url": "https://data.worldhappiness.report/country/MUS"
    },
    {
      "country": "Malawi",
      "iso3": "MWI",
      "source_url": "https://data.worldhappiness.report/country/MWI"
    },
    {
      "country": "Malaysia",
      "iso3": "MYS",
      "source_url": "https://data.worldhappiness.report/country/MYS"
    },
    {
      "country": "Namibia",
      "iso3": "NAM",
      "source_url": "https://data.worldhappiness.report/country/NAM"
    },
    {
      "country": "Niger",
      "iso3": "NER",
      "source_url": "https://data.worldhappiness.report/country/NER"
    },
    {
      "country": "Nigeria",
      "iso3": "NGA",
      "source_url": "https://data.worldhappiness.report/country/NGA"
    },
    {
      "country": "Nicaragua",
      "iso3": "NIC",
      "source_url": "https://data.worldhappiness.report/country/NIC"
    },
    {
      "country": "Netherlands",
      "iso3": "NLD",
      "source_url": "https://data.worldhappiness.report/country/NLD"
    },
    {
      "country": "Norway",
      "iso3": "NOR",
      "source_url": "https://data.worldhappiness.report/country/NOR"
    },
    {
      "country": "Nepal",
      "iso3": "NPL",
      "source_url": "https://data.worldhappiness.report/country/NPL"
    },
    {
      "country": "New Zealand",
      "iso3": "NZL",
      "source_url": "https://data.worldhappiness.report/country/NZL"
    },
    {
      "country": "Oman",
      "iso3": "OMN",
      "source_url": "https://data.worldhappiness.report/country/OMN"
    },
    {
      "country": "Pakistan",
      "iso3": "PAK",
      "source_url": "https://data.worldhappiness.report/country/PAK"
    },
    {
      "country": "Panama",
      "iso3": "PAN",
      "source_url": "https://data.worldhappiness.report/country/PAN"
    },
    {
      "country": "Peru",
      "iso3": "PER",
      "source_url": "https://data.worldhappiness.report/country/PER"
    },
    {
      "country": "Philippines",
      "iso3": "PHL",
      "source_url": "https://data.worldhappiness.report/country/PHL"
    },
    {
      "country": "Poland",
      "iso3": "POL",
      "source_url": "https://data.worldhappiness.report/country/POL"
    },
    {
      "country": "Portugal",
      "iso3": "PRT",
      "source_url": "https://data.worldhappiness.report/country/PRT"
    },
    {
      "country": "Paraguay",
      "iso3": "PRY",
      "source_url": "https://data.worldhappiness.report/country/PRY"
    },
    {
      "country": "State of Palestine",
      "iso3": "PSE",
      "source_url": "https://data.worldhappiness.report/country/PSE"
    },
    {
      "country": "Qatar",
      "iso3": "QAT",
      "source_url": "https://data.worldhappiness.report/country/QAT"
    },
    {
      "country": "Romania",
      "iso3": "ROU",
      "source_url": "https://data.worldhappiness.report/country/ROU"
    },
    {
      "country": "Russian Federation",
      "iso3": "RUS",
      "source_url": "https://data.worldhappiness.report/country/RUS"
    },
    {
      "country": "Rwanda",
      "iso3": "RWA",
      "source_url": "https://data.worldhappiness.report/country/RWA"
    },
    {
      "country": "Saudi Arabia",
      "iso3": "SAU",
      "source_url": "https://data.worldhappiness.report/country/SAU"
    },
    {
      "country": "Sudan",
      "iso3": "SDN",
      "source_url": "https://data.worldhappiness.report/country/SDN"
    },
    {
      "country": "Senegal",
      "iso3": "SEN",
      "source_url": "https://data.worldhappiness.report/country/SEN"
    },
    {
      "country": "Singapore",
      "iso3": "SGP",
      "source_url": "https://data.worldhappiness.report/country/SGP"
    },
    {
      "country": "Sierra Leone",
      "iso3": "SLE",
      "source_url": "https://data.worldhappiness.report/country/SLE"
    },
    {
      "country": "El Salvador",
      "iso3": "SLV",
      "source_url": "https://data.worldhappiness.report/country/SLV"
    },
    {
      "country": "Somalia",
      "iso3": "SOM",
      "source_url": "https://data.worldhappiness.report/country/SOM"
    },
    {
      "country": "Serbia",
      "iso3": "SRB",
      "source_url": "https://data.worldhappiness.report/country/SRB"
    },
    {
      "country": "South Sudan",
      "iso3": "SSD",
      "source_url": "https://data.worldhappiness.report/country/SSD"
    },
    {
      "country": "Suriname",
      "iso3": "SUR",
      "source_url": "https://data.worldhappiness.report/country/SUR"
    },
    {
      "country": "Slovakia",
      "iso3": "SVK",
      "source_url": "https://data.worldhappiness.report/country/SVK"
    },
    {
      "country": "Slovenia",
      "iso3": "SVN",
      "source_url": "https://data.worldhappiness.report/country/SVN"
    },
    {
      "country": "Sweden",
      "iso3": "SWE",
      "source_url": "https://data.worldhappiness.report/country/SWE"
    },
    {
      "country": "Eswatini",
      "iso3": "SWZ",
      "source_url": "https://data.worldhappiness.report/country/SWZ"
    },
    {
      "country": "Syria",
      "iso3": "SYR",
      "source_url": "https://data.worldhappiness.report/country/SYR"
    },
    {
      "country": "Chad",
      "iso3": "TCD",
      "source_url": "https://data.worldhappiness.report/country/TCD"
    },
    {
      "country": "Togo",
      "iso3": "TGO",
      "source_url": "https://data.worldhappiness.report/country/TGO"
    },
    {
      "country": "Thailand",
      "iso3": "THA",
      "source_url": "https://data.worldhappiness.report/country/THA"
    },
    {
      "country": "Tajikistan",
      "iso3": "TJK",
      "source_url": "https://data.worldhappiness.report/country/TJK"
    },
    {
      "country": "Turkmenistan",
      "iso3": "TKM",
      "source_url": "https://data.worldhappiness.report/country/TKM"
    },
    {
      "country": "Trinidad and Tobago",
      "iso3": "TTO",
      "source_url": "https://data.worldhappiness.report/country/TTO"
    },
    {
      "country": "Tunisia",
      "iso3": "TUN",
      "source_url": "https://data.worldhappiness.report/country/TUN"
    },
    {
      "country": "Türkiye",
      "iso3": "TUR",
      "source_url": "https://data.worldhappiness.report/country/TUR"
    },
    {
      "country": "Taiwan Province of China",
      "iso3": "TWN",
      "source_url": "https://data.worldhappiness.report/country/TWN"
    },
    {
      "country": "Tanzania",
      "iso3": "TZA",
      "source_url": "https://data.worldhappiness.report/country/TZA"
    },
    {
      "country": "Uganda",
      "iso3": "UGA",
      "source_url": "https://data.worldhappiness.report/country/UGA"
    },
    {
      "country": "Ukraine",
      "iso3": "UKR",
      "source_url": "https://data.worldhappiness.report/country/UKR"
    },
    {
      "country": "Uruguay",
      "iso3": "URY",
      "source_url": "https://data.worldhappiness.report/country/URY"
    },
    {
      "country": "United States",
      "iso3": "USA",
      "source_url": "https://data.worldhappiness.report/country/USA"
    },
    {
      "country": "Uzbekistan",
      "iso3": "UZB",
      "source_url": "https://data.worldhappiness.report/country/UZB"
    },
    {
      "country": "Venezuela",
      "iso3": "VEN",
      "source_url": "https://data.worldhappiness.report/country/VEN"
    },
    {
      "country": "Viet Nam",
      "iso3": "VNM",
      "source_url": "https://data.worldhappiness.report/country/VNM"
    },
    {
      "country": "Kosovo",
      "iso3": "XKX",
      "source_url": "https://data.worldhappiness.report/country/XKX"
    },
    {
      "country": "Yemen",
      "iso3": "YEM",
      "source_url": "https://data.worldhappiness.report/country/YEM"
    },
    {
      "country": "South Africa",
      "iso3": "ZAF",
      "source_url": "https://data.worldhappiness.report/country/ZAF"
    },
    {
      "country": "Zambia",
      "iso3": "ZMB",
      "source_url": "https://data.worldhappiness.report/country/ZMB"
    },
    {
      "country": "Zimbabwe",
      "iso3": "ZWE",
      "source_url": "https://data.worldhappiness.report/country/ZWE"
    }
  ],
  "retrieved_at": "2026-09-12T02:01:58.688Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://data.worldhappiness.report",
  "warnings": []
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Countries

- Capability: `happiness/countries`
- Description: List the dashboard's geographies as ISO 3166-1 alpha-3 codes with display names (164 entries incl. XKX Kosovo, TWN Taiwan Province of China, HKG Hong Kong SAR of China). Use it to resolve names before calling rankings or panel.
- Instructions: List the dashboard's geographies as ISO 3166-1 alpha-3 codes with display names (164 entries incl. XKX Kosovo, TWN Taiwan Province of China, HKG Hong Kong SAR of China). Use it to resolve names before calling rankings or panel.
- Cost: 5 credits per call
- Capability file: [Countries](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/countries)

Accepted options:

Response schema example:
```json
{
  "complete": true,
  "count": 164,
  "next_cursor": null,
  "observed_at_ms": 1789178518688,
  "records": [
    {
      "country": "Afghanistan",
      "iso3": "AFG",
      "source_url": "https://data.worldhappiness.report/country/AFG"
    },
    {
      "country": "Angola",
      "iso3": "AGO",
      "source_url": "https://data.worldhappiness.report/country/AGO"
    },
    {
      "country": "Albania",
      "iso3": "ALB",
      "source_url": "https://data.worldhappiness.report/country/ALB"
    },
    {
      "country": "United Arab Emirates",
      "iso3": "ARE",
      "source_url": "https://data.worldhappiness.report/country/ARE"
    },
    {
      "country": "Argentina",
      "iso3": "ARG",
      "source_url": "https://data.worldhappiness.report/country/ARG"
    },
    {
      "country": "Armenia",
      "iso3": "ARM",
      "source_url": "https://data.worldhappiness.report/country/ARM"
    },
    {
      "country": "Australia",
      "iso3": "AUS",
      "source_url": "https://data.worldhappiness.report/country/AUS"
    },
    {
      "country": "Austria",
      "iso3": "AUT",
      "source_url": "https://data.worldhappiness.report/country/AUT"
    },
    {
      "country": "Azerbaijan",
      "iso3": "AZE",
      "source_url": "https://data.worldhappiness.report/country/AZE"
    },
    {
      "country": "Burundi",
      "iso3": "BDI",
      "source_url": "https://data.worldhappiness.report/country/BDI"
    },
    {
      "country": "Belgium",
      "iso3": "BEL",
      "source_url": "https://data.worldhappiness.report/country/BEL"
    },
    {
      "country": "Benin",
      "iso3": "BEN",
      "source_url": "https://data.worldhappiness.report/country/BEN"
    },
    {
      "country": "Burkina Faso",
      "iso3": "BFA",
      "source_url": "https://data.worldhappiness.report/country/BFA"
    },
    {
      "country": "Bangladesh",
      "iso3": "BGD",
      "source_url": "https://data.worldhappiness.report/country/BGD"
    },
    {
      "country": "Bulgaria",
      "iso3": "BGR",
      "source_url": "https://data.worldhappiness.report/country/BGR"
    },
    {
      "country": "Bahrain",
      "iso3": "BHR",
      "source_url": "https://data.worldhappiness.report/country/BHR"
    },
    {
      "country": "Bosnia and Herzegovina",
      "iso3": "BIH",
      "source_url": "https://data.worldhappiness.report/country/BIH"
    },
    {
      "country": "Belarus",
      "iso3": "BLR",
      "source_url": "https://data.worldhappiness.report/country/BLR"
    },
    {
      "country": "Belize",
      "iso3": "BLZ",
      "source_url": "https://data.worldhappiness.report/country/BLZ"
    },
    {
      "country": "Bolivia",
      "iso3": "BOL",
      "source_url": "https://data.worldhappiness.report/country/BOL"
    },
    {
      "country": "Brazil",
      "iso3": "BRA",
      "source_url": "https://data.worldhappiness.report/country/BRA"
    },
    {
      "country": "Bhutan",
      "iso3": "BTN",
      "source_url": "https://data.worldhappiness.report/country/BTN"
    },
    {
      "country": "Botswana",
      "iso3": "BWA",
      "source_url": "https://data.worldhappiness.report/country/BWA"
    },
    {
      "country": "Central African Republic",
      "iso3": "CAF",
      "source_url": "https://data.worldhappiness.report/country/CAF"
    },
    {
      "country": "Canada",
      "iso3": "CAN",
      "source_url": "https://data.worldhappiness.report/country/CAN"
    },
    {
      "country": "Switzerland",
      "iso3": "CHE",
      "source_url": "https://data.worldhappiness.report/country/CHE"
    },
    {
      "country": "Chile",
      "iso3": "CHL",
      "source_url": "https://data.worldhappiness.report/country/CHL"
    },
    {
      "country": "China",
      "iso3": "CHN",
      "source_url": "https://data.worldhappiness.report/country/CHN"
    },
    {
      "country": "Côte d’Ivoire",
      "iso3": "CIV",
      "source_url": "https://data.worldhappiness.report/country/CIV"
    },
    {
      "country": "Cameroon",
      "iso3": "CMR",
      "source_url": "https://data.worldhappiness.report/country/CMR"
    },
    {
      "country": "DR Congo",
      "iso3": "COD",
      "source_url": "https://data.worldhappiness.report/country/COD"
    },
    {
      "country": "Congo",
      "iso3": "COG",
      "source_url": "https://data.worldhappiness.report/country/COG"
    },
    {
      "country": "Colombia",
      "iso3": "COL",
      "source_url": "https://data.worldhappiness.report/country/COL"
    },
    {
      "country": "Comoros",
      "iso3": "COM",
      "source_url": "https://data.worldhappiness.report/country/COM"
    },
    {
      "country": "Costa Rica",
      "iso3": "CRI",
      "source_url": "https://data.worldhappiness.report/country/CRI"
    },
    {
      "country": "Cuba",
      "iso3": "CUB",
      "source_url": "https://data.worldhappiness.report/country/CUB"
    },
    {
      "country": "Cyprus",
      "iso3": "CYP",
      "source_url": "https://data.worldhappiness.report/country/CYP"
    },
    {
      "country": "Czechia",
      "iso3": "CZE",
      "source_url": "https://data.worldhappiness.report/country/CZE"
    },
    {
      "country": "Germany",
      "iso3": "DEU",
      "source_url": "https://data.worldhappiness.report/country/DEU"
    },
    {
      "country": "Djibouti",
      "iso3": "DJI",
      "source_url": "https://data.worldhappiness.report/country/DJI"
    },
    {
      "country": "Denmark",
      "iso3": "DNK",
      "source_url": "https://data.worldhappiness.report/country/DNK"
    },
    {
      "country": "Dominican Republic",
      "iso3": "DOM",
      "source_url": "https://data.worldhappiness.report/country/DOM"
    },
    {
      "country": "Algeria",
      "iso3": "DZA",
      "source_url": "https://data.worldhappiness.report/country/DZA"
    },
    {
      "country": "Ecuador",
      "iso3": "ECU",
      "source_url": "https://data.worldhappiness.report/country/ECU"
    },
    {
      "country": "Egypt",
      "iso3": "EGY",
      "source_url": "https://data.worldhappiness.report/country/EGY"
    },
    {
      "country": "Spain",
      "iso3": "ESP",
      "source_url": "https://data.worldhappiness.report/country/ESP"
    },
    {
      "country": "Estonia",
      "iso3": "EST",
      "source_url": "https://data.worldhappiness.report/country/EST"
    },
    {
      "country": "Ethiopia",
      "iso3": "ETH",
      "source_url": "https://data.worldhappiness.report/country/ETH"
    },
    {
      "country": "Finland",
      "iso3": "FIN",
      "source_url": "https://data.worldhappiness.report/country/FIN"
    },
    {
      "country": "France",
      "iso3": "FRA",
      "source_url": "https://data.worldhappiness.report/country/FRA"
    },
    {
      "country": "Gabon",
      "iso3": "GAB",
      "source_url": "https://data.worldhappiness.report/country/GAB"
    },
    {
      "country": "United Kingdom",
      "iso3": "GBR",
      "source_url": "https://data.worldhappiness.report/country/GBR"
    },
    {
      "country": "Georgia",
      "iso3": "GEO",
      "source_url": "https://data.worldhappiness.report/country/GEO"
    },
    {
      "country": "Ghana",
      "iso3": "GHA",
      "source_url": "https://data.worldhappiness.report/country/GHA"
    },
    {
      "country": "Guinea",
      "iso3": "GIN",
      "source_url": "https://data.worldhappiness.report/country/GIN"
    },
    {
      "country": "Gambia",
      "iso3": "GMB",
      "source_url": "https://data.worldhappiness.report/country/GMB"
    },
    {
      "country": "Greece",
      "iso3": "GRC",
      "source_url": "https://data.worldhappiness.report/country/GRC"
    },
    {
      "country": "Guatemala",
      "iso3": "GTM",
      "source_url": "https://data.worldhappiness.report/country/GTM"
    },
    {
      "country": "Guyana",
      "iso3": "GUY",
      "source_url": "https://data.worldhappiness.report/country/GUY"
    },
    {
      "country": "Hong Kong SAR of China",
      "iso3": "HKG",
      "source_url": "https://data.worldhappiness.report/country/HKG"
    },
    {
      "country": "Honduras",
      "iso3": "HND",
      "source_url": "https://data.worldhappiness.report/country/HND"
    },
    {
      "country": "Croatia",
      "iso3": "HRV",
      "source_url": "https://data.worldhappiness.report/country/HRV"
    },
    {
      "country": "Haiti",
      "iso3": "HTI",
      "source_url": "https://data.worldhappiness.report/country/HTI"
    },
    {
      "country": "Hungary",
      "iso3": "HUN",
      "source_url": "https://data.worldhappiness.report/country/HUN"
    },
    {
      "country": "Indonesia",
      "iso3": "IDN",
      "source_url": "https://data.worldhappiness.report/country/IDN"
    },
    {
      "country": "India",
      "iso3": "IND",
      "source_url": "https://data.worldhappiness.report/country/IND"
    },
    {
      "country": "Ireland",
      "iso3": "IRL",
      "source_url": "https://data.worldhappiness.report/country/IRL"
    },
    {
      "country": "Iran",
      "iso3": "IRN",
      "source_url": "https://data.worldhappiness.report/country/IRN"
    },
    {
      "country": "Iraq",
      "iso3": "IRQ",
      "source_url": "https://data.worldhappiness.report/country/IRQ"
    },
    {
      "country": "Iceland",
      "iso3": "ISL",
      "source_url": "https://data.worldhappiness.report/country/ISL"
    },
    {
      "country": "Israel",
      "iso3": "ISR",
      "source_url": "https://data.worldhappiness.report/country/ISR"
    },
    {
      "country": "Italy",
      "iso3": "ITA",
      "source_url": "https://data.worldhappiness.report/country/ITA"
    },
    {
      "country": "Jamaica",
      "iso3": "JAM",
      "source_url": "https://data.worldhappiness.report/country/JAM"
    },
    {
      "country": "Jordan",
      "iso3": "JOR",
      "source_url": "https://data.worldhappiness.report/country/JOR"
    },
    {
      "country": "Japan",
      "iso3": "JPN",
      "source_url": "https://data.worldhappiness.report/country/JPN"
    },
    {
      "country": "Kazakhstan",
      "iso3": "KAZ",
      "source_url": "https://data.worldhappiness.report/country/KAZ"
    },
    {
      "country": "Kenya",
      "iso3": "KEN",
      "source_url": "https://data.worldhappiness.report/country/KEN"
    },
    {
      "country": "Kyrgyzstan",
      "iso3": "KGZ",
      "source_url": "https://data.worldhappiness.report/country/KGZ"
    },
    {
      "country": "Cambodia",
      "iso3": "KHM",
      "source_url": "https://data.worldhappiness.report/country/KHM"
    },
    {
      "country": "Republic of Korea",
      "iso3": "KOR",
      "source_url": "https://data.worldhappiness.report/country/KOR"
    },
    {
      "country": "Kuwait",
      "iso3": "KWT",
      "source_url": "https://data.worldhappiness.report/country/KWT"
    },
    {
      "country": "Lao PDR",
      "iso3": "LAO",
      "source_url": "https://data.worldhappiness.report/country/LAO"
    },
    {
      "country": "Lebanon",
      "iso3": "LBN",
      "source_url": "https://data.worldhappiness.report/country/LBN"
    },
    {
      "country": "Liberia",
      "iso3": "LBR",
      "source_url": "https://data.worldhappiness.report/country/LBR"
    },
    {
      "country": "Libya",
      "iso3": "LBY",
      "source_url": "https://data.worldhappiness.report/country/LBY"
    },
    {
      "country": "Sri Lanka",
      "iso3": "LKA",
      "source_url": "https://data.worldhappiness.report/country/LKA"
    },
    {
      "country": "Lesotho",
      "iso3": "LSO",
      "source_url": "https://data.worldhappiness.report/country/LSO"
    },
    {
      "country": "Lithuania",
      "iso3": "LTU",
      "source_url": "https://data.worldhappiness.report/country/LTU"
    },
    {
      "country": "Luxembourg",
      "iso3": "LUX",
      "source_url": "https://data.worldhappiness.report/country/LUX"
    },
    {
      "country": "Latvia",
      "iso3": "LVA",
      "source_url": "https://data.worldhappiness.report/country/LVA"
    },
    {
      "country": "Morocco",
      "iso3": "MAR",
      "source_url": "https://data.worldhappiness.report/country/MAR"
    },
    {
      "country": "Republic of Moldova",
      "iso3": "MDA",
      "source_url": "https://data.worldhappiness.report/country/MDA"
    },
    {
      "country": "Madagascar",
      "iso3": "MDG",
      "source_url": "https://data.worldhappiness.report/country/MDG"
    },
    {
      "country": "Maldives",
      "iso3": "MDV",
      "source_url": "https://data.worldhappiness.report/country/MDV"
    },
    {
      "country": "Mexico",
      "iso3": "MEX",
      "source_url": "https://data.worldhappiness.report/country/MEX"
    },
    {
      "country": "North Macedonia",
      "iso3": "MKD",
      "source_url": "https://data.worldhappiness.report/country/MKD"
    },
    {
      "country": "Mali",
      "iso3": "MLI",
      "source_url": "https://data.worldhappiness.report/country/MLI"
    },
    {
      "country": "Malta",
      "iso3": "MLT",
      "source_url": "https://data.worldhappiness.report/country/MLT"
    },
    {
      "country": "Myanmar",
      "iso3": "MMR",
      "source_url": "https://data.worldhappiness.report/country/MMR"
    },
    {
      "country": "Montenegro",
      "iso3": "MNE",
      "source_url": "https://data.worldhappiness.report/country/MNE"
    },
    {
      "country": "Mongolia",
      "iso3": "MNG",
      "source_url": "https://data.worldhappiness.report/country/MNG"
    },
    {
      "country": "Mozambique",
      "iso3": "MOZ",
      "source_url": "https://data.worldhappiness.report/country/MOZ"
    },
    {
      "country": "Mauritania",
      "iso3": "MRT",
      "source_url": "https://data.worldhappiness.report/country/MRT"
    },
    {
      "country": "Mauritius",
      "iso3": "MUS",
      "source_url": "https://data.worldhappiness.report/country/MUS"
    },
    {
      "country": "Malawi",
      "iso3": "MWI",
      "source_url": "https://data.worldhappiness.report/country/MWI"
    },
    {
      "country": "Malaysia",
      "iso3": "MYS",
      "source_url": "https://data.worldhappiness.report/country/MYS"
    },
    {
      "country": "Namibia",
      "iso3": "NAM",
      "source_url": "https://data.worldhappiness.report/country/NAM"
    },
    {
      "country": "Niger",
      "iso3": "NER",
      "source_url": "https://data.worldhappiness.report/country/NER"
    },
    {
      "country": "Nigeria",
      "iso3": "NGA",
      "source_url": "https://data.worldhappiness.report/country/NGA"
    },
    {
      "country": "Nicaragua",
      "iso3": "NIC",
      "source_url": "https://data.worldhappiness.report/country/NIC"
    },
    {
      "country": "Netherlands",
      "iso3": "NLD",
      "source_url": "https://data.worldhappiness.report/country/NLD"
    },
    {
      "country": "Norway",
      "iso3": "NOR",
      "source_url": "https://data.worldhappiness.report/country/NOR"
    },
    {
      "country": "Nepal",
      "iso3": "NPL",
      "source_url": "https://data.worldhappiness.report/country/NPL"
    },
    {
      "country": "New Zealand",
      "iso3": "NZL",
      "source_url": "https://data.worldhappiness.report/country/NZL"
    },
    {
      "country": "Oman",
      "iso3": "OMN",
      "source_url": "https://data.worldhappiness.report/country/OMN"
    },
    {
      "country": "Pakistan",
      "iso3": "PAK",
      "source_url": "https://data.worldhappiness.report/country/PAK"
    },
    {
      "country": "Panama",
      "iso3": "PAN",
      "source_url": "https://data.worldhappiness.report/country/PAN"
    },
    {
      "country": "Peru",
      "iso3": "PER",
      "source_url": "https://data.worldhappiness.report/country/PER"
    },
    {
      "country": "Philippines",
      "iso3": "PHL",
      "source_url": "https://data.worldhappiness.report/country/PHL"
    },
    {
      "country": "Poland",
      "iso3": "POL",
      "source_url": "https://data.worldhappiness.report/country/POL"
    },
    {
      "country": "Portugal",
      "iso3": "PRT",
      "source_url": "https://data.worldhappiness.report/country/PRT"
    },
    {
      "country": "Paraguay",
      "iso3": "PRY",
      "source_url": "https://data.worldhappiness.report/country/PRY"
    },
    {
      "country": "State of Palestine",
      "iso3": "PSE",
      "source_url": "https://data.worldhappiness.report/country/PSE"
    },
    {
      "country": "Qatar",
      "iso3": "QAT",
      "source_url": "https://data.worldhappiness.report/country/QAT"
    },
    {
      "country": "Romania",
      "iso3": "ROU",
      "source_url": "https://data.worldhappiness.report/country/ROU"
    },
    {
      "country": "Russian Federation",
      "iso3": "RUS",
      "source_url": "https://data.worldhappiness.report/country/RUS"
    },
    {
      "country": "Rwanda",
      "iso3": "RWA",
      "source_url": "https://data.worldhappiness.report/country/RWA"
    },
    {
      "country": "Saudi Arabia",
      "iso3": "SAU",
      "source_url": "https://data.worldhappiness.report/country/SAU"
    },
    {
      "country": "Sudan",
      "iso3": "SDN",
      "source_url": "https://data.worldhappiness.report/country/SDN"
    },
    {
      "country": "Senegal",
      "iso3": "SEN",
      "source_url": "https://data.worldhappiness.report/country/SEN"
    },
    {
      "country": "Singapore",
      "iso3": "SGP",
      "source_url": "https://data.worldhappiness.report/country/SGP"
    },
    {
      "country": "Sierra Leone",
      "iso3": "SLE",
      "source_url": "https://data.worldhappiness.report/country/SLE"
    },
    {
      "country": "El Salvador",
      "iso3": "SLV",
      "source_url": "https://data.worldhappiness.report/country/SLV"
    },
    {
      "country": "Somalia",
      "iso3": "SOM",
      "source_url": "https://data.worldhappiness.report/country/SOM"
    },
    {
      "country": "Serbia",
      "iso3": "SRB",
      "source_url": "https://data.worldhappiness.report/country/SRB"
    },
    {
      "country": "South Sudan",
      "iso3": "SSD",
      "source_url": "https://data.worldhappiness.report/country/SSD"
    },
    {
      "country": "Suriname",
      "iso3": "SUR",
      "source_url": "https://data.worldhappiness.report/country/SUR"
    },
    {
      "country": "Slovakia",
      "iso3": "SVK",
      "source_url": "https://data.worldhappiness.report/country/SVK"
    },
    {
      "country": "Slovenia",
      "iso3": "SVN",
      "source_url": "https://data.worldhappiness.report/country/SVN"
    },
    {
      "country": "Sweden",
      "iso3": "SWE",
      "source_url": "https://data.worldhappiness.report/country/SWE"
    },
    {
      "country": "Eswatini",
      "iso3": "SWZ",
      "source_url": "https://data.worldhappiness.report/country/SWZ"
    },
    {
      "country": "Syria",
      "iso3": "SYR",
      "source_url": "https://data.worldhappiness.report/country/SYR"
    },
    {
      "country": "Chad",
      "iso3": "TCD",
      "source_url": "https://data.worldhappiness.report/country/TCD"
    },
    {
      "country": "Togo",
      "iso3": "TGO",
      "source_url": "https://data.worldhappiness.report/country/TGO"
    },
    {
      "country": "Thailand",
      "iso3": "THA",
      "source_url": "https://data.worldhappiness.report/country/THA"
    },
    {
      "country": "Tajikistan",
      "iso3": "TJK",
      "source_url": "https://data.worldhappiness.report/country/TJK"
    },
    {
      "country": "Turkmenistan",
      "iso3": "TKM",
      "source_url": "https://data.worldhappiness.report/country/TKM"
    },
    {
      "country": "Trinidad and Tobago",
      "iso3": "TTO",
      "source_url": "https://data.worldhappiness.report/country/TTO"
    },
    {
      "country": "Tunisia",
      "iso3": "TUN",
      "source_url": "https://data.worldhappiness.report/country/TUN"
    },
    {
      "country": "Türkiye",
      "iso3": "TUR",
      "source_url": "https://data.worldhappiness.report/country/TUR"
    },
    {
      "country": "Taiwan Province of China",
      "iso3": "TWN",
      "source_url": "https://data.worldhappiness.report/country/TWN"
    },
    {
      "country": "Tanzania",
      "iso3": "TZA",
      "source_url": "https://data.worldhappiness.report/country/TZA"
    },
    {
      "country": "Uganda",
      "iso3": "UGA",
      "source_url": "https://data.worldhappiness.report/country/UGA"
    },
    {
      "country": "Ukraine",
      "iso3": "UKR",
      "source_url": "https://data.worldhappiness.report/country/UKR"
    },
    {
      "country": "Uruguay",
      "iso3": "URY",
      "source_url": "https://data.worldhappiness.report/country/URY"
    },
    {
      "country": "United States",
      "iso3": "USA",
      "source_url": "https://data.worldhappiness.report/country/USA"
    },
    {
      "country": "Uzbekistan",
      "iso3": "UZB",
      "source_url": "https://data.worldhappiness.report/country/UZB"
    },
    {
      "country": "Venezuela",
      "iso3": "VEN",
      "source_url": "https://data.worldhappiness.report/country/VEN"
    },
    {
      "country": "Viet Nam",
      "iso3": "VNM",
      "source_url": "https://data.worldhappiness.report/country/VNM"
    },
    {
      "country": "Kosovo",
      "iso3": "XKX",
      "source_url": "https://data.worldhappiness.report/country/XKX"
    },
    {
      "country": "Yemen",
      "iso3": "YEM",
      "source_url": "https://data.worldhappiness.report/country/YEM"
    },
    {
      "country": "South Africa",
      "iso3": "ZAF",
      "source_url": "https://data.worldhappiness.report/country/ZAF"
    },
    {
      "country": "Zambia",
      "iso3": "ZMB",
      "source_url": "https://data.worldhappiness.report/country/ZMB"
    },
    {
      "country": "Zimbabwe",
      "iso3": "ZWE",
      "source_url": "https://data.worldhappiness.report/country/ZWE"
    }
  ],
  "retrieved_at": "2026-09-12T02:01:58.688Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://data.worldhappiness.report",
  "warnings": []
}
```

### Editions

- Capability: `happiness/editions`
- Description: List every World Happiness Report edition (2012 onwards) with its appendix and data file downloads, the citation string and the licence note, read live from worldhappiness.report/data-sharing.
- Instructions: List every World Happiness Report edition (2012 onwards) with its appendix and data file downloads, the citation string and the licence note, read live from worldhappiness.report/data-sharing.
- Cost: 5 credits per call
- Capability file: [Editions](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/editions)

Accepted options:

Response schema example:
```json
{
  "complete": true,
  "count": 14,
  "next_cursor": null,
  "observed_at_ms": 1789178518688,
  "records": [
    {
      "appendix_files": [
        {
          "name": "Statement of Competing Interests",
          "title": "Download Statement of Competing Interests",
          "url": "https://files.worldhappiness.report/WHR26_Statement_of_Competing_Interests.pdf"
        },
        {
          "name": "Data for Figure 2.1",
          "title": "Download Data for Figure 2.1",
          "url": "https://files.worldhappiness.report/WHR26_Data_Figure_2.1.xlsx"
        },
        {
          "name": "Chapter 2 Statistical Appendix",
          "title": "Download Chapter 2 Statistical Appendix",
          "url": "https://files.worldhappiness.report/WHR26_Statistical_Appendix.pdf"
        },
        {
          "name": "Chapter 3 Appendix",
          "title": "Download Chapter 3 Appendix",
          "url": "https://files.worldhappiness.report/WHR26_Ch03_Appendix_v2.pdf"
        },
        {
          "name": "Chapter 4 Appendix",
          "title": "Download Chapter 4 Appendix",
          "url": "https://files.worldhappiness.report/WHR26_Ch04_Appendix.pdf"
        },
        {
          "name": "Chapter 7 Appendix",
          "title": "Download Chapter 7 Appendix",
          "url": "https://files.worldhappiness.report/WHR26_Ch07_Appendix.pdf"
        },
        {
          "name": "Chapter 8 Appendix",
          "title": "Download Chapter 8 Appendix",
          "url": "https://files.worldhappiness.report/WHR26_Ch08_Appendix.pdf"
        },
        {
          "name": "Chapter 9 Appendix",
          "title": "Download Chapter 9 Appendix",
          "url": "https://files.worldhappiness.report/WHR26_Ch09_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, J. F., Layard, R., Sachs, J. D., De Neve, J.-E., Aknin, L. B., & Wang, S. (Eds.). (2026). World Happiness Report 2026. University of Oxford: Wellbeing Research Centre.",
      "edition_year": 2026,
      "id": "whr:2026",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2026/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Data for Figure 2.1",
          "title": "Download Data for Figure 2.1",
          "url": "https://files.worldhappiness.report/WHR25_Data_Figure_2.1v3.xlsx"
        },
        {
          "name": "Chapter 2 ODA Appendix",
          "title": "Download Chapter 2 ODA Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch02_Appendix_C.pdf"
        },
        {
          "name": "Chapter 2 Statistical Appendix",
          "title": "Download Chapter 2 Statistical Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch02_Appendix_B.pdf"
        },
        {
          "name": "Chapter 2 Wallet Appendix",
          "title": "Download Chapter 2 Wallet Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch02_Appendix_D.pdf"
        },
        {
          "name": "Chapter 3 Appendix",
          "title": "Download Chapter 3 Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch03_Appendix.pdf"
        },
        {
          "name": "Chapter 4 Appendix",
          "title": "Download Chapter 4 Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch04_Appendix.pdf"
        },
        {
          "name": "Chapter 6 Appendix",
          "title": "Download Chapter 6 Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch06_Appendix.pdf"
        },
        {
          "name": "Chapter 7 Appendix",
          "title": "Download Chapter 7 Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch07_Appendix.pdf"
        },
        {
          "name": "Chapter 8 Appendix",
          "title": "Download Chapter 8 Appendix",
          "url": "https://files.worldhappiness.report/WHR25_Ch08_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, J. F., Layard, R., Sachs, J. D., De Neve, J.-E., Aknin, L. B., & Wang, S. (Eds.). (2025). World Happiness Report 2025. University of Oxford: Wellbeing Research Centre.",
      "edition_year": 2025,
      "id": "whr:2025",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2025/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Statistical Appendix 1 for Chapter 2",
          "title": "Download Statistical Appendix 1 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR24_Statistical_Appendix.pdf"
        },
        {
          "name": "Data for Figure 2.1",
          "title": "Download Data for Figure 2.1",
          "url": "https://files.worldhappiness.report/WHR24_Data_Figure_2.1.xls"
        },
        {
          "name": "Chapter 3 Appendix",
          "title": "Download Chapter 3 Appendix",
          "url": "https://files.worldhappiness.report/WHR24_Ch03_Appendix.pdf"
        },
        {
          "name": "Chapter 5 Appendix",
          "title": "Download Chapter 5 Appendix",
          "url": "https://files.worldhappiness.report/WHR24_Ch05_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, J. F., Layard, R., Sachs, J. D., De Neve, J.-E., Aknin, L. B., & Wang, S. (Eds.). (2024). World Happiness Report 2024. University of Oxford: Wellbeing Research Centre.",
      "edition_year": 2024,
      "id": "whr:2024",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2024/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Statistical Appendix 1 for Chapter 2",
          "title": "Download Statistical Appendix 1 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR23_Statistical_Appendix.pdf"
        },
        {
          "name": "Data for Figure 2.1",
          "title": "Download Data for Figure 2.1",
          "url": "https://files.worldhappiness.report/WHR23_Data_Figure_2.1.xls"
        },
        {
          "name": "Supplemntary Material for Chapter 5: Towards Well-Being Measurement with Social Media Across Space, Time and Cultures: Three Generations of Progress",
          "title": "Download Supplemntary Material for Chapter 5: Towards Well-Being Measurement with Social Media Across Space, Time and Cultures: Three Generations of Progress",
          "url": "https://files.worldhappiness.report/WHR23_Ch05_Supplement.pdf"
        }
      ],
      "citation": "Helliwell, J. F., Layard, R., Sachs, J. D., Aknin, L. B., De Neve, J.-E., & Wang, S. (Eds.). (2023). World Happiness Report 2023 (11th ed.). Sustainable Development Solutions Network.",
      "edition_year": 2023,
      "id": "whr:2023",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2023/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Statistical Appendix 1 for Chapter 2",
          "title": "Download Statistical Appendix 1 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR22_Statistical_Appendix.pdf"
        },
        {
          "name": "Data for Figure 2.1",
          "title": "Download Data for Figure 2.1",
          "url": "https://files.worldhappiness.report/WHR22_Data_Figure_2.1.xls"
        },
        {
          "name": "Chapter 3 Appendix",
          "title": "Download Chapter 3 Appendix",
          "url": "https://files.worldhappiness.report/WHR22_Ch03_Appendix.pdf"
        },
        {
          "name": "Chapter 6 Appendix",
          "title": "Download Chapter 6 Appendix",
          "url": "https://files.worldhappiness.report/WHR22_Ch06_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, J. F., Layard, R., Sachs, J. D., De Neve, J.-E., Aknin, L. B., & Wang, S. (Eds.). (2022). World Happiness Report 2022. New York: Sustainable Development Solutions Network.",
      "edition_year": 2022,
      "id": "whr:2022",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2022/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Statistical Appendix 1 for Chapter 2",
          "title": "Download Statistical Appendix 1 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR21_Statistical_Appendix_01.pdf"
        },
        {
          "name": "Statistical Appendix 2 for Chapter 2",
          "title": "Download Statistical Appendix 2 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR21_Statistical_Appendix_02.pdf"
        },
        {
          "name": "Data for Figure 2.1",
          "title": "Download Data for Figure 2.1",
          "url": "https://files.worldhappiness.report/WHR21_Data_Figure_2.1.xls"
        },
        {
          "name": "Mortality Data",
          "title": "Download Mortality Data",
          "url": "https://files.worldhappiness.report/WHR21_Data_Mortality.xlsx"
        },
        {
          "name": "Chapter 3 Appendix",
          "title": "Download Chapter 3 Appendix",
          "url": "https://files.worldhappiness.report/WHR21_Ch03_Appendix.pdf"
        },
        {
          "name": "Chapter 5 Appendix",
          "title": "Download Chapter 5 Appendix",
          "url": "https://files.worldhappiness.report/WHR21_Ch05_Appendix.pdf"
        },
        {
          "name": "Chapter 7 Appendix",
          "title": "Download Chapter 7 Appendix",
          "url": "https://files.worldhappiness.report/WHR21_Ch07_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, John F., Richard Layard, Jeffrey Sachs, and Jan-Emmanuel De Neve, eds. 2021. World Happiness Report 2021. New York: Sustainable Development Solutions Network.",
      "edition_year": 2021,
      "id": "whr:2021",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2021/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Statistical Appendix for Chapter 2",
          "title": "Download Statistical Appendix for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR20_Statistical_Appendix_01.pdf"
        },
        {
          "name": "Data for Figure 2.1",
          "title": "Download Data for Figure 2.1",
          "url": "https://files.worldhappiness.report/WHR20_Data_Figure_2.1.xls"
        },
        {
          "name": "Data for Figures 2.2, 2.3, and Appendix 2",
          "title": "Download Data for Figures 2.2, 2.3, and Appendix 2",
          "url": "https://files.worldhappiness.report/WHR20_Statistical_Appendix_02.xlsx"
        },
        {
          "name": "Data for Figure 2.4",
          "title": "Download Data for Figure 2.4",
          "url": "https://files.worldhappiness.report/WHR20_Data_Figure_2.4.xls"
        },
        {
          "name": "Statistical Appendix 3 for Chapter 2",
          "title": "Download Statistical Appendix 3 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR20_Statistical_Appendix_03.pdf"
        },
        {
          "name": "Chapter 3 Appendix",
          "title": "Download Chapter 3 Appendix",
          "url": "https://files.worldhappiness.report/WHR20_Ch03_Appendix.pdf"
        },
        {
          "name": "Chapter 4 Appendix",
          "title": "Download Chapter 4 Appendix",
          "url": "https://files.worldhappiness.report/WHR20_Ch04_Appendix.pdf"
        },
        {
          "name": "Chapter 5 Appendix",
          "title": "Download Chapter 5 Appendix",
          "url": "https://files.worldhappiness.report/WHR20_Ch05_Appendix.pdf"
        },
        {
          "name": "Chapter 6 Appendix",
          "title": "Download Chapter 6 Appendix",
          "url": "https://files.worldhappiness.report/WHR20_Ch06_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, John F., Richard Layard, Jeffrey Sachs, and Jan-Emmanuel De Neve, eds. 2020. World Happiness Report 2020. New York: Sustainable Development Solutions Network",
      "edition_year": 2020,
      "id": "whr:2020",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2020/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Statistical Appendix 1 for Chapter 2",
          "title": "Download Statistical Appendix 1 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR19_Statistical_Appendix_01.pdf"
        },
        {
          "name": "Statistical Appendix 2 for Chapter 2",
          "title": "Download Statistical Appendix 2 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR19_Statistical_Appendix_02.pdf"
        },
        {
          "name": "Chapter 3 Appendix",
          "title": "Download Chapter 3 Appendix",
          "url": "https://files.worldhappiness.report/WHR19_Ch03_Appendix.pdf"
        },
        {
          "name": "Chapter 6 Appendix",
          "title": "Download Chapter 6 Appendix",
          "url": "https://files.worldhappiness.report/WHR19_Ch06_Appendix.pdf"
        }
      ],
      "citation": "This publication may be reproduced using the following reference: Helliwell, J., Layard, R., & Sachs, J. (2019). World Happiness Report 2019, New York: Sustainable Development Solutions Network.",
      "edition_year": 2019,
      "id": "whr:2019",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2019/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Statistical Appendix 1 for Chapter 2",
          "title": "Download Statistical Appendix 1 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR18_Statistical_Appendix_01.pdf"
        },
        {
          "name": "Statistical Appendix 2 for Chapter 2",
          "title": "Download Statistical Appendix 2 for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR18_Statistical_Appendix_02.pdf"
        },
        {
          "name": "Chapter 3: Online Appendix",
          "title": "Download Chapter 3: Online Appendix",
          "url": "https://files.worldhappiness.report/WHR18_Ch03_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, J., Layard, R., & Sachs, J. (2018). World Happiness Report 2018, New York: Sustainable Development Solutions Network.",
      "edition_year": 2018,
      "id": "whr:2018",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2018/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Executive Summary",
          "title": "Download Executive Summary",
          "url": "https://files.worldhappiness.report/WHR17_Ch00.pdf"
        },
        {
          "name": "Chapter 2. Statistical Appendix",
          "title": "Download Chapter 2. Statistical Appendix",
          "url": "https://files.worldhappiness.report/WHR17_Statistical_Appendix.pdf"
        },
        {
          "name": "Chapter 2. NSO Data Collection",
          "title": "Download Chapter 2. NSO Data Collection",
          "url": "https://files.worldhappiness.report/WHR17_Data_NSO.pptx"
        },
        {
          "name": "Chapter 2. Final Data for Figures in Chapter 2",
          "title": "Download Chapter 2. Final Data for Figures in Chapter 2",
          "url": "https://files.worldhappiness.report/WHR17_Data.xlsx"
        },
        {
          "name": "Chapter 3. Appendix",
          "title": "Download Chapter 3. Appendix",
          "url": "https://files.worldhappiness.report/WHR17_Ch03_Appendix.pdf"
        },
        {
          "name": "Chapter 4. Appendix",
          "title": "Download Chapter 4. Appendix",
          "url": "https://files.worldhappiness.report/WHR17_Ch04_Appendix.pdf"
        },
        {
          "name": "Chapter 5. Appendix",
          "title": "Download Chapter 5. Appendix",
          "url": "https://files.worldhappiness.report/WHR17_Ch05_Appendix.pdf"
        },
        {
          "name": "Chapter 6. Appendix",
          "title": "Download Chapter 6. Appendix",
          "url": "https://files.worldhappiness.report/WHR17_Ch06_Appendix.pdf"
        }
      ],
      "citation": "Helliwell, J., Layard, R., & Sachs, J. (2017). World Happiness Report 2017, New York: Sustainable Development Solutions Network.",
      "edition_year": 2017,
      "id": "whr:2017",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2017/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Frequently Asked Questions",
          "title": "Download Frequently Asked Questions",
          "url": "https://files.worldhappiness.report/WHR16_FAQ.pdf"
        },
        {
          "name": "Statistical Appendix",
          "title": "Download Statistical Appendix",
          "url": "https://files.worldhappiness.report/WHR16_Statistical_Appendix.pdf"
        },
        {
          "name": "NSO Data Collections",
          "title": "Download NSO Data Collections",
          "url": "https://files.worldhappiness.report/WHR16_Data_NSO.pptx"
        },
        {
          "name": "Special Rome Edition",
          "title": "Download Special Rome Edition",
          "url": "https://files.worldhappiness.report/WHR16_Vol02.pdf"
        }
      ],
      "citation": "Helliwell, J., Layard, R., & Sachs, J. (2016). World Happiness Report 2016, Update (Vol. I). New York: Sustainable Development Solutions Network.",
      "edition_year": 2016,
      "id": "whr:2016",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2016/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Annex 1",
          "title": "Download Annex 1",
          "url": "https://files.worldhappiness.report/WHR15_Ch05_Appendix.pdf"
        },
        {
          "name": "Summary",
          "title": "Download Summary",
          "url": "https://files.worldhappiness.report/WHR15_Ch00.pdf"
        },
        {
          "name": "Frequently Asked Questions",
          "title": "Download Frequently Asked Questions",
          "url": "https://files.worldhappiness.report/WHR15_FAQ.pdf"
        },
        {
          "name": "Chapter 3 Data for Figures 4",
          "title": "Download Chapter 3 Data for Figures 4",
          "url": "https://files.worldhappiness.report/WHR15_Ch03_Data.xlsx"
        },
        {
          "name": "Statistical Appendix",
          "title": "Download Statistical Appendix",
          "url": "https://files.worldhappiness.report/WHR15_Statistical_Appendix.pdf"
        },
        {
          "name": "NSO Data Collections",
          "title": "Download NSO Data Collections",
          "url": "https://files.worldhappiness.report/WHR15_Data_NSO.pptx"
        },
        {
          "name": "WHR 2015 Summary (Spanish)",
          "title": "Download WHR 2015 Summary (Spanish)",
          "url": "https://files.worldhappiness.report/WHR15_Ch00_ES.pdf"
        },
        {
          "name": "WHR 2015 Chapter 1 (Spanish)",
          "title": "Download WHR 2015 Chapter 1 (Spanish)",
          "url": "https://files.worldhappiness.report/WHR15_Ch01_ES.pdf"
        },
        {
          "name": "WHR 2015 Summary (French)",
          "title": "Download WHR 2015 Summary (French)",
          "url": "https://files.worldhappiness.report/WHR15_Ch00_FR.pdf"
        },
        {
          "name": "WHR 2015 Summary (Italian)",
          "title": "Download WHR 2015 Summary (Italian)",
          "url": "https://files.worldhappiness.report/WHR15_Ch00_IT.pdf"
        },
        {
          "name": "WHR 2015 Summary (German)",
          "title": "Download WHR 2015 Summary (German)",
          "url": "https://files.worldhappiness.report/WHR15_Ch00_DE.pdf"
        },
        {
          "name": "WHR 2015 Summary (Portuguese)",
          "title": "Download WHR 2015 Summary (Portuguese)",
          "url": "https://files.worldhappiness.report/WHR15_Ch00_PT.pdf"
        }
      ],
      "citation": "Helliwell, John F., Richard Layard, and Jeffrey Sachs, eds. 2015. World Happiness Report 2015. New York: Sustainable Development Solutions Network.",
      "edition_year": 2015,
      "id": "whr:2015",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2015/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Chapter 2 Appendix",
          "title": "Download Chapter 2 Appendix",
          "url": "https://files.worldhappiness.report/WHR13_Ch02_Appendix.pdf"
        },
        {
          "name": "Frequently Asked Questions",
          "title": "Download Frequently Asked Questions",
          "url": "https://files.worldhappiness.report/WHR13_FAQ.pdf"
        }
      ],
      "citation": "Helliwell, John F., Richard Layard, and Jeffrey Sachs, eds. 2013. World Happiness Report 2013. New York: UN Sustainable Development Solutions Network.",
      "edition_year": 2013,
      "id": "whr:2013",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2013/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    },
    {
      "appendix_files": [
        {
          "name": "Data for Chapter 2",
          "title": "Download Data for Chapter 2",
          "url": "https://files.worldhappiness.report/WHR12_Data.xlsx"
        }
      ],
      "citation": "Helliwell, John F., Richard Layard, and Jeffrey Sachs, eds. 2012. World Happiness Report 2012. New York: UN Sustainable Development Solutions Network.",
      "edition_year": 2012,
      "id": "whr:2012",
      "license_note": "Report data appendices (Figure 2.1 data, statistical appendices) are free to download and may be reused with citation of the World Happiness Report (see the per-edition citation string). The underlying Gallup World Poll microdata is licensed by Gallup and is not redistributable; it is available only by request or subscription (worldhappiness.report/data-sharing). The dashboard at data.worldhappiness.report is 'powered by Gallup Analytics'. No explicit open licence (CC or similar) is stated on the terms page.",
      "publication_date": null,
      "report_url": "https://www.worldhappiness.report/ed/2012/",
      "source_url": "https://www.worldhappiness.report/data-sharing/",
      "terms_url": "https://www.worldhappiness.report/data-sharing/"
    }
  ],
  "retrieved_at": "2026-09-12T02:01:58.688Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://www.worldhappiness.report/data-sharing/",
  "warnings": []
}
```

### Panel

- Capability: `happiness/panel`
- Description: Gallup World Poll country-year panel for up to 10 countries (ISO3) from the dashboard country view: annual life ladder, three-year average, GDP per capita, social support, healthy life expectancy, freedom, generosity, corruption, positive/negative affect, benevolence and inequality, 2005 onwards. Only the current vintage is served; edition, if given, must match it.
- Instructions: Gallup World Poll country-year panel for up to 10 countries (ISO3) from the dashboard country view: annual life ladder, three-year average, GDP per capita, social support, healthy life expectancy, freedom, generosity, corruption, positive/negative affect, benevolence and inequality, 2005 onwards. Only the current vintage is served; edition, if given, must match it.
- Cost: 5 credits per call
- Capability file: [Panel](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/panel)

Accepted options:
- `countries` (string[], required): ISO 3166-1 alpha-3 codes (XKX Kosovo, TWN Taiwan, HKG Hong Kong). Example: `[]`
- `edition` (number): Optional pin; must equal the dashboard's current vintage (latest data year + 1) or the call fails with not_found. Example: `2013`
- `variables` (string[]): Subset of variables to include; life_ladder is always included. Omit for all. Example: `[]`
- `year_from` (number): year_from Example: `2005`
- `year_to` (number): year_to Example: `2005`

Response schema example:
```json
{
  "complete": true,
  "count": 1,
  "next_cursor": null,
  "observed_at_ms": 1789178518688,
  "records": [
    {
      "country": "Finland",
      "donated": {
        "rank": null,
        "unit": "Percentage",
        "value": "40.6"
      },
      "edition": 2026,
      "flags": {
        "amended": false,
        "source_flag": null
      },
      "freedom": {
        "rank": 11,
        "unit": "Percentage",
        "value": "94.1"
      },
      "gdp_per_capita": {
        "rank": 17,
        "unit": "US Dollars ($), purchasing power parity, constant 2017 international dollars",
        "value": "55770"
      },
      "generosity": {
        "rank": 46,
        "unit": "Percentage",
        "value": "40.6"
      },
      "healthy_life_expectancy": {
        "rank": 18,
        "unit": "Years",
        "value": "69.9"
      },
      "helped_stranger": {
        "rank": null,
        "unit": "Percentage",
        "value": "55.5"
      },
      "id": "whr:2026:FIN:2025",
      "inequality_sd": {
        "rank": 2,
        "unit": "Standard Deviation",
        "value": "1.46"
      },
      "iso3": "FIN",
      "life_ladder": {
        "rank": 1,
        "unit": "Score (0–10)",
        "value": "7.811"
      },
      "life_ladder_3yr": {
        "rank": 1,
        "unit": "Score (0–10)",
        "value": "7.764"
      },
      "negative_affect": {
        "rank": 11,
        "unit": "Percentage",
        "value": "16.5"
      },
      "perceptions_of_corruption": {
        "rank": 2,
        "unit": "Percentage",
        "value": "21.0"
      },
      "positive_affect": {
        "rank": 39,
        "unit": "Percentage",
        "value": "72.9"
      },
      "rank_3yr": 1,
      "region": "Western Europe",
      "social_support": {
        "rank": 9,
        "unit": "Percentage",
        "value": "93.4"
      },
      "source_url": "https://data.worldhappiness.report/country/FIN",
      "source_vintage": "data.worldhappiness.report dashboard (edition 2026 vintage)",
      "volunteered": {
        "rank": null,
        "unit": "Percentage",
        "value": "23.5"
      },
      "year": 2025
    }
  ],
  "retrieved_at": "2026-09-12T02:01:58.688Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://data.worldhappiness.report",
  "warnings": []
}
```

### Rankings

- Capability: `happiness/rankings`
- Description: One page of a World Happiness Report edition's ranking table (three-year average Cantril ladder score and rank) with the six explanatory-factor shares and raw factor levels from the dashboard country view. edition N reads dashboard data year N-1. Paginate with next_cursor; filter to ISO3 codes with countries.
- Instructions: One page of a World Happiness Report edition's ranking table (three-year average Cantril ladder score and rank) with the six explanatory-factor shares and raw factor levels from the dashboard country view. edition N reads dashboard data year N-1. Paginate with next_cursor; filter to ISO3 codes with countries.
- Cost: 5 credits per call
- Capability file: [Rankings](https://firecrawl.dev/alexandria/agents/providers/worldhappiness-report/happiness/rankings)

Accepted options:
- `countries` (string[]): Optional ISO3 filter; unranked codes are reported in warnings. Example: `[]`
- `cursor` (string): next_cursor from the previous page; encodes the edition. Pattern: ^v1:[0-9]{4}:[0-9]{1,4}$. Example: `<cursor>`
- `edition` (number): Report year (2013–2026 published). Required unless cursor is given. Example: `2013`
- `include_factors` (boolean): false skips the per-country detail calls (faster; explained_by and factors are null). Example: `false`
- `page_size` (number): page_size Example: `20`

Response schema example:
```json
{
  "complete": true,
  "count": 1,
  "next_cursor": null,
  "observed_at_ms": 1789178518688,
  "records": [
    {
      "annual_rank": 1,
      "annual_score": "7.811",
      "change_since_2012": "0.375",
      "change_since_2012_rank": 51,
      "country": "Finland",
      "data_year": 2025,
      "dystopia_residual": null,
      "edition": 2026,
      "explained_by": {
        "freedom": "0.142",
        "gdp_per_capita": "0.247",
        "generosity": "0.012",
        "healthy_life_expectancy": "0.121",
        "perceptions_of_corruption": "0.063",
        "social_support": "0.211"
      },
      "explained_by_unit": "Share of the life evaluation score explained by this factor (0–1; dashboard label 'Explains', shown as a percentage)",
      "factor_ranks": {
        "freedom": 11,
        "gdp_per_capita": 17,
        "generosity": 46,
        "healthy_life_expectancy": 18,
        "perceptions_of_corruption": 2,
        "social_support": 9
      },
      "factors": {
        "freedom": {
          "rank": 11,
          "unit": "Percentage",
          "value": "94.1"
        },
        "gdp_per_capita": {
          "rank": 17,
          "unit": "US Dollars ($), purchasing power parity, constant 2017 international dollars",
          "value": "55770"
        },
        "generosity": {
          "rank": 46,
          "unit": "Percentage",
          "value": "40.6"
        },
        "healthy_life_expectancy": {
          "rank": 18,
          "unit": "Years",
          "value": "69.9"
        },
        "negative_affect": {
          "rank": 11,
          "unit": "Percentage",
          "value": "16.5"
        },
        "perceptions_of_corruption": {
          "rank": 2,
          "unit": "Percentage",
          "value": "21.0"
        },
        "positive_affect": {
          "rank": 39,
          "unit": "Percentage",
          "value": "72.9"
        },
        "social_support": {
          "rank": 9,
          "unit": "Percentage",
          "value": "93.4"
        }
      },
      "flags": {
        "amended": false,
        "source_flag": null
      },
      "id": "whr:2026:FIN",
      "inequality_rank": 2,
      "inequality_sd": null,
      "iso3": "FIN",
      "ladder_score": "7.764",
      "ladder_score_unit": "Score (0–10)",
      "lower_whisker": null,
      "rank": 1,
      "region": "Western Europe",
      "source_url": "https://data.worldhappiness.report/country/FIN",
      "source_vintage": "data.worldhappiness.report dashboard (edition 2026 vintage)",
      "table_url": "https://data.worldhappiness.report/table",
      "upper_whisker": null,
      "years_covered": "2023–2025"
    }
  ],
  "retrieved_at": "2026-09-12T02:01:58.688Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://data.worldhappiness.report",
  "warnings": []
}
```