data.europa.eu

Base URL

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

Endpoints 6

• POST/searchSearch and count with a JSON body: q, filters (dataset, catalogue …), facets (country, catalog, format, license, is_hvd …), page, sort. Response: result.count, results and facets with counts.
• GET/datasets/{id}One dataset: title and description in all EU languages, publisher, catalogue, distributions (format, access_url, licence), keywords, quality measurements.
• GET/cataloguesList of all 213 catalogue ids.
• GET/catalogues/{id}One catalogue with title, country, publisher, homepage, number of datasets (count) and modified. Netherlands: dataportaal-van-de-nederlandse-overheid, ngr-nl, nsip-nl.
• POSThttps://data.europa.eu/sparqlSPARQL over the whole catalogue (DCAT-AP). Query as form field query, answer with Accept: application/sparql-results+json.
• GET/openapi.yamlThe OpenAPI description (also scroll, feeds per dataset, vocabularies).

Filtering from the description

JSON body with q (free text), filters (document type) and facets (field → list of values). Several values within a facet = OR, facets combined = AND (facetOperator, facetGroupOperator).

Parameters 10

Fields in the search response 10

Limits and pitfalls

• No key and no documented request limit. A response with all facets is large (600 kB for limit 0): set aggregation to false or name aggregationFields. tested
• Keep it small: includes ["id"] plus aggregationFields turns a count with two facets into 5 kB instead of 500 kB. tested
• robots.txt forbids /*search?* and /*?query=*, i.e. GET /api/hub/search/search?q=… and GET /sparql?query=…. Use the documented POST variants; /datasets/{id} and /catalogues may use GET. tested
• In the POST body, limit 0, 1 and 50 always returned 10 results (16 Oct 2026); page does work. Counts and facets are correct; for large lists use SPARQL or the original source. tested
• Duplicates: data.overheid.nl harvests the NGR itself, and data.europa.eu harvests both. NL counted 30,132 datasets: data.overheid.nl 19,363, ngr-nl 9,333, nsip-nl 1,436. Don't simply add them up. tested
• Licences come as URIs: http://creativecommons.org/licenses/by/4.0/deed.nl (9,117 NL datasets), CC0 (5,954), Public Domain Mark (4,000), licence unknown (665). tested
• Metadata only: downloads go to the original publisher (access_url). tested
• SPARQL counts dcat:dataset per catalogue quickly (ngr-nl: 9,330 in 0.1 s), slightly different from the search facet (9,333). tested

Try it HTTP 200 · 332 ms · 16 Oct

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"
          },

Shortened response, saved at harvest time. Click the URL for the real, current response.