Skip to main content
POST
/
api
/
ecb
/
datasets
/ecb/datasets
curl --request POST \
  --url https://api.anysite.io/api/ecb/datasets \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "dataset": "<string>",
  "count": 2,
  "timeout": 300,
  "key": "D.USD.EUR.SP00.A",
  "filters": {
    "CURRENCY": [
      "USD",
      "JPY"
    ],
    "CURRENCY_DENOM": [
      "EUR"
    ],
    "FREQ": [
      "D"
    ]
  },
  "start_period": "2020",
  "end_period": "2024"
}
'
[
  {
    "key": "<string>",
    "dimensions": [
      {
        "id": "<string>",
        "code": "<string>",
        "@type": "@ecb_dimension_value",
        "label": "<string>"
      }
    ],
    "observations": [
      {
        "period": "<string>",
        "@type": "@ecb_observation",
        "value": 123,
        "obs_status": "<string>",
        "obs_status_label": "<string>",
        "obs_conf": "<string>",
        "obs_conf_label": "<string>",
        "obs_pre_break": "<string>",
        "obs_com": "<string>"
      }
    ],
    "@type": "@ecb_series",
    "title": "<string>",
    "title_complement": "<string>",
    "unit": "<string>",
    "unit_label": "<string>",
    "unit_mult": 123,
    "decimals": 123,
    "collection": "<string>",
    "source_agency": "<string>",
    "time_format": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
dataset
string
required

Dataset code

Examples:

"EXR"

"BSI"

"ICP"

"FM"

count
integer
required

Number of series to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
key
string | null

Dot-separated dimension key with optional wildcards; empty segments match all values

Example:

"D.USD.EUR.SP00.A"

filters
Filters · object

Dimension filters as a mapping of dimension id to allowed value codes; used to build the key when key is not given

Example:
{
"CURRENCY": ["USD", "JPY"],
"CURRENCY_DENOM": ["EUR"],
"FREQ": ["D"]
}
start_period
string | null

Earliest time period, inclusive

Example:

"2020"

end_period
string | null

Latest time period, inclusive

Example:

"2024"

Response

Successful Response

key
string
required
dimensions
EcbDimensionValue · object[]
required
observations
EcbObservation · object[]
required
@type
string
default:@ecb_series
title
string | null
title_complement
string | null
unit
string | null
unit_label
string | null
unit_mult
integer | null
decimals
integer | null
collection
string | null
source_agency
string | null
time_format
string | null