Zoekdienst Overheid.nl (SRU)
De zoekdienst achter overheid.nl: één SRU-adres voor de officiële bekendmakingen (Staatscourant, Gemeenteblad, Kamerstukken …), de lokale regelgeving van gemeenten, provincies en waterschappen, de geldende wetten en de producten en diensten van overheden. Op 16 oktober 2026 stonden er 6,7 miljoen officiële publicaties in, 344.109 lokale regelingen, 148.592 wetsteksten en 54.667 producten. Je krijgt metadata in XML met een link naar het document.
Officiële publicaties per blad: het meest Gemeenteblad (560.560 publicaties), dan Staatscourant en Waterschapsblad
Officiële publicaties per blad, 2025, in publicaties. Totaal: 695.682; de grootste 12 van 13 categorieën staan in de grafiek. Gemeenteblad is 81% van het totaal. Naar publicatiedatum (dcterms.available). De bladen tellen precies op tot het totaal.
Wat je ermee kunt bouwen1
Wat kun je ermee?4 ideeën
Wat heeft jouw gemeente vandaag bekendgemaakt?
Zoek op dcterms.creator en de publicatiedatum. Amsterdam staat in 2025 als maker bij 51.402 officiële publicaties; tussen 14 en 16 oktober 2026 waren het er 302.
De gemeenten zijn de grootste publicist
In 2025 verschenen 695.682 officiële publicaties; 560.560 daarvan (81%) in het Gemeenteblad. De grafiek op deze pagina telt ze per blad.
Lokale regels naast elkaar
De collectie cvdr bevat alle verordeningen van gemeenten, provincies en waterschappen. Vergelijk bijvoorbeeld de hondenbelasting of de regels voor terrassen.
Een wet volgen
De collectie bwb heeft de geldende wetsteksten met hun versies. Gewijzigd sinds 1 oktober 2026: 656 regelingen.
Zo verwerk je het4 stappen
Een zoekvraag stellen
x-connection kiest de collectie (oep, cvdr, bwb, sc), query is CQL. Met maximumRecords=0 krijg je alleen het aantal.
https://zoekdienst.overheid.nl/sru/Search?version=1.2&operation=searchRetrieve&x-connection=oep&startRecord=1&maximumRecords=0&query=publicationname%3D%3D%22Gemeenteblad%22%20and%20dcterms.available%3E%3D2025-01-01%20and%20dcterms.available%3C%3D2025-12-31
Records ophalen
Elk record is een gzd-blok met OWMS-metadata: titel, identifier, soort, organisatie, datum en in enrichedData de url naar het document. Bij oep hoogstens 1.000 per verzoek.
https://zoekdienst.overheid.nl/sru/Search?version=1.2&operation=searchRetrieve&x-connection=oep&startRecord=1&maximumRecords=10&query=dcterms.creator%3D%3D%22Amsterdam%22%20and%20dcterms.available%3E%3D2026-10-14
Lokale regelgeving van één gemeente
In cvdr staat de gemeentenaam ook in dcterms.creator. Tilburg had er 1.105 (16 oktober 2026), van de Bouwverordening tot de Verordening Starterslening.
https://zoekdienst.overheid.nl/sru/Search?version=1.2&operation=searchRetrieve&x-connection=cvdr&startRecord=1&maximumRecords=10&query=dcterms.creator%3D%3D%22Tilburg%22
Producten en diensten (Samenwerkende Catalogi)
De collectie sc beschrijft wat overheden aanbieden: vergunningen, subsidies, aanvragen. Tilburg had er 89 (16 oktober 2026).
https://zoekdienst.overheid.nl/sru/Search?version=1.2&operation=searchRetrieve&x-connection=sc&startRecord=1&maximumRecords=1&query=authority%3D%3D%22Tilburg%22
Interessante koppelingen
Van motie tot wet
Volg een dossier in het Gegevensmagazijn van de Kamer en zoek met hetzelfde dossiernummer de Kamerstukken en de uiteindelijke publicatie in het Staatsblad.
Wat besloot de raad, en wanneer werd het bekendgemaakt?
Zoek een raadsbesluit in Open Raadsinformatie en de bijbehorende verordening in het Gemeenteblad of in cvdr.
Vergelijkbare bronnen
- open.overheid.nl (Woo-documenten)
Documenten die op grond van de Woo openbaar zijn gemaakt (besluiten, notities, mails), niet de officiële bekendmakingen.
- Open Raadsinformatie
Raadsstukken en vergaderingen van gemeenteraden; daar wordt besloten, in het Gemeenteblad wordt het bekendgemaakt.
- Tweede Kamer open data
Alles rond de Tweede Kamer met stemmingen en personen. De Kamerstukken staan in beide; de SRU-dienst geeft ze als officiële publicatie.
Waar je op moet letten
- SRU 1.2 verdwijnt
Volgens de KOOP-handleiding (juni 2025) gaat KOOP over op SRU 2.0. De SRU 2.0-adressen (repository.overheid.nl/sru, zoekservice.overheid.nl/sru) hebben een robots.txt die alles uitsluit; wij gebruiken alleen het 1.2-adres zonder robots.txt.
- Alleen metadata
De zoekdienst geeft beschrijvingen met een link. De documenten zelf (XML, PDF) staan op repository.overheid.nl, waarvan robots.txt alles uitsluit.
- Veldnamen zijn eigenwijs
Zoek op publicationname, niet op w.publicatienaam (dat geeft "Invalid search field"), en op dcterms.modified, niet dt.modified. Een fout komt als diagnostics-XML met HTTP 200.
- Hoogstens 1.000 per verzoek
Bij oep geeft maximumRecords boven de 1.000 de melding "maximumRecords is 1000". Pagineer met startRecord.
- Niet elke collectie werkt
oep, cvdr, bwb en sc gaven antwoord; op en vb gaven "Cannot determine …" en tr een leeg antwoord (16 oktober 2026).
APISRU 1.2 (XML, CQL) · gelezen 16 okt 2026
Geen sleutel of account. getest
officiële publicaties in collectie oep (dcterms.modified >= 1900-01-01, 16 okt 2026); cvdr 344.112 regelingversies, bwb 148.602, sc 54.671 getest
xml
Basisadres
https://zoekdienst.overheid.nl/sru/Search
Endpoints 5
- GET
?operation=searchRetrieve&x-connection=oepOfficiële publicaties: Staatscourant, Staatsblad, Gemeenteblad, Provinciaal blad, Waterschapsblad, Kamerstukken, Handelingen, Kamervragen, Tractatenblad. - GET
?operation=searchRetrieve&x-connection=cvdrLokale en regionale regelgeving (CVDR): verordeningen van gemeenten, provincies en waterschappen, elke versie een record. - GET
?operation=searchRetrieve&x-connection=bwbBasiswettenbestand: landelijke wetten en regelingen met geldigheidsperiode en links naar de XML-toestand. - GET
?operation=searchRetrieve&x-connection=scSamenwerkende Catalogi: producten en diensten van overheden (vergunningen, aanvragen, subsidies). - GET
?operation=explain&x-connection=oepBeschrijving van de dienst: alle zoekbare indexen.
Filteren getest
CQL (Contextual Query Language): index operator waarde, gecombineerd met and/or/not; sorteren met sortby index/ascending|descending. Indexnamen mogen zonder voorvoegsel (publicationname = overheidop.publicationname). Datums als JJJJ-MM-DD.
Parameters 7
version | Altijd 1.2. | getest |
operation | searchRetrieve (zoeken) of explain (beschrijving). | uit de beschrijving |
x-connection | De collectie: oep, cvdr, bwb of sc. op en vb gaven "Cannot determine …", tr een leeg antwoord. | getest |
query | De zoekvraag in CQL, bv. publicationname=="Gemeenteblad" and dcterms.available>=2025-01-01. Sorteren in de query zelf: … sortby dcterms.available/descending. | getest |
startRecord | Eerste record (begint bij 1). Het antwoord geeft nextRecordPosition. | getest |
maximumRecords | Aantal records; 0 = alleen numberOfRecords. Bij oep hoogstens 1.000. | getest |
sortKeys | SRU 1.2-parameter, maar sortKeys=dcterms.available,,0 sorteerde niet. Gebruik sortby in de query. | getest |
Velden in een gzd-record (selectie) 14
| Naam | Type | Betekenis |
|---|---|---|
dcterms:identifier | string | Publicatienummer (gmb-2026-480758, CVDR102368_1, BWBR0001888) |
dcterms:title | string | Titel |
dcterms:type | string | Soort (andere vergunning, regeling, wet, productbeschrijving …) |
dcterms:creator | string | Maker als naam (Amsterdam, Tilburg, Ministerie van …); bij sc heet het overheid:authority |
dcterms:available | date | Publicatiedatum (oep); sorteerbaar |
dcterms:modified | date | Laatste wijziging van het record |
dcterms:subject | string | Onderwerpen, met | gescheiden |
overheidop:publicationname | string | Het blad (Gemeenteblad, Staatscourant, Kamerstuk …), alleen oep |
overheid:organisationtype | string | gemeente, provincie, waterschap, ministerie … |
overheidop:dossiernummer | string | Kamerstukdossier (koppelt aan de Tweede Kamer) |
overheidrg:inwerkingtredingDatum | date | cvdr: datum inwerkingtreding (en uitwerkingtredingDatum) |
overheidbwb:geldigheidsperiode_startdatum | date | bwb: begin van de geldende versie (en _einddatum) |
Toon alle 14
| Naam | Type | Betekenis |
|---|---|---|
enrichedData/url | uri | oep: link naar de publicatie op zoek.officielebekendmakingen.nl |
enrichedData/publicatieurl_xml | uri | cvdr/bwb: de XML van de tekst op repository.officiele-overheidspublicaties.nl |
Limieten en valkuilen
- oep: maximumRecords hoogstens 1.000 (daarboven de melding "maximumRecords is 1000"). cvdr gaf met 5.000 gewoon alle 1.461 treffers. getest
- Geen gedocumenteerde rate limit. Tellingen met maximumRecords=0 zijn snel en klein (ongeveer 500 bytes). getest
- Fouten komen als <diagnostics> met HTTP 200: controleer altijd of er een <numberOfRecords> is. Een onbekende index geeft "Unsupported Parameter", ook cql.allRecords bij oep en sc. getest
- Zoek op publicationname, niet op w.publicatienaam, en op dcterms.modified, niet dt.modified. Bij sc heet de maker authority (authority=="Tilburg"); dcterms.creator geeft daar een fout. getest
- == en = gaven hetzelfde; exact gaf 0 treffers waar adj er 647 vond. Waarden van dcterms.type zijn kleine letters ("andere vergunning"). getest
- In cvdr is elke versie van een regeling een record (CVDR102368_1, _2 …): tel unieke regelingen op het deel voor de underscore. getest
- De teksten van cvdr en bwb staan als XML op repository.officiele-overheidspublicaties.nl (geen robots.txt, 404). De SRU 2.0-adressen (repository.overheid.nl/sru, zoekservice.overheid.nl/sru) sluiten in robots.txt alles uit. getest
- De explain-respons zegt zelf: "In de loop van 2021 zal alleen nog SRU versie 2.0 ondersteund worden." Op 16 oktober 2026 werkte 1.2 nog; reken op een overstap. getest
Probeer het HTTP 200 · 436 ms · 16 okt
https://zoekdienst.overheid.nl/sru/Search?version=1.2&operation=searchRetrieve&x-connection=oep&startRecord=1&maximumRecords=2&query=dcterms.creator%3D%3D"Utrecht" sortby dcterms.available%2Fdescending
<?xml version="1.0" encoding="UTF-8"?><searchRetrieveResponse xmlns="http://www.loc.gov/zing/srw/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:overheid="http://standaarden.overheid.nl/owms/terms/" xmlns:overheidproduct="http://standaarden.overheid.nl/product/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.loc.gov/zing/srw/ srw-types.xsd"><version>1.2</version><numberOfRecords>98572</numberOfRecords><records><record><recordSchema>http://standaarden.overheid.nl/sru/</recordSchema><recordPacking>xml</recordPacking><recordData><gzd xmlns="http://standaarden.overheid.nl/sru" xmlns:overheidop="http://standaarden.overheid.nl/product/terms/" xmlns:overheidtr="http://standaarden.overheid.nl/tr/meta/" xmlns:overheidvb="http://standaarden.overheid.nl/vb/terms" xmlns:overheidvd="http://standaarden.overheid.nl/vd/meta/" xsi:schemaLocation="http://standaarden.overheid.nl/sru gzd.xsd"><originalData><overheidop:meta><overheidop:owmskern><dcterms:title>Ontvangen aanvraag voor een omgevingsvergunning overige wegactiviteit - N201 hm 64.3, N402 hm 9.7 t/m hm 9.9, N403 hm 0.1 t/m hm 0.3 in Vreeland en Loenen aan de Vecht</dcterms:title><dcterms:identifie
Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.
Gelezen uit explain: de zoekbare indexen (47) en welke sorteerbaar zijn (ZeeRex-XML) · Recordschema gzd (gzd.xsd) en de SRU-schema's van de Library of Congress · De SRU/CQL-standaard zelf. Labels: uit de beschrijving staat in wat de api zelf publiceert. getest uit onze eigen kleine aanroep. platform geldt voor elk api van dit platform, volgens de documentatie. ervaring zelf ondervonden bij het bouwen van open data index.
Zo haal je het op
curl "https://zoekdienst.overheid.nl/sru/Search?version=1.2&operation=searchRetrieve&x-connection=oep&startRecord=1&maximumRecords=5&query=dcterms.creator%3D%3D%22Utrecht%22%20and%20dcterms.available%3E%3D2026-10-01"
Meer in dit thema
Bekijk hoe deze pagina is opgebouwd
bron: overheid-sru
blokken: []
secties:
- ideeen
- verwerken
- koppelingen
- vergelijkbaar
- beperkingen
- code
cache:
tag: bron:overheid-sru
ververs: na statuscheck, als de bron nieuwer is
statuscheck:
methode: laatste dag met officiële publicaties (collectie oep, aantal per
publicatiedatum)
verwacht: dagelijks
Bron: content/bronnen/overheid-sru.yaml · Markdown