Skip to content
HALOWERK

Datenwerk

eurostat dataset

Reads the dataset structure from the Eurostat Statistics API (JSON-stat 2.0, structure-only request), validates every filter dimension and code against it, estimates the cell count before downloading, then fetches the filtered data and decodes it into rows (dimension codes, time, value, status flag such as p = provisional or e = estimated) together with labels for the selected codes in English, German or French. Returns the dataset title, last data update (Datenstand), source and licence (CC.

POST https://daten.halowerk.com/v1/eurostat-dataset

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
datasetstringYesEurostat dataset code, e.g. nama_10_gdp, prc_hicp_manr, tour_occ_nin3.
filtersobjectNoDimension filters, e.g. {"geo":["DE","FR"],"unit":"CP_MEUR"}.
sincestringNoFirst time period, e.g. 2015, 2020-Q1, 2022-09.
untilstringNoLast time period in the same format.
last_nintegerNoOnly the last N periods (not combinable with since/until).
langstringNoLanguage of labels.
max_rowsintegerNoMaximum number of rows returned.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "dataset"
  ],
  "properties": {
    "dataset": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_]{2,40}$",
      "description": "Eurostat dataset code, e.g. nama_10_gdp, prc_hicp_manr, tour_occ_nin3."
    },
    "filters": {
      "type": "object",
      "maxProperties": 15,
      "description": "Dimension filters, e.g. {\"geo\":[\"DE\",\"FR\"],\"unit\":\"CP_MEUR\"}.",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 40
          },
          {
            "type": "array",
            "minItems": 1,
            "maxItems": 60,
            "items": {
              "type": "string",
              "maxLength": 40
            }
          }
        ]
      }
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}(-(\\d{2}|Q[1-4]|S[12]|W\\d{2}))?$",
      "description": "First time period, e.g. 2015, 2020-Q1, 2022-09."
    },
    "until": {
      "type": "string",
      "pattern": "^\\d{4}(-(\\d{2}|Q[1-4]|S[12]|W\\d{2}))?$",
      "description": "Last time period in the same format."
    },
    "last_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Only the last N periods (not combinable with since/until)."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "de",
        "fr"
      ],
      "default": "en",
      "description": "Language of labels."
    },
    "max_rows": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000,
      "default": 1000,
      "description": "Maximum number of rows returned."
    }
  }
}

Open original schema

Published input example

{
  "dataset": "prc_hicp_manr",
  "filters": {
    "geo": [
      "DE",
      "FR"
    ],
    "coicop": "CP00"
  },
  "since": "2022-09",
  "until": "2022-12"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’