Eurostat Online Help for Data Browser
Child pages
  • API - Detailed guidelines - SDMX3.0 API - data query

Versions Compared

Old Version 2

changes.mady.by.user Philippe Weber

Saved on

compared with

New Version Current

changes.mady.by.user Philippe Weber

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The data retrieved can be retrieved in a variety of formats (JSON, XML, CSV, etc.).

Depending on the request, a data query can result in a (potentially very) large response in which case data is delivered asynchronously. For more information please read the page 'API - Detailed guidelines - Asynchronous API'

Warning

It is important to remember that only the last version of each statistical observation is made available in the system. When a statistical observation is being updated, the previous value of the observation is lost and cannot be returned.

Query URL syntax

Generic SDMX3.0 syntax is the following

Code Block
protocol://ws-entry-point/data/{context}/{agencyID}/{resourceID}/{version}/{key}?
{c}&{firstNObservations}&{lastNObservations}&{attributes}&{measures}

...

Operators appear as prefix to the component value(s) and are separated from it by a :  (e.g. c[TIME_PERIOD]=ge:2020-01+le:2020-12).

...

The component "c" parameter can be used to additionally define filters on Dimensions on top of key parameter.

The c parameter does not filter on attributes, neither measures values.

...

STRUCTURE,STRUCTURE_ID,freq,unit,indic_eu,geo,TIME_PERIOD,OBS_VALUE
dataflow,ESTAT:T2020_20(1.0),A,PC_GDP,T2020_20,AT,2016,3.12
dataflow,ESTAT:T2020_20(1.0),A,PC_GDP,T2020_20,AT,2017,3.06
dataflow,ESTAT:T2020_20(1.0),A,PC_GDP,T2020_20,AT,2018,3.09
dataflow,ESTAT:T2020_20(1.0),A,PC_GDP,T2020_20,AT,2019,3.13


Request NoData

protocol://ws-entry-point/sdmx/3.0/data/dataflow/ESTAT/T2020_20/1.0?attributes=series&measures=none

...

DATAFLOW,LAST UPDATE,freq,unit,indic_eu,geo,TARGET_FLAG,TARGET
ESTAT:T2020_20(1.0),14/12/21 23:00:00,A,PC_GDP,T2020_20,AT,,3.76
ESTAT:T2020_20(1.0),14/12/21 23:00:00,A,PC_GDP,T2020_20,BA,,
ESTAT:T2020_20(1.0),14/12/21 23:00:00,A,PC_GDP,T2020_20,BE,,3
ESTAT:T2020_20(1.0),14/12/21 23:00:00,A,PC_GDP,T2020_20,BG,,1.5


Request SeriesKeysOnly

protocol://ws-entry-point/sdmx/3.0/data/dataflow/ESTAT/DEMOT2020_GIND20/1.0?attributes=none&measures=none

...