data.overheid.nl

Basisadres

https://data.overheid.nl/data/api/3/action

Endpoints 9

• GET/package_searchZoeken en filteren in alle datasets (Solr), met facetten, sorteren en pagineren. Het belangrijkste endpoint.
• GET/package_show?id={name}Eén dataset volledig: beschrijving, eigenaar, contactpunt, licentie, thema's, trefwoorden en alle resources (bestanden en diensten). Onbekende naam: 404.
• GET/resource_show?id={resource-id}Eén resource (bestand of dienst) met url, formaat en datums.
• GET/package_listAlle datasetnamen in één lijst (20.811 op 16 okt 2026, iets meer dan package_search telt).
• GET/organization_listOrganisaties (de oogstgroepen, niet de eigenaren). Gaf 33 namen; met all_fields=true hoogstens 25 per keer, verder met offset.
• GET/organization_show?id={name}Eén organisatie met beschrijving en aantal datasets.
• GET/tag_listAlle trefwoorden (10.421).
• GET/license_listDe licenties die het portaal kent (8).
• GET/status_showCKAN-versie en geïnstalleerde extensies.

Filteren getest

Solr/Lucene in q en fq: veld:waarde, URI's tussen dubbele aanhalingstekens, bereiken met [van TO tot] (* = open), AND/OR/NOT en haakjes, - voor uitsluiten. Spaties in de URL coderen (%20), anders faalt de aanroep.

Parameters 9

Velden van een dataset (package_show) 17

Limieten en valkuilen

• rows hoogstens 1.000 per aanroep; pagineer met start. Geen gedocumenteerde rate limit; wij halen alle 20.799 in 21 aanroepen met fl. getest
• Zonder fl zijn 1.000 rijen ruim 8 MB (volledige records met resources). getest
• De eigenaar staat in authority, niet in organization. organization is de oogstgroep: 7.754 datasets zitten in nationaalgeoregister-nl, ongeacht wie ze maakte. getest
• Het facet theme is getokeniseerde tekst (owm, nl, http …) en onbruikbaar. authority, source_catalog, res_format, license_id, access_rights, high_value en basis_register zijn schone facetten. getest
• Niet alles is open: 1.484 datasets hebben access_rights NON_PUBLIC en 717 RESTRICTED (o.a. CBS-microdata via ODISSEI), 1.499 hebben de licentie geslotenlicentie. getest
• data.overheid.nl oogst zelf andere catalogi (source_catalog): het NGR (7.754), CBS (5.989) en gemeenteportalen. Dezelfde dataset staat dus vaak ook in die bron; het NGR-uuid zit in identifier. getest
• Pagineer op sort=name asc, niet op metadata_modified desc: een dataset die tijdens het ophalen wijzigt schuift anders naar pagina 1 en mis je. De volgorde van name asc is vast maar niet alfabetisch. ervaring
• metadata_modified verandert ook bij heroogsten zonder inhoudelijke wijziging; gebruik het niet als versheid van de data zelf. ervaring
• robots.txt van data.overheid.nl verbiedt /data/, waar de API zit. Wij lezen alleen metadata, met een eerlijke user-agent en lage frequentie (afweging Lucas, zie leerpunten). ervaring
• Facetwaarden komen niet op aantal gesorteerd terug in facets; gebruik search_facets (met count per item) en sorteer zelf. getest

Probeer het HTTP 200 · 346 ms · 16 okt

https://data.overheid.nl/data/api/3/action/package_search?rows=3&fl=name,title,authority,metadata_modified&fq=high_value:true&sort=metadata_modified desc

{
  "help": "https://data.overheid.nl/data/api/3/action/help_show?name=package_search",
  "success": true,
  "result": {
    "count": 138,
    "sort": "metadata_modified desc",
    "facets": {},
    "results": [
      {
        "authority": "http://standaarden.overheid.nl/owms/terms/Utrecht_(gemeente)",
        "name": "utrecht-weekoverzicht-woo-verzoeken",
        "metadata_modified": "2026-10-14T15:29:52.466Z",
        "title": "Weekoverzicht Woo-verzoeken"
      },
      {
        "authority": "http://standaarden.overheid.nl/owms/terms/Utrecht_(gemeente)",
        "name": "utrecht-meldingen-straatfeest-2026-1",
        "metadata_modified": "2026-10-12T12:26:30.053Z",
        "title": "Meldingen straatfeest 2026"
      }
    ],
    "search_facets": {}
  }
}

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.