# Wereldbank indicatoren

Bevolking, economie, gezondheid en onderwijs per land, vaak vanaf 1960. Goed voor het grote plaatje, te grof voor regio's. De bekendste database, de World Development Indicators, heeft bijna 1.500 indicatoren; de hele API telde op 16 oktober 2026 29.490 indicatoren in 70 databases.

- Uitgever: Wereldbank
- Gebied: Wereld · Laagste detail: land
- Periode: 1960 – heden · Ververst: elk kwartaal
- Toegang: Open · Licentie: CC BY 4.0
- Koppelsleutels: landcode (NLD)
- Status: ok (2026-10-08)
- URL: https://data.worldbank.org

## Wat kun je ermee?
- **Nederland in de wereld.** Zet levensverwachting, CO₂ per inwoner of bbp naast andere landen.

## Zo verwerk je het
1. **Eén indicator voor Nederland.** De Indicators API (api.worldbank.org/v2, geen sleutel) geeft per land en indicator een reeks. Vraag JSON en geef de jaren mee. Bevolking van Nederland in 2025: 18.087.633 (lastupdated 8 oktober 2026).
   `https://api.worldbank.org/v2/country/NLD/indicator/SP.POP.TOTL?format=json&date=2015:2025`
2. **Landen naast elkaar.** Zet landcodes achter elkaar met een puntkomma. Met mrnev=1 krijg je per land de nieuwste waarde die niet leeg is. CO₂-uitstoot per inwoner in 2024 (zonder landgebruik): Nederland 6,6 ton, Duitsland 6,9, België 7,3.
   `https://api.worldbank.org/v2/country/NLD;BEL;DEU/indicator/EN.GHG.CO2.PC.CE.AR5?format=json&mrnev=1`
3. **Zoek de indicatorcode.** De World Development Indicators (bron 2) hebben 1.498 indicatoren (16 oktober 2026). De lijst geeft per code naam, uitleg en herkomst.
   `https://api.worldbank.org/v2/source/2/indicator?format=json&per_page=100`

