# EU Open Data Portal API

> data.europa.eu: search 1.8 million public datasets harvested from 200+ European data catalogues

- Vendor: `euopendataportalapi` · version 1.0 · category Government Data · tags eu open data api, data.europa.eu api, european open data api, dcat-ap api, government open data api, europe datasets search api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/euopendataportalapi
- This document: https://apiclay.com/docs/euopendataportalapi.md
- OpenAPI 3.1: https://apiclay.com/api/euopendataportalapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `euopendataportalapi`
- Updated: 2026-11-18

## About

## EU Open Data Portal API

The official open data portal of the European Union (data.europa.eu), which harvests about 1.8 million datasets from more than 200 national, regional and EU-institution catalogues across Europe. Search datasets by keyword with country, catalogue, format or theme facets, read any dataset's full DCAT-AP record with its distributions and download links, and list or read the source catalogues.

Data comes from **data.europa.eu** (https://data.europa.eu). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/datasets?q=air quality&amp;facets={"country":["de"]}&amp;limit=5` for a dataset `id`, then `/dataset?id=` for its distributions.

### Routes

#### GET `/datasets` - Datasets
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | no | Keyword search, e.g. `air quality`. |
| facets | query | string | no | JSON object of facet filters, e.g. `{"country":["de"],"format":["CSV"]}`; other facets include `catalog`, `categories` and `keywords`. |
| sort | query | string | no | e.g. `modified+desc` or `relevance+desc`. |
| includes | query | string | no | Comma-separated fields to return, e.g. `id,title,country,modified,distributions.access_url`. |
| limit | query | number | no | Datasets per page; keep it small, since records carry every language. |
| page | query | number | no | Page, from 0. |

Returns: `result.count` and `result.results`: datasets with `id`, `title` and `description` per language, `country`, `catalog`, `keywords`, `categories`, `modified` and `distributions`.

#### GET `/dataset` - Dataset
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Dataset `id` from `/datasets`. |

Returns: `result`: the full DCAT-AP record, including `catalog`, `publisher`, `license` and every distribution's `access_url`, `download_url` and `format`.

#### GET `/catalogues` - Catalogues
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | no | Name search. |
| limit | query | number | no | Catalogues per page. |
| page | query | number | no | Page, from 0. |

Returns: `result.count` and `result.results`: source catalogues with `id`, `title`, `country` and `homepage`.

#### GET `/catalogue` - Catalogue
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Catalogue `id` from `/catalogues` or a dataset's `catalog.id`. |

Returns: `result`: one catalogue with its `title`, `description`, `publisher`, `country`, `homepage` and dataset `count`.

### Caveats

- Titles and descriptions come in many languages, some machine-translated (`translation_meta`).
- Each dataset keeps the licence its source catalogue sets (`license` in `/dataset`); credit the publisher.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by data.europa.eu.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /datasets — Datasets
- Gateway: `GET https://api.apiclay.com/v1/api/euopendataportalapi/datasets`
- Public query params: `q` (string), `facets` (string), `sort` (string), `includes` (string), `limit` (number), `page` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /dataset — Dataset
- Gateway: `GET https://api.apiclay.com/v1/api/euopendataportalapi/dataset`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /catalogues — Catalogues
- Gateway: `GET https://api.apiclay.com/v1/api/euopendataportalapi/catalogues`
- Public query params: `q` (string), `limit` (number), `page` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /catalogue — Catalogue
- Gateway: `GET https://api.apiclay.com/v1/api/euopendataportalapi/catalogue`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/euopendataportalapi/datasets" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
