# data.europa.eu

> Search and read data.europa.eu, the European Union's official open data portal: about 1.9 million datasets from the EU institutions and the national, regional and geospatial portals of 36 countries, in every EU language. Find datasets by words, country, catalogue, theme, format, licence or date, read one in full with its download links and licences, see what was added lately or get a workflow run when a new dataset appears, break datasets down by format or licence, and check a catalogue's metadata quality or what a licence allows. No account or API key required.

App · 10 actions. Web page: https://docs.lodol.com/docs/integrations/data-europa

## Actions

### Break down datasets

Count how many datasets on data.europa.eu carry each country, catalogue, data theme, file format, licence, publisher, keyword or high-value category, for all datasets or those matching words and filters, most first. Answers questions such as which formats air quality data comes in, or which licences a country uses.

**Inputs**

- Break down by (`group_by`, text, required): What to count the datasets by. One of: `country`, `catalogue`, `theme` (Data theme), `format` (File format), `licence`, `publisher`, `keyword`, `high_value_category` (High-value dataset category).
- Search words (`query`, text): Words to look for in titles, descriptions and keywords, in any EU language. Leave empty to list everything the filters match.
- Country (`country`, text): Only datasets from this country's catalogues. Pick one, or type its two-letter code (de) or name (Germany); EUROPE means the EU institutions and Europe-wide catalogues.
- Catalogue (`catalogue`, text): Only datasets from this catalogue: a national portal such as GovData, an EU institution such as Eurostat, or a geoportal. Pick one, or type its id or name. 'List catalogues' lists them.
- Data theme (`theme`, text): Only datasets filed under this EU data theme, such as Environment or Transport. Pick one, or type its code (ENVI) or name.
- File format (`file_format`, text): Only datasets with a file in this format, such as CSV, JSON or XLSX. Pick one, or type it.
- Licence (`licence`, text): Only datasets with a file under this licence. Pick one of the licences the portal's datasets use most, or type its code (CC_BY_4_0) or the link a publisher gives.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.
- Most values (`limit`, number): How many values to list, 1 to 250, most datasets first. Defaults to 50. From 1 to 250.

**Outputs**

- `count` (number): How many values are listed.
- `group_by` (text): What the datasets were grouped by: country, catalogue, theme, format, licence, publisher, keyword or high_value_category.
- `summary` (text): One line describing the result.
- `total` (number): How many datasets match in all.
- `value_count` (number): How many different values the portal reported (at most 250).
- `values` (list): The values, most datasets first.

**Example output**

```json
{
  "count": 3,
  "group_by": "format",
  "summary": "17,079 datasets matching 'air quality' from France by file format: 12 values, showing the top 3. Most: WMS (2,572), CSV (1,804), WFS (1,289).",
  "total": 17079,
  "value_count": 12,
  "values": [
    {
      "count": 2572,
      "label": "WMS",
      "share_percent": 15.1,
      "value": "WMS_SRVC"
    },
    {
      "count": 1804,
      "label": "CSV",
      "share_percent": 10.6,
      "value": "CSV"
    },
    {
      "count": 1289,
      "label": "WFS",
      "share_percent": 7.5,
      "value": "WFS_SRVC"
    }
  ]
}
```

### Get a catalogue

Get one catalogue on data.europa.eu: its name and description, country, the organisation that runs it, its website and how many datasets the portal holds from it. A catalogue that isn't there comes back as found: false.

**Inputs**

- Catalogue (`catalogue`, text, required): The catalogue: pick one, or type its id (govdata) or name (GovData). 'List catalogues' lists them.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.

**Outputs**

- `country` (text): The country it comes from, as a two-letter code (de), or EUROPE for the EU institutions and Europe-wide catalogues.
- `country_name` (text): The country's name, such as Germany.
- `dataset_count` (number): How many datasets the portal holds from it.
- `description` (text): Its description in the chosen language.
- `found` (true/false): True when the portal has it. False means nothing by that id or name; the summary says what to check.
- `homepage` (text): The catalogue's own website.
- `id` (text): The catalogue's id, such as govdata, which filters take.
- `issued` (text): When the portal started harvesting it.
- `language` (text): The language the title and description are in (en, de...): the one asked for when the portal has it, else English, else the publisher's own.
- `languages` (list): The languages it publishes in.
- `modified` (text): When its description last changed.
- `part_of` (text): The larger catalogue it belongs to, such as erpd (the European register of protected data), when it is part of one.
- `publisher` (text): The organisation that runs it.
- `publisher_url` (text): That organisation's website.
- `source_type` (text): How the portal harvests it: dcat-ap, ckan, geospatial, inspire, udata, socrata or euodp-legacy.
- `summary` (text): One line describing the result.
- `title` (text): Its name in the chosen language.
- `url` (text): Its page on data.europa.eu.

**Example output**

```json
{
  "country": "de",
  "country_name": "Germany",
  "dataset_count": 169109,
  "description": "Open Data Portal Germany",
  "found": true,
  "homepage": "https://www.govdata.de",
  "id": "govdata",
  "issued": "2022-11-21T05:38:24Z",
  "language": "en",
  "languages": [
    "German"
  ],
  "modified": "2023-02-12T00:17:44Z",
  "part_of": null,
  "publisher": "GKSt GovData Freie und Hansestadt Hamburg",
  "publisher_url": "https://www.govdata.de",
  "source_type": "dcat-ap",
  "summary": "GovData (Germany): 169,109 datasets on data.europa.eu, run by GKSt GovData Freie und Hansestadt Hamburg.",
  "title": "GovData",
  "url": "https://data.europa.eu/data/catalogues/govdata?locale=en"
}
```

