data.europa.eu

Basisadres

https://data.europa.eu/api/hub/search

Endpoints 6

• POST/searchZoeken en tellen met een JSON-body: q, filters (dataset, catalogue …), facets (country, catalog, format, license, is_hvd …), page, sort. Antwoord: result.count, results en facetten met tellingen.
• GET/datasets/{id}Eén dataset: titel en beschrijving in alle EU-talen, uitgever, catalogus, distributies (formaat, access_url, licentie), trefwoorden, kwaliteitsmetingen.
• GET/cataloguesLijst van alle 213 catalogus-id's.
• GET/catalogues/{id}Eén catalogus met titel, land, uitgever, homepage, aantal datasets (count) en modified. Nederland: dataportaal-van-de-nederlandse-overheid, ngr-nl, nsip-nl.
• POSThttps://data.europa.eu/sparqlSPARQL over de hele catalogus (DCAT-AP). Vraag als formulierveld query, antwoord met Accept: application/sparql-results+json.
• GET/openapi.yamlDe OpenAPI-beschrijving (ook scroll, feeds per dataset, vocabularies).

Filteren uit de beschrijving

JSON-body met q (vrije tekst), filters (soort document) en facets (veld → lijst van waarden). Meer waarden binnen een facet = OF, facetten onderling = EN (facetOperator, facetGroupOperator).

Parameters 10

Velden in het zoekantwoord 10

Limieten en valkuilen

• Geen sleutel en geen gedocumenteerde aanvraaglimiet. Een antwoord met alle facetten is groot (600 kB voor limit 0): zet aggregation op false of noem aggregationFields. getest
• Klein houden: includes ["id"] plus aggregationFields maakt een telling met twee facetten 5 kB in plaats van 500 kB. getest
• robots.txt verbiedt /*search?* en /*?query=*, dus GET /api/hub/search/search?q=… en GET /sparql?query=…. Gebruik de POST-varianten uit de documentatie; /datasets/{id} en /catalogues mogen met GET. getest
• In de POST-body gaf limit 0, 1 en 50 steeds 10 resultaten terug (16 okt 2026); page werkt wel. Tellen en facetten kloppen; voor grote lijsten SPARQL of de bron zelf gebruiken. getest
• Dubbel: data.overheid.nl oogst zelf het NGR, en data.europa.eu oogst beide. NL telde 30.132 datasets: data.overheid.nl 19.363, ngr-nl 9.333, nsip-nl 1.436. Niet zomaar optellen. getest
• Licenties komen als URI: http://creativecommons.org/licenses/by/4.0/deed.nl (9.117 NL-datasets), CC0 (5.954), Public Domain Mark (4.000), licentieonbekend (665). getest
• Alleen metadata: downloads gaan naar de oorspronkelijke uitgever (access_url). getest
• SPARQL telt dcat:dataset per catalogus snel (ngr-nl: 9.330 in 0,1 s), iets anders dan het zoekfacet (9.333). getest

Probeer het HTTP 200 · 332 ms · 16 okt

curl -X POST "https://data.europa.eu/api/hub/search/search" \
  -d '{"filters":["dataset"],"limit":0,"facets":{"country":["nl"]},"includes":["id"],"aggregationAllFields":false,"aggregationFields":["catalog","license"]}'

{
  "result": {
    "index": "dataset",
    "count": 30132,
    "results": [
      {
        "index": "dataset",
        "id": "12788-hoogtegegevens-oosterschelde-2m-grid-2019-dtm"
      },
      {
        "index": "dataset",
        "id": "5049-jongeren-met-n-of-meerdere-vormen-van-jeugdzorg-in-natura-peildatum"
      }
    ],
    "facets": [
      {
        "id": "catalog",
        "title": "Catalogues",
        "items": [
          {
            "count": 19363,
            "id": "dataportaal-van-de-nederlandse-overheid",
            "title": "Dataportaal van de Nederlandse overheid"
          },
          {
            "count": 9333,
            "id": "ngr-nl",
            "title": "Nationaal Georegister van Nederland"
          }
        ]
      },
      {
        "id": "license",
        "title": "Licenses",
        "items": [
          {
            "count": 9117,
            "id": "http://creativecommons.org/licenses/by/4.0/deed.nl",
            "title": "http://creativecommons.org/licenses/by/4.0/deed.nl"
          },

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