Eurostat

Basisadres

https://ec.europa.eu/eurostat/api/dissemination

Endpoints 10

• GET/statistics/1.0/data/{datasetcode}Data van één dataset als JSON-stat 2.0. Elke dimensie is een filter: ?geo=NL&geo=EU27_2020&unit=…
• GET/sdmx/2.1/data/{datasetcode}/{sleutel}Zelfde data via SDMX 2.1: sleutel met punten tussen de dimensies (A.TOTAL.I15_A_AVG.NL+EU27_2020), format=SDMX-CSV, TSV of JSON.
• GET/sdmx/3.0/data/dataflow/ESTAT/{datasetcode}/1.0/{sleutel}SDMX 3.0: tijdfilter als c[TIME_PERIOD]=ge:2023, format=csvdata.
• GET/sdmx/2.1/dataflow/ESTAT/{datasetcode}Beschrijving van de dataset (SDMX-ML) met annotaties: OBS_COUNT, oudste en nieuwste periode, UPDATE_DATA. /dataflow/ESTAT/all?detail=allstubs geeft alle dataflows (7 MB).
• GET/sdmx/2.1/datastructure/ESTAT/{DATASETCODE}Datastructuur: welke dimensies in welke volgorde (bepaalt de sleutel).
• GET/sdmx/2.1/contentconstraint/ESTAT/{DATASETCODE}Welke codes per dimensie echt data hebben in deze dataset.
• GET/sdmx/2.1/codelist/ESTAT/{codelijst}Codelijst met namen, bv. GEO (alle landen, regio's en aggregaten; 2,8 MB).
• GET/catalogue/toc/txt?lang=enInhoudsopgave als tab-gescheiden tekst (2 MB): titel, code, type, laatste update, begin, einde, aantal waarden. Ook als /catalogue/toc/xml.
• GET/catalogue/metabase.txt.gzPer dataset alle dimensies en codes (dataset, dimensie, code), gzip.
• GET/catalogue/rss/en/statistics-update.rssRSS met nieuwe, bijgewerkte en verwijderde datasets van de laatste 7 dagen (ook de, fr).

Filteren getest

Statistics API: één queryparameter per dimensie, herhaald voor meer waarden. SDMX: een reekssleutel in het pad met punten tussen de dimensies (volgorde uit de datastructuur), + voor meer waarden, leeg voor alles.

Parameters 13

Velden in het JSON-stat-antwoord 8

Limieten en valkuilen

• Grote vragen worden asynchroon verwerkt: dan komt een waarschuwing 413 ASYNCHRONOUS_RESPONSE en moet je het later opnieuw vragen. Er volgt geen bericht als het klaar is. uit de beschrijving
• Zonder filters komt alles: demo_r_pjangrp3 (bevolking per NUTS 3) was ongefilterd 24 MB JSON. Filter altijd op geo en de andere dimensies. getest
• Geen sleutel en geen gedocumenteerde aanvraaglimiet. Data worden om 11:00 en 23:00 (Brusselse tijd) ververst. uit de beschrijving
• Een dataset zonder geo-dimensie geeft met geo=NL een 400 'Dimension "GEO" is not defined' (bv. ert_bil_eur_a, wisselkoersen). Vraag dan zonder geo. getest
• Onbekende datasetcode: 404 met 'is not available for dissemination'. Fouten komen als JSON: {"error":[{"status","id","label"}]}. getest
• lastTimePeriod geldt voor de hele dataset, niet per reeks. NL329 (Groot-Amsterdam, NUTS 2021) gaf met lastTimePeriod=1 een lege value, omdat 2025 alleen onder de nieuwe NUTS 2024-codes staat. Gebruik sinceTimePeriod of de SDMX-parameter lastNObservations (per reeks). getest
• De HICP-tabellen volgens ECOICOP 1 (prc_hicp_manr, prc_hicp_midx …) stoppen bij december 2025. De lopende inflatie staat in prc_hicp_minr (ECOICOP 2, dimensie coicop18): september 2026 NL 3,0%, eurozone (EA) 3,8%. getest
• JSON-stat: de positie van een waarde volgt uit de dimensies in de volgorde van id, met de grootte uit size (laatste dimensie loopt het snelst). Ontbrekende posities in value zijn lege cellen, geen nul. getest
• De dataflow-annotaties OBS_PERIOD_OVERALL_LATEST en UPDATE_DATA zijn een snelle versheidscheck zonder data op te halen (prc_hpi_a: 2025, bijgewerkt 1 okt 2026). getest
• robots.txt van ec.europa.eu verbiedt het oude /eurostat/SDMX/diss-web/rest/ en /eurostat/tgm/, niet /eurostat/api/. Gebruik dus alleen de nieuwe api/dissemination-adressen. getest
• Titels en labels alleen in het Engels, Frans of Duits; de Data Browser geeft per tabel de code (bv. prc_hpi_a) die je in de API gebruikt. getest

Probeer het HTTP 200 · 1.029 ms · 16 okt

https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/prc_hpi_a?geo=NL&geo=EU27_2020&purchase=TOTAL&unit=I15_A_AVG&sinceTimePeriod=2020

{
  "version": "2.0",
  "class": "dataset",
  "label": "House price index - annual data",
  "source": "ESTAT",
  "updated": "2026-10-01T11:00:00+0200",
  "value": {
    "0": 127.15,
    "1": 137.87,
    "2": 148.86,
    "3": 148.44,
    "4": 153.42,
    "5": 161.89,
    "6": 144.07,
    "7": 164.94,
    "8": 186.84,
    "9": 183.26,
    "10": 198.24,
    "11": 215.15
  },
  "id": [
    "freq",
    "purchase"
  ],
  "size": [
    1,
    1
  ],
  "dimension": {
    "freq": {
      "label": "Time frequency",
      "category": {
        "index": {
          "A": 0
        },
        "label": {
          "A": "Annual"
        }
      }
    },

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.