bronpagina

CBS StatLine API

kerncijfers en alle tabellen van het Centraal Bureau voor de Statistiek

Het Centraal Bureau voor de Statistiek (CBS) publiceert vrijwel alle officiële cijfers over Nederland in StatLine: bevolking, economie, arbeidsmarkt, wonen, inkomen, criminaliteit en energie. De gegevens staan onder CC BY 4.0 beschikbaar via de open data-interfaces van het CBS. Via Identix.org zijn de kerncijfers en de volledige v4-catalogus met één endpoint te bevragen, genormaliseerd in dezelfde responswijze als alle andere bronnen op het platform — zonder account, zonder sleutel.

Over deze bron

Het Centraal Bureau voor de Statistiek is de nationale statistiekinstantie van Nederland. Sinds 2021 staat vrijwel alle StatLine-data onder een Creative Commons-licentie (CC BY 4.0) openbaar beschikbaar: hergebruik is toegestaan, ook commercieel, mits het CBS als bron wordt genoemd. De collectie omvat duizenden tabellen over vrijwel elk maatschappelijk domein, met uitsplitsingen naar regio, periode en achtergrondkenmerk.

De technische toegang loopt via de open data-interfaces van het CBS (v3 en v4). De v4-catalogus dekt de volledige tabelvoorraad; kerncijfers-regio's leveren de meest gevraagde gemeente- en wijkcijfers kant-en-klaar. Voor veel toepassingen — van redacties tot woningmarktanalisten — zijn dit de basisreeksen waarmee Nederland in cijfers wordt beschreven.

Op Identix.org zijn de CBS-bronnen aangesloten op dezelfde standaard als alle overige bronnen: één responsformaat, peildata in de metadata en herkomst per veld in bronnen[]. De kerncijfers zijn per regio op te vragen, de tabellen uit de v4-catalogus zijn query-baar op maat en periode. Combineren met andere registers — BAG-gebouwen, energielabels, veiligheidscijfers — gebeurt in één call via de combi-diensten.

Wie tijdreeksen wil volgen, zoals CO₂-uitstoot per jaar, elektriciteitsopwekking per energiebron of asielinstroom per maand, vindt die reksen voorgesneden terug als kant-en-klare series. Elke waarde is herleidbaar tot de tabel en de peildatum waaruit hij komt; maanden later opnieuw draaien geeft dezelfde uitkomst.

Voor AI-agents en LLM's zijn de CBS-tools via MCP beschikbaar in één configuratie. Zo kan een agent op een vraag als 'hoeveel inwoners heeft Groningen' direct de gevalideerde bron raadplegen in plaats van te vertrouwen op trainingsdata.

Wat kun je ermee

Kerncijfers per regio — gemeente, wijk of buurt op code of naam, met de standaardkenmerken uit de meest recente tabellen.
Tijdreeksen volgen — voorgesneden reeksen zoals CO₂ per jaar, elektriciteit per bron of asielinstroom per maand — hetzelfde formaat als elke andere bron.
Tabellen vinden en bevragen — de volledige v4-catalogus doorzoeken en elke tabel op maat en periode query'en zonder de OData-structuur te leren.
Cijfers combineren — CBS-cijfers naast BAG-voorraad, energielabels of veiligheidsdata via de regio-codes — de combi-diensten doen de koppeling.

CBS-data via de API ophalen

Het CBS ontsluit StatLine als open data via OData op opendata.cbs.nl — duizenden tabellen, gratis, onder CC BY 4.0. De drempel is technisch: de werking vraagt tabelidentificaties, OData-endpoint-structuur en de keuze tussen de v3- en v4-generatie. Wie in Python of R werkt, kent de pakketten cbsodata en cbsodataR die dat wegnemen. Via Identix.org is die vertaalslag in de ontsluiting zelf gelegd: tabellen zoeken, metadata lezen en gegevens opvragen gebeurt met één endpoint in vaste vorm — dezelfde envelop als elke andere bron op het platform.

Kerncijfers per gemeente, wijk of buurt opvragen

De meest gevraagde CBS-vraag is niet de tabel maar het getal: hoeveel inwoners heeft deze gemeente, wat is de gemiddelde WOZ-waarde in deze wijk, hoe vergrijst deze buurt. De kerncijfers-endpoints leveren die antwoorden kant-en-klaar per regio-code, met de regio's herbruikbaar via de vaste gebiedscodes die ook in PDOK en de BAG lopen.