### Get a dataset

Get one dataset from data.europa.eu in full: its title and description in the language you choose, publisher, catalogue, themes, keywords, licences, the period and places it covers, how often it is updated, its quality score, an organisation contact point when there is one, and every distribution with its download or access link, format and licence. A dataset that isn't there comes back as found: false.

**Inputs**

- Dataset (`dataset`, text, required): The dataset's id, such as the id a search returned, or a link to its page on data.europa.eu.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.

**Outputs**

- `access_rights` (text): Who may access it, such as public or restricted.
- `added_to_portal` (text): When the portal first harvested it, in UTC (YYYY-MM-DDTHH:MM:SSZ).
- `catalogue` (text): The catalogue's name, such as GovData or Eurostat.
- `catalogue_id` (text): The id of the catalogue it was harvested from, such as govdata or estat.
- `contact_points` (list): Contact points the publisher marks as an organisation. Those for a person are left out.
- `country` (text): The country it comes from, as a two-letter code (de), or EUROPE for the EU institutions and Europe-wide catalogues.
- `country_name` (text): The country's name, such as Germany.
- `dataset_type` (text): What kind of data it is, such as Statistical data.
- `description` (text): Its full description in the chosen language.
- `distribution_count` (number): How many distributions it has.
- `distributions` (list): Every distribution, with its links, format and licence.
- `documentation` (list): Links to its documentation.
- `formats` (list): The file formats of its distributions, such as CSV or Excel XLSX.
- `found` (true/false): True when the portal has it. False means nothing by that id or name; the summary says what to check.
- `high_value_categories` (list): The EU high-value dataset categories it belongs to, such as Statistics.
- `id` (text): The dataset's id on data.europa.eu, which 'Get a dataset' and 'List a dataset's distributions' take.
- `identifiers` (list): Its identifiers from the publisher, such as a code or a DOI.
- `is_high_value` (true/false): True when it is one of the EU's high-value datasets, which public bodies must publish free and machine-readable.
- `issued` (text): When the publisher first released it: a date (YYYY-MM-DD) or a UTC time.
- `keywords` (list): Its keywords: those in the chosen language when it has any, else all of them.
- `landing_pages` (list): The dataset's own pages on the publisher's website.
- `language` (text): The language the title and description are in (en, de...): the one asked for when the portal has it, else English, else the publisher's own.
- `licences` (list): Every licence its distributions are released under, each once. The data is reused under these terms; 'Get licence terms' says what each allows.
- `machine_translated` (true/false): True when the title and description were machine-translated by the portal, false when the publisher wrote them in this language.
- `modified` (text): When the publisher last changed it: a date (YYYY-MM-DD) or a UTC time.
- `original_language` (text): The language the publisher wrote it in.
- `publisher` (text): The organisation that publishes it.
- `publisher_url` (text): The publisher's website.
- `quality_score` (number): The portal's metadata quality score for the record (higher is better), when it has been assessed.
- `spatial_coverage` (list): The places the data covers, such as Germany.
- `summary` (text): One line describing the result.
- `temporal_coverage` (list): The periods the data covers.
- `themes` (list): The EU data themes it is filed under.
- `title` (text): The dataset's title in the chosen language.
- `update_frequency` (text): How often the publisher updates it, such as annual or monthly.
- `updated_on_portal` (text): When the portal last updated its record, in UTC.
- `uri` (text): The dataset's permanent identifier (a URI) on the portal.
- `url` (text): The dataset's page on data.europa.eu, in the chosen language.

**Example output**

