APIs documentation

The following REST APIs are available:

• STATISTICS, which ensure business continuity with previous Eurostat JSON web service;
• SDMX 3.0, used formetadata and data queries following SDMX 3.0 specification;
• SDMX 2.1, used for metadata and data queries following SDMX 2.1 specification;
• CATALOGUE, which is used for dataset discovery;

Anchor
STATISTICS STATISTICS

STATISTICS API

Statistics API is a REST web service for data query focused on supporting Eurostat Visualisations Tools and open for public use.

This Web Serviceweb service:

• provides data in JSON-stat 2.0 format;

• supports only REpresentation State Transfer (REST) protocol;

• supports Cross-Origin Resource Sharing (CORS) 

• delivers responses in English, French or German.

API - Getting started with statistics API

API - Detailed guidelines - API Statistics

Anchor
SDMX30 SDMX30

SDMX 3.0 API

The SDMX 3.0 API is a programmatic access to metadata and data, in line with SDMX technical specifications for version 3.0, with the possibility to:

• Get a complete list of publicly available datasets

• Get the complete structure definition for a specific dataset

• Download a dataset in full, or a subset of a specific dataset. This supports customized customised requests for data.

Processing time and the data response depend on the query , i.e.and the target dataset size:

• A request for a small subset of a dataset could result in a response with few kilobytes, and can be returned within seconds

• A request for full dataset could result in a response of up to several megabytes, and can be returned after several minutes. When submitting this kind of request, asynchronous requests (described hereafter), may be useful.

This API supports returning data in formats other than SDMX-ML 3.0:

• SDMX-CSV 2.0

• JSON-stat 2.0

• TSV

• SDMX-ML 2.1 (for usage of new API query with content backward compatibility)

API - Getting started with SDMX3.0 API

API - Detailed guidelines - SDMX3.0 API

Anchor
SDMX21 SDMX21

SDMX 2.1 API

The SDMX 2.1 API  is a programmatic access to metadata and data, in line with SDMX technical specifications for version 2.1, with the possibility to:

• Get a complete list of publicly available datasets

• Get the complete structure definition for a specific dataset

• Download a dataset in full, or a subset of a specific dataset. This supports customized requests for data.

Processing time and the data response depend on the query, i.e.

• A request for a small subset of a dataset could result in a response with few kilobytes, and can be returned within seconds

• A request for full dataset could result in a response of up to several megabytes, and can be returned after several minutes. When submitting this kind of request, asynchronous requests (described hereafter), may be useful.

This API supports returning data in formats other than SDMX-ML 2.1:

• SDMX-CSV 1.0
• JSON-stat 2.0

• TSV

API - Getting started with SDMX2.1 API

API - Detailed guidelines - SDMX2.1 API

Anchor
CATALOG CATALOG

CATALOGUE API

The CATALOGUE API serves dataset discovery purposes via programmatic access to catalogues catalogue of datasetdatasets.

API - Getting started with catalogue API

API - Detailed guidelines - Catalogue API