## Vergelijkbare bronnen
- [eurostat](https://www.opendataindex.nl/bron/eurostat.md): Alleen Europa, maar veel meer detail.
- [Our World in Data](https://ourworldindata.org): Uitgezochte reeksen met uitleg en grafieken.

## Waar je op moet letten
- **Zonder format=json krijg je XML.** Standaard antwoordt de API in XML, 50 rijen per pagina (per_page). format=csv bestaat niet in de API zelf en geeft een foutmelding.
- **Geef altijd de jaren mee.** Op 16 oktober 2026 gaf …/country/NL/indicator/SP.POP.TOTL?format=json maar één jaar terug, terwijl dezelfde vraag met NLD of met date=1960:2025 alle 66 jaren gaf. Zet date erbij en controleer het veld total.

## API (REST (JSON/XML), Indicators API v2)

- Basis: https://api.worldbank.org/v2
- Toegang: Geen sleutel of account nodig (getest)
- Formaten: json, xml, json-stat, zip
- Omvang: 29544 indicatoren in 71 databases (/indicator en /source, 16 okt 2026) (getest)
- Filteren: Landen en indicatoren in het pad (meer met ;), jaren met date (bereik met :), nieuwste waarden met mrv of mrnev. Sorteren kan niet.; ;, :

### Endpoints
- `GET /country/{landen}/indicator/{indicator}`: De reeks: waarde per land en jaar. Meer landen met ;: NLD;BEL;DEU. all = alle landen én regio's.
- `GET /country/{land}/indicator/{ind1};{ind2}?source={id}`: Meer indicatoren in één aanroep (max. 60), alleen met source erbij (2 = World Development Indicators).
- `GET /indicator/{indicator}`: Beschrijving van een indicator: naam, eenheid, bron, uitleg (sourceNote), herkomst (sourceOrganization).
- `GET /source/{id}/indicator`: Alle indicatoren van één database, bv. source/2 = World Development Indicators.
- `GET /source`: De 71 databases met id, naam en lastupdated.
- `GET /sources/{id}/series/{indicator}/metadata`: Uitgebreide metadata per reeks: definitie, methode, aggregatie, licentie (License_Type).
- `GET /country/{land}`: Landgegevens: ISO2 en ISO3, regio, inkomensgroep, hoofdstad, coördinaten. /country geeft 296 landen en groepen.
- `GET /topic, /region, /incomelevel`: Lijsten van 21 onderwerpen, 44 regio's en de inkomensgroepen.

### Parameters
- `format`: json, jsonstat, xml (standaard) of jsonP (met prefix). format=csv bestaat niet (XML-fout 111). (getest)
- `date`: Jaar of bereik met dubbele punt: 2024 of 2015:2025. Ook maand/kwartaal bij hoogfrequente data, YTD:2013. (getest)
- `mrv`: De N nieuwste perioden (ook als ze leeg zijn). (getest)
- `mrnev`: De N nieuwste waarden die niet leeg zijn, per land. (getest)
- `gapfill`: Met mrv: vult een lege periode met een eerdere waarde. (uit de beschrijving)
- `frequency`: Jaar-, kwartaal- of maandwaarden, met mrv. (uit de beschrijving)
- `per_page`: Rijen per pagina, standaard 50. Bij een land met 66 jaren zet je per_page=100. (getest)
- `page`: Paginanummer (vanaf 1); het aantal pagina's staat in pages. (getest)
- `source`: Database-id; verplicht bij meer indicatoren in één aanroep. (getest)
- `downloadformat`: csv, xml of excel: hetzelfde als ZIP-bestand. (getest)
- `footnote`: Voetnoten per land, indicator en jaar. (uit de beschrijving)
- `/{taal}/…`: Taalvoorvoegsel voor vertaalde namen, bv. /v2/fr/country/NLD (Pays-Bas), /v2/es/…; geen Nederlands. (getest)

### Velden in het JSON-antwoord (array: [kop, rijen]) (9)
`[0].total` integer, `[0].lastupdated` datum, `[0].pages / per_page` integer, `[1][].indicator.id` tekst, `[1][].country.id` tekst, `[1][].countryiso3code` tekst, `[1][].date` tekst, `[1][].value` getal, `[1][].obs_status / decimal` tekst

### Limieten en valkuilen
- Hoogstens 60 indicatoren per aanroep, 1.500 tekens tussen twee schuine strepen en 4.000 tekens in de hele URL. (uit de beschrijving)
- Geen sleutel en geen gedocumenteerde aanvraaglimiet. Antwoorden zijn meestal binnen een seconde, maar een vraag met frequency=Q duurde 46 s en country/all met per_page=1 liep één keer in een time-out (60 s); dezelfde vraag met per_page=300 kwam daarna in 0,3 s. (getest)
- Zonder format=json krijg je XML. format=csv geeft een XML-fout; voor CSV gebruik je downloadformat=csv (een ZIP). (getest)
- Geef altijd date mee: …/country/NL/indicator/SP.POP.TOTL?format=json gaf op 16 okt 2026 maar één jaar terug, met date of met NLD alle jaren. Controleer total. (ervaring)
- Onbekende indicator: HTTP 200 met [{"message":[{"id":"120","key":"Invalid value"}]}]. Een datum zonder data (date=2025M01 voor een jaarreeks): 200 met total 0 en null. Kijk dus naar de inhoud, niet naar de status. (getest)
- country/all geeft 266 rijen per jaar: landen én groepen (regio's, inkomensgroepen, wereld). Filter op countryiso3code of haal de echte landen uit /country (region.id niet leeg en niet 'NA'). (getest)
- Rijen komen nieuwste jaar eerst. Bevolking NL 2025: 18.087.633 (lastupdated 8 okt 2026). (getest)
- Indicatorcodes veranderen soms: CO₂ per inwoner heet nu EN.GHG.CO2.PC.CE.AR5 (het oude EN.ATM.CO2E.PC is vervangen). Zoek in /source/2/indicator. (ervaring)

### Voorbeeld
```
https://api.worldbank.org/v2/country/NLD;BEL;DEU/indicator/SP.POP.TOTL?format=json&date=2023:2025&per_page=100
```

## 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: 29.490 indicatoren

Alle indicatoren van de Wereldbank-API, per database (World Development Indicators, Gender Statistics, Doing Business …) en waar de Wereldbank dat aangeeft per onderwerp, elke nacht opgehaald. Een indicator kan in meer databases staan. Elke indicator heeft een eigen pagina met de API-aanroep voor Nederland en de licentie als de metadata die noemt.

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

### Mappen
- Adjusted Net Savings (36): Economy & Growth (28), Energy & Mining (9), Environment (27)
- Africa Development Indicators (1.745): Agriculture & Rural Development (40), Aid Effectiveness (47), Climate Change (53), Economy & Growth (206), Education (76), Energy & Mining (25), Environment (37), External Debt (114) …
- Country Climate and Development Report (CCDR) (432): Agriculture & Rural Development (3), Climate Change (6), Economy & Growth (4), Education (3), Energy & Mining (6), Environment (14), Gender (3), Health (4) …
- Country Partnership Strategy for India (FY2013 - 17) (185)
- Country Policy and Institutional Assessment (21): Climate Change (1), Public Sector (21)
- Disability Data Hub (DDH) (1.577)
- Doing Business (194): Climate Change (1), Energy & Mining (1), Private Sector (4)
- Economic Fitness (2)
- Economic Fitness 2 (2)
- Education Policy (473): Education (1)
- Education Statistics (8.450): Aid Effectiveness (4), Climate Change (5), Economy & Growth (12), Education (877), External Debt (1), Gender (32), Health (16), Infrastructure (2) …
- Enterprise Surveys (115)
- Environment, Social and Governance (ESG) Data (80): Agriculture & Rural Development (5), Aid Effectiveness (6), Climate Change (14), Economy & Growth (3), Education (6), Energy & Mining (10), Environment (21), Financial Sector (1) …
- Exporter Dynamics Database – Indicators at Country-Year Level (98)
- Food Prices for Nutrition (45): Economy & Growth (2)
- FPN Datahub Archive (43)
- G20 Financial Inclusion Indicators (131)
- Gender Disaggregated Labor Database (GDLD) (16)
- Gender Statistics (1.411): Agriculture & Rural Development (4), Aid Effectiveness (8), Climate Change (7), Economy & Growth (8), Education (130), Environment (8), Financial Sector (1), Gender (212) …
- Global Economic Monitor (36)
- Global Economic Prospects (1)
- Global Financial Development (108): Financial Sector (100)
- Global Financial Inclusion and Consumer Protection Survey (347)
- Global Financial Inclusion and Consumer Protection Survey (Internal) (19)
- Global Findex database (3.313)
- Global Jobs Indicators Database (JOIN) (746)
- Global Partnership for Education (678)
- Global Public Procurement (111)
- Health Equity and Financial Protection Indicators (315)
- Health Nutrition and Population Statistics (475): Agriculture & Rural Development (4), Aid Effectiveness (8), Climate Change (9), Economy & Growth (1), Education (43), Environment (23), Financial Sector (1), Gender (65) …
- Health Nutrition and Population Statistics by Wealth Quintile (420): Health (355), Millenium development goals (2)
- Human Capital Index (27): Public Sector (9)
- ICP 2017 (47)
- ICP 2021 (47)
- IDA Results Measurement System (29): Aid Effectiveness (3), Climate Change (4), Economy & Growth (1), Education (4), Energy & Mining (1), Environment (6), Gender (5), Health (11) …
- Identification for Development (ID4D) Data (71)
- Indonesia Database for Policy and Economic Research (274): Agriculture & Rural Development (1), Climate Change (1), Gender (1), Health (5), Poverty (1)
- International Comparison Program (ICP) 2005 (47)
- International Comparison Program (ICP) 2011 (47)
- International Debt Statistics (577): Aid Effectiveness (2), Climate Change (1), Economy & Growth (16), External Debt (497), Financial Sector (5), Health (1), Trade (2)
- … en nog 30 mappen

## Voorbeelden met echte cijfers (2)

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

- **Bos als aandeel van het landoppervlak in Nederland: lager dan in 25 van de 26 andere EU-landen** (2024). Tabel AG.LND.FRST.ZS. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/worldbank-bos-eu)
  - `https://api.worldbank.org/v2/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;EUU/indicator/AG.LND.FRST.ZS?format=json&per_page=1000&date=2014:2026`
- **Aandeel 65-plussers in de bevolking van Nederland: 20,9 procent in 2025, 11,9 procentpunt hoger dan in 1960** (2025). Tabel SP.POP.65UP.TO.ZS. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/worldbank-65-plussers)
  - `https://api.worldbank.org/v2/country/NLD/indicator/SP.POP.65UP.TO.ZS?format=json&per_page=200&date=1960:2026`