```json
{
  "access_rights": "public",
  "added_to_portal": "2026-02-06T11:44:55Z",
  "catalogue": "Eurostat",
  "catalogue_id": "estat",
  "contact_points": [],
  "country": "EUROPE",
  "country_name": "EU institutions and Europe-wide",
  "dataset_type": "Statistical data",
  "description": "Unemployed persons as a percentage of the labour force. The labour force is the total number of people employed and unemployed. Unemployed persons are persons aged 15 to 74 who were without work during the reference week, were available for work and were actively seeking work. Data available as rates (% of population in the labour force, % of the total population) and in absolute numbers (1000 persons).",
  "distribution_count": 5,
  "distributions": [
    {
      "access_url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/dataflow/ESTAT/tps00203?references=descendants&detail=referencepartial&format=sdmx_2.1_generic&compressed=true",
      "availability": null,
      "byte_size": 9318,
      "description": null,
      "documentation": [],
      "download_url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/dataflow/ESTAT/tps00203?references=descendants&detail=referencepartial&format=sdmx_2.1_generic&compressed=true",
      "format": "XML",
      "id": "301aff87-de7a-4b44-a765-b38b0e5cf5be",
      "issued": null,
      "languages": [],
      "licence": "Creative Commons Attribution 4.0 International",
      "licence_id": "CC_BY_4_0",
      "licence_url": "http://spdx.org/licenses/CC-BY-4.0",
      "media_type": "application/xml",
      "modified": null,
      "service_url": null,
      "status": null,
      "title": "Download metadata in SDMX 2.1 format",
      "url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/dataflow/ESTAT/tps00203?references=descendants&detail=referencepartial&format=sdmx_2.1_generic&compressed=true"
    },
    {
      "access_url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/tps00203?format=sdmx_2.1_structured&compressed=true",
      "availability": null,
      "byte_size": 5901,
      "description": null,
      "documentation": [],
      "download_url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/tps00203?format=sdmx_2.1_structured&compressed=true",
      "format": "XML",
      "id": "cc35e874-ab46-4bfd-beee-5504d1643b67",
      "issued": null,
      "languages": [],
      "licence": "Creative Commons Attribution 4.0 International",
      "licence_id": "CC_BY_4_0",
      "licence_url": "http://spdx.org/licenses/CC-BY-4.0",
      "media_type": "application/xml",
      "modified": null,
      "service_url": null,
      "status": null,
      "title": "Download dataset in SDMX 2.1 format",
      "url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/tps00203?format=sdmx_2.1_structured&compressed=true"
    }
  ],
  "documentation": [
    "https://ec.europa.eu/eurostat/cache/metadata/en/lfsi_esms.htm",
    "https://ec.europa.eu/eurostat/api/dissemination/files?file=metadata/lfsi_esms.sdmx.zip",
    "https://ec.europa.eu/eurostat/web/user-guides/data-browser",
    "https://ec.europa.eu/eurostat/databrowser/product/page/tps00203"
  ],
  "formats": [
    "HTML",
    "XML",
    "TSV",
    "CSV"
  ],
  "found": true,
  "high_value_categories": [],
  "id": "5wwzzynxik3astazdxagg",
  "identifiers": [
    "tps00203",
    "https://doi.org/10.2908/TPS00203"
  ],
  "is_high_value": false,
  "issued": "2017-12-05",
  "keywords": [
    "Age class",
    "Geopolitical entity (reporting)",
    "Time frequency",
    "Unit of measure",
    "Sex"
  ],
  "landing_pages": [
    "https://ec.europa.eu/eurostat/databrowser/product/page/tps00203"
  ],
  "language": "en",
  "licences": [
    {
      "id": "CC_BY_4_0",
      "name": "Creative Commons Attribution 4.0 International",
      "url": "http://spdx.org/licenses/CC-BY-4.0"
    }
  ],
  "machine_translated": false,
  "modified": "2026-10-26",
  "original_language": "en",
  "publisher": "Eurostat",
  "publisher_url": "https://commission.europa.eu/about/departments-and-executive-agencies/eurostat-european-statistics",
  "quality_score": 550,
  "spatial_coverage": [
    "Latvia",
    "Lithuania",
    "Hungary",
    "Germany",
    "Czechia"
  ],
  "summary": "Unemployment rate by Eurostat (EU institutions and Europe-wide): 5 distributions (HTML, XML, TSV, CSV), licence Creative Commons Attribution 4.0 International. Last modified 2026-10-26.",
  "temporal_coverage": [
    {
      "end": "2025-12-31",
      "start": "2014-01-01"
    }
  ],
  "themes": [
    {
      "code": "SOCI",
      "name": "Population and society"
    },
    {
      "code": "HEAL",
      "name": "Health"
    },
    {
      "code": "JUST",
      "name": "Justice, legal system and public safety"
    }
  ],
  "title": "Unemployment rate",
  "update_frequency": "annual",
  "updated_on_portal": "2026-10-27T09:03:43Z",
  "uri": "http://data.europa.eu/88u/dataset/5wwzzynxik3astazdxagg",
  "url": "https://data.europa.eu/data/datasets/5wwzzynxik3astazdxagg?locale=en"
}
```

### Get licence terms

