OECD Data Explorer

Basisadres

https://sdmx.oecd.org/public/rest

Endpoints 6

• GET/data/{agency},{dataflow},{versie}/{sleutel}Data (SDMX API 1). Sleutel: één plek per dimensie (zonder tijd), punten ertussen, + voor meer codes, leeg = alles. Voorbeeld: OECD.SDD.TPS,DSD_LFS@DF_IALFS_UNE_M,1.0/NLD+DEU.UNE_LF_M.PT_LF_SUB._Z.Y._T.Y_GE15._Z.M
• GET/v2/data/dataflow/{agency}/{dataflow}/{versie}/{sleutel}Data (SDMX API 2): één code per dimensie, * als jokerteken, tijd met c[TIME_PERIOD]=ge:2018+le:2024. Versie + = nieuwste.
• GET/dataflow/allAlle 1.550 dataflows met id, agency, versie en naam (10 MB als JSON met Accept application/vnd.sdmx.structure+json).
• GET/dataflow/{agency}/{dataflow}/{versie}?references=allEén dataflow met datastructuur, codelijsten en concepten: de volgorde van de dimensies en alle codes.
• GET/availableconstraint/{agency},{dataflow},{versie}/{sleutel}/all/{dimensie}Welke codes van één dimensie data hebben bij deze sleutel, plus het aantal waarnemingen (obs_count). Handig om de juiste MEASURE-code te vinden.
• GET/codelist/{agency}/{codelijst}Codelijst met namen, bv. /codelist/OECD/CL_AREA (landen en gebieden, 576 kB JSON).

Filteren getest

Reekssleutel in het pad: codes in de volgorde van de dimensies, punten ertussen, + voor meer codes, leeg voor alles. Tijd met startPeriod/endPeriod of lastNObservations.

Parameters 10

Kolommen in format=csvfile (werkloosheid per maand) 9

Limieten en valkuilen

• Bij aanroepen kort na elkaar geeft de API 429. Wacht dan oplopend (15, 30, 45 s) en vraag liever één keer meer landen tegelijk met +. ervaring
• De OESO kondigde in november 2024 een limiet op datadownloads aan (pagina 'API best practices'; zoekresultaten noemen 60 per uur). Die pagina op www.oecd.org gaf ons 403, dus het getal hebben we niet zelf gelezen. ervaring
• Geen sleutel nodig. Zet Accept-Encoding: gzip; dataflow/all is 10 MB. getest
• Geen resultaat = HTTP 404 met de platte tekst NoResultsFound, geen lege lijst. getest
• Een onbekende parameter (bv. lang=en) geeft 403 met de lijst toegestane parameters: startPeriod, endPeriod, updatedAfter, firstNObservations, lastNObservations, dimensionAtObservation, detail, includeHistory, asOf (format werkt ook). getest
• Verkeerd aantal dimensies in de sleutel: bij availableconstraint 403 'Not enough key values in query, expecting 9 got 11'; bij data kwam alleen NoResultsFound. Tel de punten. getest
• De codes in de standaardweergave kloppen niet altijd met de data: de metadata noemden UNE_M, de data gebruiken UNE_LF_M. Vraag availableconstraint voor de dimensie MEASURE. getest
• Accept-Language: * (de standaard van Node fetch) geeft HTTP 500 'Internal server error', op structuur- én datavragen (gemeten met curl: zonder die kop 200, met die kop 500; een antwoord dat al in de cache van de OESO staat komt wel door). Zet zelf Accept-Language: en. Volgens de handleiding hangt ook het scheidingsteken van SDMX-CSV af van Accept-Language (soms ;). getest
• Laat je een dimensie leeg, dan krijg je alle varianten door elkaar (bij werkuren alle werkenden én alleen werknemers). Kies elke dimensie bewust. ervaring
• CSV-rijen komen niet gesorteerd op land of periode. csvfilewithlabels heeft een andere kop (STRUCTURE, STRUCTURE_ID, met een namenkolom naast elke code). getest
• Dataflows verwijzen soms naar een oudere structuurversie; zonder versie in het pad (SDMX API 1) of met + (API 2) krijg je de nieuwste, die niet altijd achterwaarts compatibel is. uit de beschrijving
• De Data Explorer heeft per tabel een knop 'Developer API' met precies de aanroep voor jouw selectie. uit de beschrijving

Probeer het HTTP 200 · 1.242 ms · 16 okt

https://sdmx.oecd.org/public/rest/data/OECD.SDD.TPS,DSD_LFS@DF_IALFS_UNE_M,1.0/NLD+DEU+BEL.UNE_LF_M.PT_LF_SUB._Z.Y._T.Y_GE15._Z.M?lastNObservations=2&format=csvfile

DATAFLOW,REF_AREA,MEASURE,UNIT_MEASURE,TRANSFORMATION,ADJUSTMENT,SEX,AGE,ACTIVITY,FREQ,TIME_PERIOD,OBS_VALUE,BASE_PER,OBS_STATUS,UNIT_MULT,DECIMALS
OECD.SDD.TPS:DSD_LFS@DF_IALFS_UNE_M(1.0),BEL,UNE_LF_M,PT_LF_SUB,_Z,Y,_T,Y_GE15,_Z,M,2026-08,5.9,,A,0,1
OECD.SDD.TPS:DSD_LFS@DF_IALFS_UNE_M(1.0),BEL,UNE_LF_M,PT_LF_SUB,_Z,Y,_T,Y_GE15,_Z,M,2026-07,6,,A,0,1
OECD.SDD.TPS:DSD_LFS@DF_IALFS_UNE_M(1.0),DEU,UNE_LF_M,PT_LF_SUB,_Z,Y,_T,Y_GE15,_Z,M,2026-08,4,,A,0,1
OECD.SDD.TPS:DSD_LFS@DF_IALFS_UNE_M(1.0),DEU,UNE_LF_M,PT_LF_SUB,_Z,Y,_T,Y_GE15,_Z,M,2026-07,4,,A,0,1
OECD.SDD.TPS:DSD_LFS@DF_IALFS_UNE_M(1.0),NLD,UNE_LF_M,PT_LF_SUB,_Z,Y,_T,Y_GE15,_Z,M,2026-08,4,,A,0,1
OECD.SDD.TPS:DSD_LFS@DF_IALFS_UNE_M(1.0),NLD,UNE_LF_M,PT_LF_SUB,_Z,Y,_T,Y_GE15,_Z,M,2026-07,4,,A,0,1

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