Open data & API
Alle raadsinformatie op dit platform is als open data herbruikbaar: via een gratis JSON-API en als wekelijkse bulk-downloads. Voor journalistiek, onderzoek, apps of eigen analyses.
De data komt uit publieke bronnen en wordt dagelijks ververst. Een API-key is gratis en zo aangevraagd.
Gratis API-key aanvragen
Vul het formulier in en je ontvangt de key direct per e-mail.
Fair use: 60 requests per minuut, 5.000 per dag. Meer nodig (bijv. structurele of commerciële afname)? Mail ons — daar komen we samen uit.
Endpoints
Alle endpoints zijn read-only JSON. Stuur je key mee als X-API-Key-header of ?api_key=-parameter.
| GET /api/v1/gemeenten | Alle gemeenten (naam, provincie, inwoners, dataniveau) |
| GET /api/v1/moties | Moties en besluiten — filter op gemeente, zoekterm, type, uitslag, datum |
| GET /api/v1/moties/{id} | Één motie volledig: tekst, indieners en stemmen per raadslid |
| GET /api/v1/raadsleden | Raadsleden — filter op gemeente, partij of naam |
| GET /api/v1/stemmen | Individuele stemmen — filter op motie, raadslid of gemeente |
Filters
Onbekende of verkeerd gespelde parameters geven een foutmelding (HTTP 422) met de toegestane namen — nooit stilzwijgend een ongefilterde lijst.
| gemeente | moties, raadsleden, stemmen | CBS-code (0772), naam (Eindhoven) of slug (eindhoven). Bij naamgenoten krijg je de kandidaten met code terug. |
| q | gemeenten, moties, raadsleden | Zoekterm (minimaal 2 tekens) in titel of naam. |
| type | moties | motie of amendement. |
| uitslag | moties | aangenomen, verworpen, ingetrokken, aangehouden … |
| partij | moties, raadsleden | Partij van de indiener of het raadslid, bv. D66 (dekking niet landelijk). |
| datum_van, datum_tot | moties | YYYY-MM-DD, inclusief. Voor „wat is er nieuw sinds gisteren” volstaat datum_van. |
| actief | raadsleden | true of false — alleen zittende raadsleden. |
| motie_id, raadslid_id | stemmen | Minimaal één van motie_id, raadslid_id of gemeente is verplicht bij stemmen. |
| limit, offset | alle | Paginering; limit maximaal 100 (moties), 200 (raadsleden), 500 (gemeenten, stemmen). |
Voorbeeld
curl "https://raadkijker.be/api/v1/moties?q=vuurwerk&limit=5" \
-H "X-API-Key: rk_JOUW_KEY"Voorbeeld: nieuwe stukken van één gemeente sinds een datum
curl "https://raadkijker.be/api/v1/moties?gemeente=Eindhoven&datum_van=2026-09-01&limit=100" \
-H "X-API-Key: rk_JOUW_KEY"Interactieve API-documentatie (Swagger) — probeer de endpoints direct in je browser →
Bulk-downloads
Wekelijks ververste CSV-bestanden (gzip) met de volledige dataset van deze site — geen key nodig:
Voorwaarden
De data is afkomstig van publieke overheidsbronnen. Gebruik is vrij met bronvermelding („RaadKijker” met link). Wees terughoudend met persoonsgegevens van raadsleden buiten hun publieke functie. Geen garanties op volledigheid; de officiële bron is altijd leidend.