Van tabel naar tijdreeks

Wie trends volgt wil geen tabelstructuren maar reeksen. De Nederland-reeksen op het platform — CO₂-uitstoot per jaar, elektriciteitsopwekking per bron, asielinstroom per maand — zijn uit de bron gehaald en als gelabelde puntenreeksen opgeleverd, met in de metadata de tabel en peildatum waaruit elke waarde komt. Maanden later hetzelfde verzoek draaien geeft dezelfde reeks terug.

Welke tabel heb ik nodig?

De catalogus-kwestie: het CBS telt duizenden tabellen en de juiste vinden is zoeken op titel en trefwoord. De v4-catalogus is via het platform doorzoekbaar; de zoekvraag levert tabellen met titel, beschrijving en periode, en van daar is het één stap naar de gegevens zelf.

Licentie en bronvermelding

Vrijwel alle StatLine-data staat onder CC BY 4.0: hergebruik is vrij, ook commercieel, mits het CBS als bron wordt genoemd. Elke respons van het platform draagt die attributie mee in de metadata — net als de nieuwskamer van Identix, die elke grafiek met bron en licentie publiceert.

Kerngegevens

instantie	Centraal Bureau voor de Statistiek
domeinen	statistiek
licentie	CC BY 4.0
protocol	rest
authenticatie	none
endpoints	4
status	live

Endpoints

GET /v1/cbs/kerncijfers

GET /v1/cbs/regios

GET /v1/cbs/tabellen

GET /v1/cbs/tabellen/{id}/query

Zo koppel je het

curl https://identix.org/v1/cbs/kerncijfers # Python import urllib.request, json with urllib.request.urlopen("https://identix.org/v1/cbs/kerncijfers") as r: data = json.load(r) # AI-agent (MCP) de bron is als tool beschikbaar in de ene configuratie van Identix.org

Combineren met andere bronnen

Deze bron is aangesloten op de combi-API's: adres, pand, punt en regio combineren haar met BAG, CBS, energielabels en meer in één call. De dataproducten bouwen er monitors en rekenkernen op. Zie ook de nieuwskamer voor dagelijkse analyse op deze en andere bronnen.

Veelgestelde vragen

Wat kost de CBS API via Identix.org?

Raadplegen is zonder account en zonder sleutel mogelijk binnen de publieke limieten. Zwaarder en herhaald gebruik valt onder de trappen van het tarievenmodel.

Onder welke licentie valt CBS-data?

Vrijwel alle StatLine-data staat onder CC BY 4.0: hergebruik is vrij, ook commercieel, mits het CBS als bron wordt vermeld.

Kan ik gemeente- of wijkcijfers opvragen?

Ja. De kerncijfers zijn per regio op te vragen met gemeente-, wijk- of buurtcode; de respons bevat vaste gebiedscodes die matchen met de andere geo-bronnen op het platform.

Hoe vers is de data?

De bron wordt geraadpleegd op het moment van uw vraag, met maximaal 24 uur cache. Peildata staat in de metadata van elke respons.

Is dit hetzelfde als cbsodata voor Python?

De bron is hetzelfde; het platform biedt de ontsluiting API-eerst: geen OData-kennis nodig, en de gegevens combineren in één call met de andere bronnen.

Hoe vind ik de juiste tabel?

Doorzoek de v4-catalogus via het tabellen-endpoint: zoeken op trefwoord levert titel, beschrijving en periode; van daar is het één call naar de gegevens.

Kan ik CBS-cijfers op een kaart zetten?

Ja: de gebiedscodes matchen met PDOK-gebieden; de combi-diensten leveren cijfer-op-kaart in één respons.

Probeer deze API — live

Stel de aanvraag zelf samen: parameters invullen, lijst-filters toevoegen (waar, sorteer, velden, paginering), live uitvoeren en het echte antwoord lezen — mét de exacte onderliggende call in curl, JavaScript of Python.

Bron en licentie — gegevens: Centraal Bureau voor de Statistiek (CC BY 4.0). Ontsluiting en normalisatie: Identix.org. Herkomst per veld staat in bronnen[] van elke respons; peildatum in de metadata.