# Our World in Data

Ruim 4.300 grafieken (16 oktober 2026; de sitemap telt er 5.425, maar 1.109 daarvan zijn weergaven van 40 meerdimensionale grafieken) over klimaat, energie, gezondheid, bevolking en welvaart, met uitleg erbij. Achter bijna elke grafiek zit een CSV met dezelfde cijfers en een beschrijving van de bron. Nederland staat er bijna altijd in, naast de rest van de wereld.

- Uitgever: Global Change Data Lab (Our World in Data)
- Gebied: Wereld · Laagste detail: land
- Periode: verschilt per grafiek, bv. CO₂ 1750 – 2024 · Ververst: jaarlijks
- Toegang: Open · Licentie: CC BY 4.0 (eigen werk); data van derden onder hun eigen licentie
- Koppelsleutels: landcode (NLD), jaar
- Status: ok (2025-11-13) · CO₂ per inwoner · volgende update 2026-11-13
- URL: https://ourworldindata.org

## Wat kun je ermee?
- **CO₂ per Nederlander, sinds 1846.** De uitstoot van fossiel CO₂ was in Nederland het hoogst in 1979: 13,3 ton per inwoner. In 1990 was het 10,8 ton, in 2024 6,3 ton. Duitsland zat in 2024 op 6,8, België op 7,3 en het wereldgemiddelde op 4,7 ton.
- **Snel een vergelijking voor een artikel.** Zoek de grafiek, zet Nederland en twee buurlanden aan en download de CSV. De bron en de verwerking staan in de metadata, klaar om te citeren.
- **Een grafiek die zichzelf bijwerkt.** Laat je eigen grafiek de CSV-URL lezen. Het veld nextUpdate in de metadata zegt wanneer er nieuwe cijfers komen (voor CO₂ per inwoner 13 november 2026).
- **Terug naar de oorspronkelijke bron.** Volg in de volledige metadata (origins) de link naar de producent, zoals het Global Carbon Project. Voor een factcheck wil je weten wat OWID zelf heeft bewerkt.

## Zo verwerk je het
1. **Pak de naam van de grafiek uit de URL.** Elke grafiek heeft een korte naam: ourworldindata.org/grapher/co-emissions-per-capita. Zet er .csv achter voor de cijfers, .metadata.json voor de beschrijving of .zip voor allebei met een leesmij.
2. **Filter op Nederland.** Met csvType=filtered en country=~NLD krijg je alleen Nederland. Meer landen scheid je met een tilde: NLD~DEU~BEL. Met time=2024 of time=1990..2024 kies je de jaren.
   `https://ourworldindata.org/grapher/co-emissions-per-capita.csv?v=1&csvType=filtered&useColumnShortNames=true&country=~NLD`
3. **Lees eenheid en bron uit de metadata.** In columns staan eenheid (t/person), tijdspanne, lastUpdated, nextUpdate en de bronvermelding. fullMetadata wijst naar de volledige beschrijving met de licentie per oorspronkelijke bron.
   `https://ourworldindata.org/grapher/co-emissions-per-capita.metadata.json?v=1&csvType=filtered&useColumnShortNames=true&country=~NLD`
4. **Lees de documentatie van de Chart API.** Alle parameters staan in de documentatie van OWID.
   `https://docs.owid.io/projects/etl/api/chart-api/`