Look up a licence in the EU licence list data.europa.eu uses, by code, name or link (such as a distribution's licence), and see what its licensing assistant records: whether commercial use is allowed, whether you must credit the source or share alike, and what it permits and forbids. A licence not on the list comes back as found: false.

**Inputs**

- Licence (`licence`, text, required): The licence: pick one, or give its code (CC_BY_4_0), name (CC BY 4.0) or link, such as a distribution's licence_url.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.

**Outputs**

- `adaptations_allowed` (true/false): Whether you may adapt it.
- `attribution_required` (true/false): Whether you must credit the source.
- `changes_must_be_marked` (true/false): Whether you must say what you changed.
- `commercial_use_allowed` (true/false): Whether it allows commercial use.
- `covers_database_rights` (true/false): Whether it also licenses the EU database right.
- `found` (true/false): True when the licence is on the EU licence list the portal uses.
- `has_terms` (true/false): True when the portal's licensing assistant records its terms; the fields that follow are empty when it does not.
- `id` (text): Its code in the EU licence list, such as CC_BY_4_0.
- `legal_text_url` (text): A link to the licence's legal text.
- `matched_by` (text): How it was recognised: code, link or name.
- `name` (text): Its name in the chosen language.
- `permissions` (list): What it lets you do, in words.
- `prohibitions` (list): What it forbids, in words.
- `query` (text): The licence as it was given.
- `redistribution_allowed` (true/false): Whether you may share it.
- `requirements` (list): What it asks of you, in words.
- `share_alike_required` (true/false): Whether adaptations must be shared under the same licence.
- `short_name` (text): Its short name, such as CC BY 4.0.
- `summary` (text): One line describing the result.
- `uri` (text): Its identifier in the EU licence list.

**Example output**

```json
{
  "adaptations_allowed": true,
  "attribution_required": true,
  "changes_must_be_marked": true,
  "commercial_use_allowed": true,
  "covers_database_rights": true,
  "found": true,
  "has_terms": true,
  "id": "CC_BY_4_0",
  "legal_text_url": "http://creativecommons.org/licenses/by/4.0/legalcode",
  "matched_by": "code",
  "name": "Creative Commons Attribution 4.0 International",
  "permissions": [
    "copy it",
    "share it",
    "adapt it",
    "sublicense it"
  ],
  "prohibitions": [
    "using the licensor's trademarks"
  ],
  "query": "CC_BY_4_0",
  "redistribution_allowed": true,
  "requirements": [
    "credit the source",
    "keep the licence notice",
    "say what you changed"
  ],
  "share_alike_required": false,
  "short_name": "CC BY 4.0",
  "summary": "Creative Commons Attribution 4.0 International (CC_BY_4_0): you may copy it, share it, adapt it and sublicense it; you must credit the source, keep the licence notice and say what you changed; it forbids using the licensor's trademarks. Commercial use is allowed.",
  "uri": "http://publications.europa.eu/resource/authority/licence/CC_BY_4_0"
}
```

### Get metadata quality

Get data.europa.eu's metadata quality assessment of a catalogue, a country or the whole portal: its score, how many records were assessed, how well it does on findability, accessibility, interoperability and reusability, and the share of files with a licence, a known licence, a working link or a machine-readable format. Leave both fields empty for the whole portal.

**Inputs**

- Catalogue (`catalogue`, text): The catalogue to assess. Pick one, or type its id or name. Leave empty to assess a country or the whole portal.
- Country (`country`, text): The country to assess, instead of a catalogue. The portal assesses about 30 countries.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.

**Outputs**

- `access_link_works_percent` (number): Share of the assessed distributions whose access link works, in percent, when assessed.
- `assessed_on` (text): When the assessment was made (YYYY-MM-DD).
- `contact_point_given_percent` (number): Share of the assessed datasets with a contact point, in percent, when assessed.
- `data_services_assessed` (number): How many data services were assessed.
- `datasets_assessed` (number): How many datasets were assessed.
- `dimensions` (list): The FAIR dimensions: how much of each one's checks the datasets and distributions meet, weighted as the portal weighs them.
- `distributions_assessed` (number): How many distributions were assessed.
- `download_link_given_percent` (number): Share of the assessed distributions with a download link, in percent, when assessed.
- `found` (true/false): True when the portal has it. False means nothing by that id or name; the summary says what to check.
- `id` (text): The catalogue's id or the country's code.
- `known_licence_percent` (number): Share of the assessed distributions whose licence is on the EU list, in percent, when assessed.
- `licence_given_percent` (number): Share of the assessed distributions that name a licence, in percent, when assessed.
- `machine_readable_percent` (number): Share of the assessed distributions in a machine-readable format, in percent, when assessed.
- `max_score` (number): The highest score possible (7.5).
- `metrics` (list): Every check the portal makes, with how many records pass it.
- `name` (text): The catalogue's or country's name.
- `non_proprietary_percent` (number): Share of the assessed distributions in a non-proprietary format, in percent, when assessed.
- `scope` (text): What was assessed: catalogue, country or portal.
- `score` (number): The overall score.
- `score_percent` (number): The score as a percentage of the highest.
- `summary` (text): One line describing the result.

**Example output**

```json
{
  "access_link_works_percent": 72.3,
  "assessed_on": "2026-10-18",
  "contact_point_given_percent": 100.0,
  "data_services_assessed": 0,
  "datasets_assessed": 2563,
  "dimensions": [
    {
      "coverage_percent": 77.9,
      "dimension": "Reusability"
    },
    {
      "coverage_percent": 72.0,
      "dimension": "Findability"
    },
    {
      "coverage_percent": 91.4,
      "dimension": "Accessibility"
    },
    {
      "coverage_percent": 87.7,
      "dimension": "Interoperability"
    }
  ],
  "distributions_assessed": 9920,
  "download_link_given_percent": 78.7,
  "found": true,
  "id": "estat",
  "known_licence_percent": 99.3,
  "licence_given_percent": 99.3,
  "machine_readable_percent": 58.9,
  "max_score": 7.5,
  "metrics": [
    {
      "applies_to": "dataset",
      "check": "Contact point given",
      "coverage_percent": 100.0,
      "dimension": "Reusability",
      "evaluated": 2563,
      "importance": "Recommended",
      "metric": "contactPointAvailability"
    },
    {
      "applies_to": "distribution",
      "check": "Access link works",
      "coverage_percent": 72.3,
      "dimension": "Accessibility",
      "evaluated": 9855,
      "importance": "Optional",
      "metric": "accessUrlStatusCode"
    },
    {
      "applies_to": "distribution",
      "check": "Licence given",
      "coverage_percent": 99.3,
      "dimension": "Reusability",
      "evaluated": 9920,
      "importance": "Recommended",
      "metric": "licenceAvailability"
    },
    {
      "applies_to": "distribution",
      "check": "Licence from the EU vocabulary",
      "coverage_percent": 99.3,
      "dimension": "Reusability",
      "evaluated": 9920,
      "importance": "Recommended",
      "metric": "knownLicence"
    },
    {
      "applies_to": "data service",
      "check": "Licence given",
      "coverage_percent": null,
      "dimension": "Reusability",
      "evaluated": 0,
      "importance": "Optional",
      "metric": "licenceAvailability"
    },
    {
      "applies_to": "data service",
      "check": "Licence from the EU vocabulary",
      "coverage_percent": null,
      "dimension": "Reusability",
      "evaluated": 0,
      "importance": "Optional",
      "metric": "knownLicence"
    }
  ],
  "name": "Eurostat",
  "non_proprietary_percent": 99.1,
  "scope": "catalogue",
  "score": 5.95,
  "score_percent": 79.3,
  "summary": "Eurostat: metadata quality 5.95 of 7.5 (79.3%), from 2,563 datasets assessed on 2026-10-18. Licence given for 99.3% of files; 99.3% use a licence from the EU list; 72.3% of access links work."
}
```

### List a dataset's distributions

List the distributions of a dataset on data.europa.eu: the files and services it is published as, each with its download or access link, format, size and licence, optionally only those in one format such as CSV. Use the links to fetch the data in a later step.

**Inputs**

- Dataset (`dataset`, text, required): The dataset's id, such as the id a search returned, or a link to its page on data.europa.eu.
- File format (`file_format`, text): Only distributions in this format, such as CSV, JSON or text/csv. Leave empty for all.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed (those in the format asked for).
- `distributions` (list): The distributions.
- `found` (true/false): True when the portal has it. False means nothing by that id or name; the summary says what to check.
- `id` (text): The dataset's id on data.europa.eu, which 'Get a dataset' and 'List a dataset's distributions' take.
- `summary` (text): One line describing the result.
- `title` (text): The dataset's title in the chosen language.
- `total` (number): How many distributions the dataset has in all.
- `url` (text): The dataset's page on data.europa.eu, in the chosen language.

**Example output**

```json
{
  "count": 1,
  "distributions": [
    {
      "access_url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/tps00203?format=SDMX-CSV&compressed=true",
      "availability": null,
      "byte_size": 7174,
      "description": null,
      "documentation": [],
      "download_url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/tps00203?format=SDMX-CSV&compressed=true",
      "format": "CSV",
      "id": "8dd8d691-4194-43d3-9670-326205ddca16",
      "issued": null,
      "languages": [],
      "licence": "Creative Commons Attribution 4.0 International",
      "licence_id": "CC_BY_4_0",
      "licence_url": "http://spdx.org/licenses/CC-BY-4.0",
      "media_type": "text/csv",
      "modified": null,
      "service_url": null,
      "status": null,
      "title": "Download dataset in SDMX-CSV format",
      "url": "https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/tps00203?format=SDMX-CSV&compressed=true"
    }
  ],
  "found": true,
  "id": "5wwzzynxik3astazdxagg",
  "summary": "Unemployment rate: 1 distribution (CSV).",
  "title": "Unemployment rate",
  "total": 5,
  "url": "https://data.europa.eu/data/datasets/5wwzzynxik3astazdxagg?locale=en"
}
```

### List catalogues

List the catalogues data.europa.eu harvests: the national open data portals of 36 countries, regional and geospatial portals, and the EU institutions and agencies, each with its id, country, operator and how many datasets it holds, most first. Optionally only one country's, or those matching words.

**Inputs**

- Country (`country`, text): Only this country's catalogues. Pick one, or type its two-letter code (de) or name; EUROPE lists the EU institutions.
- Search words (`query`, text): Only catalogues whose id, name, description or operator contains these words.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.
- Most results (`limit`, number): How many catalogues to list, 1 to 500. Defaults to all. From 1 to 500.

**Outputs**

- `catalogues` (list): The catalogues, most datasets first.
- `count` (number): How many are listed.
- `summary` (text): One line describing the result.
- `total` (number): How many catalogues match.

**Example output**

```json
{
  "catalogues": [
    {
      "country": "ie",
      "country_name": "Ireland",
      "dataset_count": 22885,
      "description": "Open Data Portal Ireland",
      "homepage": "https://data.gov.ie",
      "id": "data-gov-ie",
      "issued": "2022-06-24T12:25:17Z",
      "language": "en",
      "languages": [
        "Irish"
      ],
      "modified": "2023-02-10T20:35:45Z",
      "part_of": null,
      "publisher": "Government Reform Unit, Dept of Public Expenditure & Reform",
      "publisher_url": "https://www.gov.ie/en/organisation/department-of-public-expenditure-and-reform",
      "source_type": "dcat-ap",
      "title": "Data.gov.ie",
      "url": "https://data.europa.eu/data/catalogues/data-gov-ie?locale=en"
    },
    {
      "country": "ie",
      "country_name": "Ireland",
      "dataset_count": 137,
      "description": "National catalogue of Datasets and Data services with non-public or restricted access.",
      "homepage": "https://datacatalogue.gov.ie",
      "id": "nsip-ie",
      "issued": "2024-10-21T10:08:29Z",
      "language": "en",
      "languages": [
        "Irish"
      ],
      "modified": "2025-06-17T08:03:17Z",
      "part_of": "erpd",
      "publisher": "Data Catalogue Government Ireland",
      "publisher_url": "https://datacatalogue.gov.ie",
      "source_type": "ckan",
      "title": "National Single Information Point Ireland",
      "url": "https://data.europa.eu/data/catalogues/nsip-ie?locale=en"
    }
  ],
  "count": 2,
  "summary": "3 catalogues from Ireland holding 23,115 datasets; showing the 2 largest.",
  "total": 3
}
```

### List data themes

List the EU's 14 data themes that datasets on data.europa.eu are filed under, such as Environment or Transport, with their codes, names in the language you choose and how many datasets each holds, for the whole portal or one country or catalogue.

**Inputs**

- Country (`country`, text): Count only this country's datasets. Pick one, or type its two-letter code (de) or name.
- Catalogue (`catalogue`, text): Count only this catalogue's datasets.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.

**Outputs**

- `count` (number): How many themes are listed.
- `summary` (text): One line describing the result.
- `themes` (list): The EU data themes, most datasets first.

**Example output**

```json
{
  "count": 14,
  "summary": "14 data themes. Most datasets: Agriculture, fisheries, forestry and food (267,061), Economy and finance (176,932), Government and public sector (163,607).",
  "themes": [
    {
      "code": "AGRI",
      "dataset_count": 267061,
      "name": "Agriculture, fisheries, forestry and food",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/AGRI"
    },
    {
      "code": "ECON",
      "dataset_count": 176932,
      "name": "Economy and finance",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/ECON"
    },
    {
      "code": "GOVE",
      "dataset_count": 163607,
      "name": "Government and public sector",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/GOVE"
    },
    {
      "code": "ENVI",
      "dataset_count": 158077,
      "name": "Environment",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/ENVI"
    },
    {
      "code": "JUST",
      "dataset_count": 122119,
      "name": "Justice, legal system and public safety",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/JUST"
    },
    {
      "code": "REGI",
      "dataset_count": 116567,
      "name": "Regions and cities",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/REGI"
    },
    {
      "code": "TECH",
      "dataset_count": 116566,
      "name": "Science and technology",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/TECH"
    },
    {
      "code": "SOCI",
      "dataset_count": 108508,
      "name": "Population and society",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/SOCI"
    },
    {
      "code": "TRAN",
      "dataset_count": 49024,
      "name": "Transport",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/TRAN"
    },
    {
      "code": "EDUC",
      "dataset_count": 46158,
      "name": "Education, culture and sport",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/EDUC"
    },
    {
      "code": "HEAL",
      "dataset_count": 34455,
      "name": "Health",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/HEAL"
    },
    {
      "code": "ENER",
      "dataset_count": 12824,
      "name": "Energy",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/ENER"
    },
    {
      "code": "INTR",
      "dataset_count": 2165,
      "name": "International issues",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/INTR"
    },
    {
      "code": "OP_DATPRO",
      "dataset_count": 1736,
      "name": "Provisional data",
      "uri": "http://publications.europa.eu/resource/authority/data-theme/OP_DATPRO"
    }
  ]
}
```

### List new or updated datasets

List the datasets most recently added to data.europa.eu, or most recently modified by their publishers, newest first, optionally in one country, catalogue or theme or matching words, and only those since a moment you give. Useful on a schedule to see what a catalogue or theme has published lately.

**Inputs**

- Show datasets (`change`, text): Added to the portal (newly harvested) or modified by the publisher. One of: `added` (Added to the portal), `modified` (Modified by the publisher). Default: `added`.
- Since (`since`, date and time): Only datasets added or modified at or after this moment. Leave empty for the newest whatever their date.
- Search words (`query`, text): Words to look for in titles, descriptions and keywords, in any EU language. Leave empty to list everything the filters match.
- Country (`country`, text): Only datasets from this country's catalogues. Pick one, or type its two-letter code (de) or name (Germany); EUROPE means the EU institutions and Europe-wide catalogues.
- Catalogue (`catalogue`, text): Only datasets from this catalogue: a national portal such as GovData, an EU institution such as Eurostat, or a geoportal. Pick one, or type its id or name. 'List catalogues' lists them.
- Data theme (`theme`, text): Only datasets filed under this EU data theme, such as Environment or Transport. Pick one, or type its code (ENVI) or name.
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.
- Most results (`limit`, number): How many datasets to list, 1 to 100. Defaults to 25. From 1 to 100.

**Outputs**

- `change` (text): added (newest to the portal first) or modified (most recently modified by the publisher first).
- `count` (number): How many datasets are listed.
- `datasets` (list): The datasets, newest first.
- `has_more` (true/false): True when more datasets qualify than were listed: raise the limit or run again with a later 'since'.
- `language` (text): The language titles and descriptions were asked for.
- `since` (text): The moment asked from, in UTC, when one was given.
- `summary` (text): One line describing the result.

**Example output**

```json
{
  "change": "added",
  "count": 3,
  "datasets": [
    {
      "added_to_portal": "2026-10-26T20:31:39Z",
      "catalogue": "Data.gov.ie",
      "catalogue_id": "data-gov-ie",
      "country": "ie",
      "country_name": "Ireland",
      "description": "Domestic Building Energy Ratings",
      "distribution_count": 4,
      "formats": [
        "Excel XLSX",
        "JSON-STAT",
        "CSV",
        "PX"
      ],
      "id": "646c065a-29f8-47b2-ae97-b0bf3a033a7b",
      "is_high_value": false,
      "issued": "2026-10-24T01:21:38Z",
      "keywords": [
        "energy",
        "cso",
        "EBQ03"
      ],
      "language": "en",
      "licences": [
        {
          "id": "https://creativecommons.org/licenses/by/4.0/",
          "name": "Creative Commons Attribution 4.0 International",
          "url": "https://creativecommons.org/licenses/by/4.0/"
        }
      ],
      "modified": "2026-10-26T01:21:00Z",
      "publisher": "Central Statistics Office",
      "quality_score": null,
      "themes": [
        {
          "code": "ENER",
          "name": "Energy"
        }
      ],
      "title": "EBQ03 - Domestic Building Energy Ratings",
      "url": "https://data.europa.eu/data/datasets/646c065a-29f8-47b2-ae97-b0bf3a033a7b?locale=en"
    },
    {
      "added_to_portal": "2026-10-24T20:38:05Z",
      "catalogue": "Data.gov.ie",
      "catalogue_id": "data-gov-ie",
      "country": "ie",
      "country_name": "Ireland",
      "description": "Non-Domestic Building Energy Ratings",
      "distribution_count": 4,
      "formats": [
        "JSON-STAT",
        "PX",
        "Excel XLSX",
        "CSV"
      ],
      "id": "72c6234c-85a1-49b0-9cf0-b447394d3cab",
      "is_high_value": false,
      "issued": "2026-10-24T01:21:35Z",
      "keywords": [
        "energy",
        "cso",
        "NDBER04"
      ],
      "language": "en",
      "licences": [
        {
          "id": "https://creativecommons.org/licenses/by/4.0/",
          "name": "Creative Commons Attribution 4.0 International",
          "url": "https://creativecommons.org/licenses/by/4.0/"
        }
      ],
      "modified": "2026-10-24T01:21:35Z",
      "publisher": "Central Statistics Office",
      "quality_score": null,
      "themes": [
        {
          "code": "ENER",
          "name": "Energy"
        }
      ],
      "title": "NDBER04 - Non-Domestic Building Energy Ratings",
      "url": "https://data.europa.eu/data/datasets/72c6234c-85a1-49b0-9cf0-b447394d3cab?locale=en"
    },
    {
      "added_to_portal": "2026-10-24T20:38:03Z",
      "catalogue": "Data.gov.ie",
      "catalogue_id": "data-gov-ie",
      "country": "ie",
      "country_name": "Ireland",
      "description": "Higher Education Research and Development (HERD) expenditure",
      "distribution_count": 4,
      "formats": [
        "PX",
        "JSON-STAT",
        "CSV",
        "Excel XLSX"
      ],
      "id": "aa22a716-5d00-4a7d-bd95-2f1dcdaddd08",
      "is_high_value": false,
      "issued": "2026-10-23T01:18:07Z",
      "keywords": [
        "HERD01",
        "cso",
        "department-of-further-and-higher-education-research-innovation-and-science-in-ireland"
      ],
      "language": "en",
      "licences": [
        {
          "id": "https://creativecommons.org/licenses/by/4.0/",
          "name": "Creative Commons Attribution 4.0 International",
          "url": "https://creativecommons.org/licenses/by/4.0/"
        }
      ],
      "modified": "2026-10-24T01:22:10Z",
      "publisher": "Department of Further and Higher Education, Research, Innovation and Science",
      "quality_score": null,
      "themes": [
        {
          "code": "GOVE",
          "name": "Government and public sector"
        }
      ],
      "title": "HERD01 - Higher Education Research and Development (HERD) expenditure",
      "url": "https://data.europa.eu/data/datasets/aa22a716-5d00-4a7d-bd95-2f1dcdaddd08?locale=en"
    }
  ],
  "has_more": true,
  "language": "en",
  "since": null,
  "summary": "3 datasets from Ireland added to the portal, newest first (latest 2026-10-26 20:31)."
}
```

### Search datasets

Search the 1.9 million datasets on data.europa.eu, the EU's open data portal, by words in any EU language and by country, catalogue, data theme, file format, licence, publisher, keyword or date, newest or best match first. Each dataset comes with its id, title and description in the language you choose, publisher, formats, licences and a link to its page. No API key required.

**Inputs**

- Search words (`query`, text): Words to look for in titles, descriptions and keywords, in any EU language. Leave empty to list everything the filters match.
- Country (`country`, text): Only datasets from this country's catalogues. Pick one, or type its two-letter code (de) or name (Germany); EUROPE means the EU institutions and Europe-wide catalogues.
- Catalogue (`catalogue`, text): Only datasets from this catalogue: a national portal such as GovData, an EU institution such as Eurostat, or a geoportal. Pick one, or type its id or name. 'List catalogues' lists them.
- Data theme (`theme`, text): Only datasets filed under this EU data theme, such as Environment or Transport. Pick one, or type its code (ENVI) or name.
- File format (`file_format`, text): Only datasets with a file in this format, such as CSV, JSON or XLSX. Pick one, or type it.
- Licence (`licence`, text): Only datasets with a file under this licence. Pick one of the licences the portal's datasets use most, or type its code (CC_BY_4_0) or the link a publisher gives.
- Publisher (`publisher`, text): Only datasets from this publisher, by its name as the portal shows it. Pick one of the busiest, or type it.
- Keyword (`keyword`, text): Only datasets tagged with this keyword, such as unemployment. Keywords are in the publisher's language.
- High-value datasets only (`high_value_only`, true/false): Only the EU's high-value datasets: statistics, geospatial, earth observation, meteorological, company and mobility data that public bodies must publish free of charge. Default: `false`.
- Dates apply to (`date_field`, text): Which date From and To filter on: when the publisher last modified it, first published it, or the period the data covers. One of: `modified` (Last modified), `issued` (First published), `temporal` (Period the data covers). Default: `modified`.
- From (`from_date`, date): Only datasets whose date is on or after this day.
- To (`to_date`, date): Only datasets whose date is on or before this day.
- Sort by (`sort`, text): The order to list them in. Defaults to best match with search words, and recently modified without. One of: `relevance` (Best match), `modified` (Recently modified), `issued` (Recently published), `added` (Recently added to the portal), `title` (Title, A to Z), `quality` (Best metadata quality).
- Language (`language`, text): The language for titles, descriptions, themes and keywords. Most records are machine-translated into every EU language; when one isn't, English or the publisher's own language is used, and the result says which. One of: `bg` (Bulgarian (български)), `hr` (Croatian (hrvatski)), `cs` (Czech (čeština)), `da` (Danish (dansk)), `nl` (Dutch (Nederlands)), `en` (English), `et` (Estonian (eesti)), `fi` (Finnish (suomi)), `fr` (French (français)), `de` (German (Deutsch)), and 14 more. Default: `en`.
- Page (`page`, number): Which page of results, from 1. The portal lists the first 10,000 matches of a search. From 1 to 10000.
- Results per page (`limit`, number): How many datasets to return, 1 to 100. Defaults to 10. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page.
- `datasets` (list): The datasets on this page.
- `has_more` (true/false): True when there is another page (within the first 10,000 matches).
- `language` (text): The language titles and descriptions were asked for.
- `limit` (number): How many datasets a page holds.
- `page` (number): The page number, from 1.
- `summary` (text): One line describing the result.
- `total` (number): How many datasets match in all.

**Example output**

```json
{
  "count": 2,
  "datasets": [
    {
      "added_to_portal": "2026-02-06T11:44:55Z",
      "catalogue": "Eurostat",
      "catalogue_id": "estat",
      "country": "EUROPE",
      "country_name": "EU institutions and Europe-wide",
      "description": "Unemployed persons as a percentage of the labour force. The labour force is the total number of people employed and unemployed. Unemployed persons are persons aged 15 to 74 who were without work during the reference week, were available for work and were actively seeking work. Data available as\u2026",
      "distribution_count": 5,
      "formats": [
        "HTML",
        "XML",
        "TSV",
        "CSV"
      ],
      "id": "5wwzzynxik3astazdxagg",
      "is_high_value": false,
      "issued": "2017-12-05",
      "keywords": [
        "Age class",
        "Geopolitical entity (reporting)",
        "Time frequency",
        "Unit of measure"
      ],
      "language": "en",
      "licences": [
        {
          "id": "CC_BY_4_0",
          "name": "Creative Commons Attribution 4.0 International",
          "url": "http://spdx.org/licenses/CC-BY-4.0"
        }
      ],
      "modified": "2026-10-26",
      "publisher": "Eurostat",
      "quality_score": 550,
      "themes": [
        {
          "code": "SOCI",
          "name": "Population and society"
        },
        {
          "code": "HEAL",
          "name": "Health"
        },
        {
          "code": "JUST",
          "name": "Justice, legal system and public safety"
        }
      ],
      "title": "Unemployment rate",
      "url": "https://data.europa.eu/data/datasets/5wwzzynxik3astazdxagg?locale=en"
    },
    {
      "added_to_portal": "2022-04-29T09:12:33Z",
      "catalogue": "Eurostat",
      "catalogue_id": "estat",
      "country": "EUROPE",
      "country_name": "EU institutions and Europe-wide",
      "description": "The dataset \"med_ps421\" has been discontinued since 31/07/2026.",
      "distribution_count": 1,
      "formats": [
        "XML"
      ],
      "id": "gnz8n38zueu8ojzmmii3wq",
      "is_high_value": false,
      "issued": "2010-08-03",
      "keywords": [],
      "language": "en",
      "licences": [
        {
          "id": "CC_BY_4_0",
          "name": "Creative Commons Attribution 4.0 International",
          "url": "http://spdx.org/licenses/CC-BY-4.0"
        }
      ],
      "modified": null,
      "publisher": "Eurostat",
      "quality_score": 230,
      "themes": [],
      "title": "Unemployment rate",
      "url": "https://data.europa.eu/data/datasets/gnz8n38zueu8ojzmmii3wq?locale=en"
    }
  ],
  "has_more": true,
  "language": "en",
  "limit": 2,
  "page": 1,
  "summary": "996 datasets matching 'unemployment rate' in catalogue estat; showing 1 to 2.",
  "total": 996
}
```
