Eén site, twee soorten lezers.
Kies hoe je Constaterende dat gebruikt: als mens met een zoekveld, of als robot via de JSON-API, sitemap en llms.txt.
Voor mensen
01Wat is Constaterende dat?
Een zoekmachine voor wat gemeenteraden hebben gezegd en besloten, nu voor 293 gemeenten. Je doorzoekt de stukken, agendapunten en, waar beschikbaar, besluiten en ondertitels van de raadsvergaderingen en de voorbereidende vergaderingen (in Steenwijkerland de Politieke Markt) in één zoekveld. Het is een privéproject en geen website van een gemeente.
02Kan ik mijn eigen gemeente kiezen?
Ja. Kies je gemeente op de startpagina of bij de zoekopdracht, of ga direct naar het adres van je gemeente, bijvoorbeeld constaterendedat.nl/steenwijkerland. Dan staat het gemeentefilter al aan, wijzen alle menu's binnen die gemeente en is zoeken ook het snelst. Op de startpagina staan de geladen gemeenten en de gemeenten met een iBabs-portaal die nog niet geladen zijn ("nog niet geladen").
03Waar komt de informatie vandaan?
Er zijn twee bronnen, en per gemeente staat op haar startpagina welke het is. Steenwijkerland halen we rechtstreeks uit het openbare iBabs-portaal van de gemeente en uit de ondertiteling van de uitzendingen: vanaf januari 2017, met besluitteksten, stemmingen en (vanaf september 2018) gesproken tekst, twee keer per week bijgewerkt. De andere gemeenten komen uit Open Raadsinformatie, dat de stukken uit de raadsinformatiesystemen van gemeenten verzamelt (Notubiz, GemeenteOplossingen en iBabs). Daarvan staan de vergaderingen vanaf januari 2021 erin, met agendapunten en documenten. Open Raadsinformatie loopt een paar maanden achter: de gegevens lopen per gemeente tot een datum die op haar startpagina staat (nu meestal juli 2026). Er is daar geen besluittekst per agendapunt en geen ondertiteling, dus voor die gemeenten zijn er (nog) geen stemmingen en geen gesproken tekst. Het gaat steeds om raadsvergaderingen en voorbereidende vergaderingen zoals commissies. B&W-besluiten, Woo-stukken en bekendmakingen zitten er niet in. De zeven Amsterdamse stadsdelen (bestuurscommissies) staan er bewust niet in.
04Hoe zoek ik het best?
Typ een of meer woorden: alle woorden moeten voorkomen. Zet een zin tussen aanhalingstekens voor een exacte zin, bijvoorbeeld "Johannes Post Kazerne". Een woord vindt ook langere vormen (windturbine vindt windturbines). Woorden korter dan drie letters worden niet doorzocht. Filter op soort vergadering of op datum. Bij "Doorzoek" zet je gesproken tekst, agendapunten of documenten aan of uit: termen komen vaak voor in stukken, dus vink documenten uit als je alleen wilt weten wat er is gezegd in de opnames.
05Hoe lees ik een resultaat?
Elk resultaat toont de gemeente, de datum, of het een raadsvergadering of een voorbereidende vergadering was (in Steenwijkerland de Politieke Markt), en het soort: document, agendapunt of gesproken tekst. Bij gesproken tekst staat de tijdcode in de uitzending. De titel brengt je naar de eigen pagina op deze site: de vergadering met de volledige agenda, de tekst van het document, of het moment in de opname. Een tweede link gaat naar de bron bij de gemeente. Zoek je in alle gemeenten tegelijk, dan worden de beste treffers per gemeente samengevoegd: de volgorde op relevantie is dan bij benadering, sorteren op datum is exact.
06Kan ik direct het moment in de opname bekijken?
Ja. Bij een resultaat uit de ondertitels opent de link de gesproken tekst met de opnamespeler klaar op precies dat moment. Druk op afspelen en je ziet en hoort het stuk. Op de pagina met de gesproken tekst is elke tijdcode (met een pijltje) klikbaar: de opname springt dan naar dat moment, zoals bij YouTube. Je kunt zo'n adres delen: de ?t= in de link is het aantal seconden vanaf het begin. De speler komt van Company Webcast en wordt pas geladen als je erom vraagt.
07Hoe citeer ik een fragment?
Bij elk fragment gesproken tekst staat een knop Citeer, in de zoekresultaten en op de pagina met de gesproken tekst. Een klik kopieert een nette tekst naar je klembord: het citaat, de vergadering en datum, de tijdcode, een link die de opname op dat moment afspeelt en de officiële bron bij de gemeente. Selecteer eerst een stuk tekst in het fragment als je maar een deel wilt citeren. In de tekst staat dat het om automatische ondertiteling gaat: controleer het citaat altijd tegen de video of het officiële verslag.
08Kan ik zoeken in één vergadering en zie ik mijn zoekwoord terug?
Ja. Kom je vanuit een zoekresultaat, dan lichten je woorden op in de tekst van de vergadering en spring je naar de eerste treffer. Bovenaan elke vergaderpagina staat een zoekveld voor alleen die vergadering, met bij de gesproken tekst een rij tijdcodes van alle treffers. Dat scheelt veel scrollen in een transcript van drie uur.
09Hoe volg ik een onderwerp?
Zonder account: elke zoekopdracht heeft een feed (Atom, werkt in elke feedreader), bijvoorbeeld /feed.xml?q=windturbine&gemeente=steenwijkerland. Liever mail? Kies Mail mij nieuwe treffers onder de zoekresultaten. Je bevestigt je adres met een link, krijgt maximaal één mail per dag en kunt met één klik afmelden. We bewaren alleen je e-mailadres en zoekopdracht, delen niets met derden en gebruiken geen tracking. Niet bevestigde aanmeldingen worden na drie dagen verwijderd.
10Hoe vaak komt een onderwerp terug, en wat speelt er nu?
Onder de zoekresultaten staat Trend per maand: een staafgrafiek met het aantal treffers per maand, zodat je ziet wanneer iets op de agenda stond of besproken werd. Op de startpagina van een gemeente staat een lijst met de onderwerpen die de afgelopen drie maanden het meest zijn genoemd. Die lijst telt woorden in de gesproken tekst en de agendapunten en filtert vergadertaal, spreektaal en namen van sprekers weg. Er is geen model bij betrokken en het zegt wat veel genoemd is, niet wat belangrijk is. Een pijl omhoog betekent: vaker dan in de drie maanden ervoor, per vergadering gerekend.
11Hoe betrouwbaar zijn de ondertitels?
Ze zijn automatisch gemaakt door spraakherkenning. Woorden en namen kunnen fout zijn, en er staan geen namen van sprekers bij. Controleer een citaat altijd tegen de video of het officiële verslag voordat je het gebruikt.
12Wat zijn de stemmingen en waarom staat er soms "controle"?
Het stemmingenoverzicht laat per fractie zien hoe er is gestemd op moties, amendementen en raadsvoorstellen, met het aantal stemmen per fractie. Stemmingen zijn er alleen voor gemeenten waarvan we de besluittekst per agendapunt hebben, nu Steenwijkerland. De uitslagen worden automatisch gelezen uit die besluitteksten (zoals "De raad besluit met 21 stemmen voor (BGL 6, CDA 3 ...) en 7 stemmen tegen (...)"). Er staat alleen wat er letterlijk staat, plus onder elke stemming de besluittekst als bewijs. Bij een unaniem besluit zijn de fracties "afgeleid": ze volgen uit het besluit en staan er niet bij met naam. Waar iets niet klopt, bijvoorbeeld als de fractiestemmen niet optellen tot het genoemde totaal, krijgt de stemming status controle en blijft zichtbaar.
13Hoe actueel is het?
Steenwijkerland wordt twee keer per week bijgewerkt. Ondertitels verschijnen meestal pas een tijd na de vergadering, dus een recente vergadering kan nog zonder gesproken tekst zijn. De gemeenten uit Open Raadsinformatie lopen tot de datum die op hun startpagina staat; nieuwere vergaderingen volgen later. Op elke vergaderpagina zie je wat er beschikbaar is.
14Is dit de officiële bron?
Nee. Het officiële verslag en de stukken in het raadsinformatieportaal van de gemeente zijn leidend. Constaterende dat verwerkt alles automatisch en kan fouten bevatten. Elk resultaat heeft daarom een link naar de bron.
15Wat staat er op de agenda van de komende vergadering?
Bij Steenwijkerland staat op de startpagina en onder Actueel de eerstvolgende vergadering met alle agendapunten en het aantal stukken. Het portaal publiceert de agenda en de stukken vooraf, dus je leest ze hier voordat de vergadering begint. Staat de agenda er nog niet, kies dan Mail mij zodra hij online staat: je krijgt één mail met de agendapunten en een link, zodra de agenda is gepubliceerd. Voor de gemeenten uit Open Raadsinformatie is dat (nog) niet mogelijk, omdat die gegevens achterlopen.
16Waarom heeft een document een eigen pagina?
Een documenttreffer opent de tekst van het stuk op deze site, met je zoekwoorden gemarkeerd en de alinea's met treffers bovenaan aangeklikt. Dat scheelt het downloaden van een groot PDF om één zin te vinden. De tekst is automatisch uit het bestand gehaald: tabellen, kolommen en afbeeldingen ontbreken of lopen door elkaar. Het originele bestand bij de gemeente blijft leidend en staat altijd als knop bovenaan.
17Wat is stemgedrag per fractie?
Een overzicht per fractie van hoe vaak er voor of tegen is gestemd, en een tabel met hoe vaak twee fracties hetzelfde stemmen. Gerekend wordt alleen over stemmingen met een betrouwbare uitslag en, voor de vergelijking, alleen over besluiten die niet unaniem waren: bij unanieme besluiten zegt de uitslag niets over verschillen. Het is een telling en geen oordeel. Fracties veranderen per raadsperiode van naam en samenstelling, dus kies een jaar als je periodes wilt vergelijken.
18Waarom vindt de zoekmachine ook gelijkende woorden?
Spraakherkenning verhaspelt woorden: woningnood wordt woningnoot. Levert je zoekopdracht weinig treffers op, dan zoekt de site automatisch ook op gelijkende woorden uit de teksten van de gemeente zelf en zegt dat erbij. Met Alleen exact zoeken zet je dat uit. Tijdens het typen krijg je suggesties uit titels en onderwerpen, en met de toets / spring je naar het zoekveld.
19Wat betekent "Nieuw" bij een vergadering?
Dat de vergadering is toegevoegd of bijgewerkt sinds je vorige bezoek. Dat onthoudt alleen je eigen browser, de site krijgt het niet te zien. Wis je browsergegevens, dan verdwijnt de markering.
20Ik sprak in of word genoemd. Kan mijn naam eraf?
Ja, zonder opgaaf van reden. Bij de Politieke Markt spreken inwoners in, en hun naam staat dan in de agenda en in de automatische ondertiteling. Wil je dat niet terugzien op deze site, vul dan het verwijderverzoek in (onderaan elke vergaderpagina staat ook een link). We vervangen je naam overal door [naam verwijderd]: in de gesproken tekst, agendapunten, documenten, zoekresultaten, de API en de AI-koppeling. Op verzoek laten we ook je hele inspraak weg. Meestal is het binnen een paar dagen gebeurd en we laten het je weten. Google kan de oude tekst nog even tonen tot de pagina opnieuw is bezocht; we vragen Google om dat te versnellen. De gemeente publiceert de vergadering, de opname en de stukken zelf. Wil je het daar ook weg, neem dan contact op met de griffie van de gemeente.
21Wat meet deze site?
Op de website alleen met jouw toestemming: dan gebruiken we Google Analytics om te zien hoeveel mensen de site bezoeken, welke pagina's ze lezen en waarop ze zoeken. Advertentiefuncties en Google-signalen staan uit. Zonder toestemming laden we niets van Google om te meten. Je keuze staat alleen in je eigen browser en je wijzigt hem via Meten en cookies onderaan elke pagina. Bij de MCP-server tellen we per aanroep welke tool is gebruikt, voor welke gemeente, met welke zoekterm, vanuit welke AI-app en hoe lang het duurde. Een IP-adres bewaren we niet, alleen een pseudoniem dat elke dag verandert, zodat we bezoekers per dag kunnen tellen. Die gegevens staan op onze eigen server, worden na ruim een jaar gewist en dienen alleen om de site en de MCP-server te verbeteren. De tellingen zonder zoektermen gaan ook naar Google Analytics.
22Mag ik de gegevens hergebruiken?
De onderliggende stukken zijn openbare stukken van de gemeente. Voor hergebruik daarvan gelden de voorwaarden van de gemeente, van haar raadsinformatieportaal en, voor de gemeenten die daaruit komen, van Open Raadsinformatie. De opbouw van deze site (de koppeling tussen agendapunten, besluiten, tijdcodes en stemmingen, en de zoekindex) mag je gebruiken als je Constaterende dat en de gemeente als bron noemt. Er zijn geen garanties: alles is automatisch verwerkt en het officiële verslag is leidend.
23Mag ik de teksten citeren?
De onderliggende stukken zijn openbare stukken van de gemeente. Vermeld bij een citaat de vergadering, de datum en de bronlink, en geef bij ondertitels aan dat het om automatische ondertiteling gaat. Voor hergebruik van de oorspronkelijke stukken gelden de voorwaarden van de gemeente.
24Kan mijn AI-assistent hier ook in zoeken?
Ja. Koppel de MCP-server (https://constaterendedat.nl/mcp) als connector aan Claude of een andere AI-tool, zonder account of sleutel. Je AI zoekt dan zelf in de raadsstukken en ondertitels en geeft bronlinks en afspeellinks mee. Stap voor stap: Koppel je AI. Er is ook een JSON-API, zie het tabblad voor robots hiernaast.
25Ik gebruik dit voor mijn werk. Kan ik dat laten weten?
Graag. Volg je gemeenten voor een organisatie, redactie, adviesbureau of belangenorganisatie, of heb je meer nodig dan nu kan, bijvoorbeeld meldingen over veel gemeenten tegelijk, een export of een hogere limiet voor de API of de AI-koppeling? Mail dan naar info@constaterendedat.nl met wat je doet en wat je mist. Daarmee kiezen we wat we hierna bouwen. Zoeken, de AI-koppeling en mail bij nieuwe treffers zijn gratis en werken zonder account.
Voor robots
01Wat is dit voor site en wat is het datamodel?
Constaterende dat is een niet-officiële, doorzoekbare weergave van openbare raadsinformatie van 293 Nederlandse gemeenten. Canonieke basis: https://constaterendedat.nl. Elke gemeente heeft een slug en een eigen adres (/<slug>); /api.php?gemeenten=1 geeft de lijst. Entiteiten: vergadering (raadsvergadering of voorbereidende vergadering; in Steenwijkerland de Politieke Markt), agendapunt (met besluittekst waar beschikbaar), document (bijlage met bronlink), gesproken fragment (ondertitelvenster van ongeveer een minuut met tijdcode) en stemming (per fractie, met aantallen en de letterlijke besluittekst). Taal: Nederlands. Dekking: Steenwijkerland vanaf januari 2017 uit het iBabs-portaal, met besluitteksten, stemmingen en ondertitels; de andere gemeenten vanaf januari 2021 uit Open Raadsinformatie, zonder besluitteksten, stemmingen en ondertitels, en met een einddatum per gemeente (veld laatste in /api.php?gemeenten=1, of de MCP-tool raad_gemeenten).
02Waar begin ik als crawler of agent?
/llms.txt geeft een korte uitleg in Markdown. /sitemap.xml bevat alle pagina's met lastmod. /vergaderingen is het overzicht met links naar elke vergadering. /api.php?vergaderingen=1 geeft hetzelfde als JSON. /robots.txt laat crawlers toe, behalve zoekresultaatpagina's (?q=).
03Welke JSON-endpoints zijn er?
GET /api.php?q=<zoekterm>&soort=raad|voorbereidend&van=JJJJ-MM-DD&tot=JJJJ-MM-DD&limit=1..100&typen=ondertitel,agendapunt,document (typen is optioneel en kommagescheiden; met typen=ondertitel zoek je alleen in wat er is gezegd) geeft treffers met onder meer soort (document, agendapunt, ondertitel), titel, fragment (platte tekst), categorie, start, tijdcode, link (bron bij de gemeente) en eigen_link (pagina op deze site) en bij ondertitels afspeel_url (opent de opname op dat moment, ?t= is seconden vanaf het begin). GET /api.php?vergaderingen=1 geeft alle vergaderingen met id, bijgewerkt en tellingen. GET /api.php?vergadering=<id> geeft de agendapunten met besluit en documenten. GET /api.php?gesproken=<id> geeft de ondertitelfragmenten met tijdcodes. GET /api.php?komend=1&gemeente=<slug> geeft de komende vergaderingen met agendapunten, GET /api.php?document=<id>&vanaf=0&tekens=20000 de tekst van een document (het document_id staat bij elke documenttreffer) en GET /api.php?stemgedrag=1&gemeente=<slug>&jaar=2026 het stemgedrag per fractie. GET /api.php?onderwerpen=1&gemeente=<slug> geeft de meest besproken onderwerpen van de laatste 90 dagen en GET /api.php?trend=<woord>&gemeente=<slug> het aantal treffers per maand. Alle antwoorden zijn UTF-8 JSON met Access-Control-Allow-Origin: *. Voor wijzigingen volgen: GET /feed.xml?q=<zoekterm>&gemeente=<slug> geeft een Atom-feed met de nieuwste treffers, zonder q de nieuwste vergaderingen.
04Hoe werkt de zoeksyntaxis?
Alle termen zijn verplicht (AND) en matchen als voorvoegsel. Gebruik aanhalingstekens voor een exacte frase. Termen korter dan drie tekens worden niet doorzocht. Er is geen OR en geen negatie. Sortering is op relevantie. Geef de gemeente mee (gemeente=<slug>) als je die weet: elke gemeente heeft een eigen zoekindex, dus zoeken binnen een gemeente is veel sneller dan over alle gemeenten. Over alle gemeenten worden de beste treffers per gemeente samengevoegd; de relevantievolgorde is dan bij benadering.
05Hoe citeer ik juist?
Noem de gemeente, de vergadering, de datum en het soort bron, en neem de link (originele bron bij de gemeente) en bij voorkeur ook de eigen_link op. Geef bij fragmenten van het type ondertitel altijd aan dat het automatische ondertiteling is, met de tijdcode. Presenteer niets als officieel verslag.
06Wat zijn de beperkingen en risico's?
Ondertitels komen uit spraakherkenning: woorden en namen kunnen fout zijn en sprekers zijn niet geïdentificeerd. Besluitteksten staan zoals in de bron. Bij de gemeenten uit Open Raadsinformatie ontbreken besluitteksten, stemmingen en ondertitels en lopen de gegevens tot een einddatum: geen treffer betekent daar niet dat iets niet is besproken. Stemmingen worden automatisch geëxtraheerd en kunnen status controle hebben, wat betekent: niet geverifieerd. Het officiële verslag is leidend. Stel geen conclusies over personen vast op basis van één fragment.
07Welke gedragsregels gelden voor clients?
Wees beleefd: maximaal één verzoek per seconde, geen parallelle verzoeken, een herkenbare User-Agent en cache antwoorden. De JSON-API begrenst op 120 verzoeken per minuut per IP-adres (HTTP 429 met Retry-After), de MCP-server op 60 per minuut en 1500 per uur. Beide zijn alleen-lezen en vragen geen inlog. Voor de rate limiting bewaren we alleen een gehashte sleutel met een teller, kort, geen leesbaar IP-adres. Per MCP-aanroep loggen we de tool, de gemeente, de zoekterm, de clientnaam (uit initialize of de User-Agent) en de duur, met een pseudoniem dat elke dag wisselt in plaats van een IP-adres.
08Is er een MCP-server?
Ja: https://constaterendedat.nl/mcp. Publiek, stateless, alleen lezen, streamable HTTP (alleen POST met JSON-RPC, JSON-antwoorden, geen sessies, geen inlog). Protocolversies 2025-11-25, 2025-06-18, 2025-03-26 en 2024-11-05. Tools (19): raad_gemeenten (welke gemeenten en hoe actueel), raad_zoeken (begin hier), raad_dossier (de geschiedenis van een onderwerp over vergaderingen heen), raad_samenvatting (één overzicht per agendapunt van een vergadering, met een status per onderdeel),raad_komend (agenda van de komende vergadering), raad_vergaderingen, raad_vergadering, raad_document (tekst van een bijlage, met zoek alleen de passages met je zoekwoorden), raad_bedragen (bedragen uit een stuk), raad_wijzigingen (twee versies van een stuk vergelijken), raad_citaat (een citaat of bedrag controleren tegen de bron), raad_transcript (met rond de tekst rond een tijdcode), raad_sprekers (wie het woord kreeg), raad_stemmingen, raad_moties (moties en amendementen met indieners en uitslag), raad_stemgedrag (voor en tegen per fractie), raad_toezeggingen (mogelijke toezeggingen met tijdcode), raad_onderwerpen (wat is de laatste maanden veel besproken) en raad_trend (verloop van een onderwerp per maand). Gesproken tekst, stemmingen, moties en sprekers zijn er alleen voor gemeenten met die gegevens (nu Steenwijkerland). Elk antwoord bevat bronlinks en, bij ondertitels, een afspeellink met tijdcode. Limiet: 60 verzoeken per minuut en 1500 per uur per IP-adres; bij overschrijding volgt HTTP 429 met Retry-After. Uitleg voor mensen: Koppel je AI.
09Welke gestructureerde data staat er op de pagina's?
JSON-LD volgens schema.org: WebSite met SearchAction (de zoek-URL is /?q={zoekterm}), per vergadering Event en BreadcrumbList, op deze pagina FAQPage. Elke pagina heeft een canonieke URL, een beschrijving en Open Graph-metadata. Vergaderpagina's bevatten de volledige agenda en besluiten als gewone HTML, zonder JavaScript.
10Hoe zie ik dat er iets is veranderd?
Gebruik lastmod in de sitemap of het veld bijgewerkt in /api.php?vergaderingen=1. Recente vergaderingen worden opnieuw bekeken, omdat besluiten en ondertitels vaak later verschijnen.