## Interessante koppelingen
- Klopt het internationale cijfer met het Nederlandse? → [cbs-statline](https://www.opendataindex.nl/bron/cbs-statline.md) via jaar. Leg bv. de CO₂-reeks van OWID naast de emissiecijfers van het CBS. Verschillen komen vaak door een andere afbakening, zoals lucht- en scheepvaart.

## Vergelijkbare bronnen
- [worldbank](https://www.opendataindex.nl/bron/worldbank.md): Meer indicatoren in één vaste API, maar zonder uitleg en uitgezochte bronnen.
- [eurostat](https://www.opendataindex.nl/bron/eurostat.md): Officiële Europese statistiek met regionaal detail, alleen Europa.
- [oecd-data](https://www.opendataindex.nl/bron/oecd-data.md): De ruwe OESO-tabellen, vaak een van de bronnen achter OWID-grafieken.

## Waar je op moet letten
- **Meestal niet hun eigen data.** De meeste cijfers komen van derden (WHO, VN, Wereldbank, Global Carbon Project …). Die vallen onder de licentie van die bron. Controleer die voor je publiceert.
- **Bewerkte cijfers.** OWID rekent vaak om, bv. per inwoner met een eigen bevolkingsreeks. De bronvermelding zegt dan 'with major processing by Our World in Data'. Noem dat ook in je eigen bronvermelding.
- **Afbakening staat in de kleine letters.** CO₂ per inwoner is bv. zonder landgebruik en zonder internationale lucht- en scheepvaart, en telt wat binnen de grenzen wordt uitgestoten (niet wat we importeren). Lees descriptionKey in de metadata.
- **Let op het veld nonRedistributable.** De volledige metadata van elke reeks heeft een veld nonRedistributable. Controleer het voordat je cijfers van derden doorgeeft of opnieuw publiceert.

## API (REST (CSV en JSON), Chart API)

- Basis: https://ourworldindata.org/grapher
- Toegang: Geen sleutel of account nodig (getest)
- Formaten: csv, json, zip
- Omvang: 4316 grafieken (sitemap 5.425 adressen, waarvan 1.109 weergaven van 40 grafieken; 16 okt 2026) (getest)
- Filteren: Geen querytaal: kies de grafiek in het pad, landen met country (~ ertussen) en jaren met time (.. voor een bereik).; ~, ..

### Endpoints
- `GET /{grafiek}.csv`: De cijfers achter een grafiek: Entity, Code (ISO3 of OWID_…), Year, en een kolom per reeks. De naam van de grafiek staat in de URL op de site.
- `GET /{grafiek}.metadata.json`: Per kolom eenheid, tijdspanne, lastUpdated, nextUpdate, uitleg (descriptionKey, descriptionProcessing), bronvermelding en een link naar de volledige metadata.
- `GET /{grafiek}.zip`: CSV, metadata en een leesmij in één ZIP (CO₂ per inwoner, alleen NL: 7,6 kB).
- `GET /{grafiek}.config.json`: De instellingen van de grafiek: titel, standaardselectie landen, kaart, dimensies (welke indicator-id's).
- `GET https://api.ourworldindata.org/v1/indicators/{id}.metadata.json`: Volledige metadata van één indicator: origins (producent, licentie, link), nonRedistributable, updatePeriodDays, processingLevel.
- `GET https://api.ourworldindata.org/v1/indicators/{id}.data.json`: Alle waarden van één indicator als drie lijsten: values, years, entities (entiteit-id's, geen ISO-codes). CO₂ per inwoner: 26.509 waarden, 580 kB.
- `GET https://ourworldindata.org/sitemap.xml`: Alle grafiek-adressen (/grapher/…); OWID heeft geen openbare lijst-API van grafieken.

### Parameters
- `csvType`: full (alle landen en jaren, standaard) of filtered (alleen wat country en time selecteren). (getest)
- `country`: Landen met ~ ertussen: NLD~DEU~BEL, of ~NLD voor één land. Ook OWID_WRL (wereld), OWID_EU27 en namen (Netherlands). (getest)
- `time`: 2024, 1990..2024 of latest. (getest)
- `useColumnShortNames`: true geeft korte kolomnamen (entity, code, year, emissions_total_per_capita) in plaats van titels met tekens als ₂. (getest)
- `v`: Versie van de grafiek (v=1), zoals in de downloadlinks van de site. (uit de beschrijving)
- `dimensies (bv. metric, source, frequency)`: Bij meerdimensionale grafieken kies je de weergave met eigen parameters, bv. electricity-mix.csv?metric=share_of_generation&source=renewables&frequency=annual. (getest)

### Kolommen in de CSV (useColumnShortNames=true) en velden in metadata.json (8)
`entity` tekst, `code` tekst, `year` integer, `emissions_total_per_capita` getal, `columns.<kolom>.unit / shortUnit` tekst, `columns.<kolom>.lastUpdated / nextUpdate` datum, `columns.<kolom>.citationShort` tekst, `columns.<kolom>.fullMetadata` url

### Limieten en valkuilen
- Geen sleutel, geen gedocumenteerde aanvraaglimiet. Antwoorden komen via Cloudflare (gecachet). csvType=full is voor CO₂ per inwoner 800 kB (26.509 rijen); filter liever. (getest)
- Oude grafieknamen sturen met 301 door naar een meerdimensionale grafiek en verliezen dan het landfilter: share-electricity-renewables.csv?country=~NLD gaf na de doorverwijzing alle landen. Vang doorverwijzingen af (curl zonder -L, fetch met redirect: 'manual') en gebruik de nieuwe naam met zijn dimensies. (getest)
- Een onbekende landcode geeft geen fout maar alleen een kopregel, en die mist dan de kolom Code. Een onbekende grafiek: 404 met {"status":404,"error":"Not found"}. (getest)
- De kop Last-Modified van de CSV is het moment van genereren, geen versheid. Gebruik lastUpdated en nextUpdate uit de metadata (CO₂ per inwoner: 2025-11-13, volgende 2026-11-13). (getest)
- Controleer nonRedistributable en origins[].license in de volledige metadata voordat je cijfers van derden opnieuw publiceert. Bij CO₂ per inwoner: false, Global Carbon Project CC BY 4.0. (getest)
- Bij grafieken die als kaart openen werkt country=~NLD alleen met &tab=chart erbij. (ervaring)
- robots.txt van ourworldindata.org laat alles toe; api.ourworldindata.org heeft geen robots.txt (404). (getest)

### Voorbeeld
```
https://ourworldindata.org/grapher/co-emissions-per-capita.csv?v=1&csvType=filtered&useColumnShortNames=true&country=NLD~DEU~BEL~OWID_WRL&time=2020..2024
```

## Zo haal je het op

### curl
```bash
curl "https://ourworldindata.org/grapher/co-emissions-per-capita.csv?v=1&csvType=filtered&useColumnShortNames=true&country=NLD~DEU~BEL~OWID_WRL&time=2024"
```

### python
```python
import io, pandas as pd, requests

url = "https://ourworldindata.org/grapher/co-emissions-per-capita.csv"
r = requests.get(url, params={"v": 1, "csvType": "filtered", "useColumnShortNames": "true",
                              "country": "NLD~DEU~BEL"})
df = pd.read_csv(io.StringIO(r.text))
print(df[df.year == 2024])   # emissions_total_per_capita = ton CO₂ per inwoner
```

## Wat je ermee kunt bouwen
- [Nederland naast Europa: een vergelijker voor elke indicator](https://www.opendataindex.nl/bouwen/nederland-naast-europa.md): Kies een cijfer (werkloosheid, werkuren, levensverwachting, CO2) en zie meteen waar Nederland staat tussen de 27 EU-landen, met vier internationale bronnen achter één knop.


## Wat er allemaal in zit: 4.321 grafieken

Alle grafieken van Our World in Data, in de gebieden en onderwerpen van OWID zelf, elke nacht opgehaald. Een grafiek kan onder meer onderwerpen staan; grafieken zonder onderwerp staan apart. Elke grafiek heeft een eigen pagina met de CSV voor Nederland en de metadata (bron, eenheid, laatst bijgewerkt).

- Soorten: grafiek 4.321
- Laatst gewijzigd: 2026-10-30 (829 in de afgelopen 30 dagen)
- Met een API-aanroep op de datasetpagina: 4.321
- Zoeken: https://www.opendataindex.nl/api/catalogus/owid?q=… of de MCP-functie zoek_datasets met herkomst=owid
- Elke rij heeft een eigen pagina: https://www.opendataindex.nl/dataset/owid/<sleutel>

### Mappen
- Education and Knowledge (60): Books (4), Education Spending (10), Internet (11), Literacy (12), Research & Development (23)
- Energy and Environment (871): Air Pollution (50), Animal Welfare (31), Biodiversity (106), Clean Water & Sanitation (73), Climate Change (71), CO2 & Greenhouse Gas Emissions (197), Energy (139), Environmental Impacts of Food Production (48) …
- Food and Agriculture (558): Agricultural Production (92), Animal Welfare (31), Crop Yields (46), Diet Compositions (25), Employment in Agriculture (27), Environmental Impacts of Food Production (48), Famines (17), Farm Size (11) …
- Health (1.381): Air Pollution (50), Alcohol Consumption (60), Antibiotics & Antibiotic Resistance (34), Burden of Disease (117), Cancer (82), Cardiovascular Diseases (58), Causes of Death (268), Child & Infant Mortality (101) …
- Human Rights and Democracy (410): Child Labor (15), Corruption (18), Democracy (162), Economic Inequality by Gender (35), Human Rights (58), LGBT+ Rights (49), State Capacity (45), Violence Against Children & Children's Rights (25) …
- Innovation and Technological Change (184): Artificial Intelligence (35), Internet (11), Medicine & Biotechnology (17), Research & Development (23), Space Exploration & Satellites (12), Technological Change (55), Transport (54)
- Living Conditions, Community and Wellbeing (200): Clean Water & Sanitation (73), Homelessness (8), Indoor Air Pollution (21), Light at Night (5), Loneliness & Social Connections (15), Marriages & Divorces (23), Time Use (17), Trust (31) …
- Population and Demographic Change (327): Age Structure (30), Child & Infant Mortality (101), Fertility Rate (63), Gender Ratio (16), Life Expectancy (67), Migration (23), Population Growth (59)
- Poverty and Economic Development (614): Clean Water & Sanitation (73), Corruption (18), Economic Growth (154), Economic Inequality by Gender (35), Education Spending (10), Foreign Aid (54), Healthcare Spending (56), Migration (23) …
- Violence and War (232): Homicides (38), Military Personnel & Spending (16), Nuclear Weapons (14), State Capacity (45), Terrorism (26), Violence Against Children & Children's Rights (25), War & Peace (73)
- Zonder onderwerp (633)

## Voorbeelden met echte cijfers (2)

Per voorbeeld de bevinding, de peildatum en de aanroep die precies deze cijfers ophaalt.

- **CO₂-uitstoot per inwoner van Nederland: 6,3 ton in 2024, 42% minder dan in 1990** (2024). Tabel co-emissions-per-capita. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/owid-co2-per-inwoner)
  - `https://ourworldindata.org/grapher/co-emissions-per-capita.csv?v=1&csvType=filtered&useColumnShortNames=true&country=~NLD&time=1990..latest`
- **CO₂-uitstoot per inwoner in Nederland: hoger dan in 20 van de 26 andere EU-landen** (2024). Tabel co-emissions-per-capita. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/owid-co2-per-inwoner-eu)
  - `https://ourworldindata.org/grapher/co-emissions-per-capita.csv?v=1&csvType=filtered&useColumnShortNames=true&country=AUT~BEL~BGR~HRV~CYP~CZE~DNK~EST~FIN~FRA~DEU~GRC~HUN~IRL~ITA~LVA~LTU~LUX~MLT~NLD~POL~PRT~ROU~SVK~SVN~ESP~SWE~OWID_EU27&time=2016..latest`