{"openapi":"3.1.0","info":{"title":"OECD Unemployment API","version":"1.0.0","description":"The monthly unemployment rate of every major economy on one comparable screen — the OECD harmonised unemployment rates as an API, live from the OECD's official statistics, no key. Each country measures joblessness slightly differently; the OECD harmonises them onto the same definition (the share of the labour force without work, available and actively looking) and seasonally adjusts them, so the numbers are genuinely comparable side by side. Unemployment is one of the two hard data points — with inflation — that move central banks and markets, and the monthly print, and which way it is turning, is what gets traded. The board endpoint returns the headline (15+) seasonally-adjusted unemployment rate for every economy the OECD tracks (and the aggregates — the euro area, the OECD, the EU), ranked from the tightest labour market to the loosest, each with its month-on-month change and whether the rate is rising (loosening) or falling (tightening). The youth endpoint does the same for the 15-24 age group — youth unemployment runs far higher and is watched as a social and structural gauge. The country endpoint puts the headline and youth rate together for one economy with its rank and recent direction. Each reading carries its own period and discontinued series are excluded, so the board is genuinely current. The labour-market / unemployment-rate cut — distinct from the annual IMF World Economic Outlook database (which carries unemployment as a yearly figure and forecast, not the live monthly print), the inflation and bond-yield boards, and the generic multi-provider data aggregator. Figures are monthly, in percent of the labour force.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/unemployment-api","description":"oanor gateway"}],"tags":[{"name":"Board"},{"name":"Youth"},{"name":"Country"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/board":{"get":{"operationId":"get_v1_board","tags":["Board"],"summary":"Headline (15+) unemployment rate for every economy, ranked","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"Drop aggregate groups (true)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The OECD harmonised, seasonally-adjusted unemployment rate (15+) for every tracked economy (and aggregates unless countries_only=true), in percent of the labour force, ranked from the tightest labour market (lowest rate) to the loosest. change is the month-on-month move; a rising rate means the labour market is loosening. Each row carries its own period (economies report with a varying lag); discontinued series are excluded. Monthly, cached a few hours.","board":[{"code":"JPN","name":"Japan","rank":1,"rate":2.5,"trend":"falling (labour market tightening)","change":-0.2,"period":"2026-04","previous":2.7,"is_aggregate":false},{"code":"MEX","name":"Mexico","rank":2,"rate":2.56,"trend":"falling (labour market tightening)","change":-0.19,"period":"2026-04","previous":2.75,"is_aggregate":false},{"code":"KOR","name":"Korea","rank":3,"rate":2.8,"trend":"rising (labour market loosening)","change":0.1,"period":"2026-04","previous":2.7,"is_aggregate":false},{"code":"BGR","name":"Bulgaria","rank":4,"rate":2.8,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":2.9,"is_aggregate":false},{"code":"ISR","name":"Israel","rank":5,"rate":2.92,"trend":"rising (labour market loosening)","change":0.14,"period":"2026-04","previous":2.79,"is_aggregate":false},{"code":"POL","name":"Poland","rank":6,"rate":3,"trend":"unchanged","change":0,"period":"2026-04","previous":3,"is_aggregate":false},{"code":"CZE","name":"Czechia","rank":7,"rate":3.1,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":3.2,"is_aggregate":false},{"code":"DEU","name":"Germany","rank":8,"rate":3.8,"trend":"unchanged","change":0,"period":"2026-04","previous":3.8,"is_aggregate":false},{"code":"NLD","name":"Netherlands","rank":9,"rate":3.9,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":4,"is_aggregate":false},{"code":"SVN","name":"Slovenia","rank":10,"rate":4.1,"trend":"unchanged","change":0,"period":"2026-04","previous":4.1,"is_aggregate":false},{"code":"HRV","name":"Croatia","rank":11,"rate":4.2,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":4.3,"is_aggregate":false},{"code":"USA","name":"United States","rank":12,"rate":4.3,"trend":"unchanged","change":0,"period":"2026-05","previous":4.3,"is_aggregate":false},{"code":"AUS","name":"Australia","rank":13,"rate":4.49,"trend":"rising (labour market loosening)","change":0.21,"period":"2026-04","previous":4.28,"is_aggregate":false},{"code":"NOR","name":"Norway","rank":15,"rate":4.6,"trend":"falling (labour market tightening)","change":-0.3,"period":"2026-04","previous":4.9,"is_aggregate":false},{"code":"HUN","name":"Hungary","rank":16,"rate":4.6,"trend":"rising (labour market loosening)","change":0.2,"period":"2026-04","previous":4.4,"is_aggregate":false},{"code":"IRL","name":"Ireland","rank":17,"rate":4.8,"trend":"falling (labour market tightening)","change":-0.2,"period":"2026-04","previous":5,"is_aggregate":false},{"code":"GBR","name":"United Kingdom","rank":18,"rate":4.9,"trend":"falling (labour market tightening)","change":-0.3,"period":"2026-01","previous":5.2,"is_aggregate":false},{"code":"ITA","name":"Italy","rank":20,"rate":5.1,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":5.2,"is_aggregate":false},{"code":"AUT","name":"Austria","rank":21,"rate":5.7,"trend":"unchanged","change":0,"period":"2026-04","previous":5.7,"is_aggregate":false},{"code":"PRT","name":"Portugal","rank":22,"rate":5.7,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":5.8,"is_aggregate":false},{"code":"SVK","name":"Slovak Republic","rank":23,"rate":5.8,"trend":"unchanged","change":0,"period":"2026-04","previous":5.8,"is_aggregate":false},{"code":"ISL","name":"Iceland","rank":24,"rate":5.8,"trend":"unchanged","change":0,"period":"2026-04","previous":5.8,"is_aggregate":false},{"code":"BEL","name":"Belgium","rank":26,"rate":6.2,"trend":"unchanged","change":0,"period":"2026-04","previous":6.2,"is_aggregate":false},{"code":"EST","name":"Estonia","rank":27,"rate":6.3,"trend":"unchanged","change":0,"period":"2026-04","previous":6.3,"is_aggregate":false},{"code":"ROU","name":"Romania","rank":28,"rate":6.3,"trend":"falling (labour market tightening)","change":-0.2,"period":"2026-04","previous":6.5,"is_aggregate":false},{"code":"EA","name":"Euro area","rank":29,"rate":6.3,"trend":"unchanged","change":0,"period":"2026-04","previous":6.3,"is_aggregate":false},{"code":"LVA","name":"Latvia","rank":30,"rate":6.5,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":6.6,"is_aggregate":false},{"code":"CAN","name":"Canada","rank":31,"rate":6.6,"trend":"falling (labour market tightening)","change":-0.3,"period":"2026-05","previous":6.9,"is_aggregate":false},{"code":"CRI","name":"Costa Rica","rank":32,"rate":6.85,"trend":"falling (labour market tightening)","change":-0.04,"period":"2026-03","previous":6.89,"is_aggregate":false},{"code":"LUX","name":"Luxembourg","rank":33,"rate":7,"trend":"unchanged","change":0,"period":"2026-04","previous":7,"is_aggregate":false},{"code":"DNK","name":"Denmark","rank":34,"rate":7,"trend":"rising (labour market loosening)","change":0.4,"period":"2026-04","previous":6.6,"is_aggregate":false},{"code":"LTU","name":"Lithuania","rank":35,"rate":7.1,"trend":"rising (labour market loosening)","change":0.1,"period":"2026-04","previous":7,"is_aggregate":false},{"code":"TUR","name":"Türkiye","rank":36,"rate":8.2,"trend":"rising (labour market loosening)","change":0.1,"period":"2026-04","previous":8.1,"is_aggregate":false},{"code":"FRA","name":"France","rank":37,"rate":8.2,"trend":"unchanged","change":0,"period":"2026-04","previous":8.2,"is_aggregate":false},{"code":"SWE","name":"Sweden","rank":38,"rate":8.5,"trend":"falling (labour market tightening)","change":-0.7,"period":"2026-04","previous":9.2,"is_aggregate":false},{"code":"COL","name":"Colombia","rank":39,"rate":8.75,"trend":"rising (labour market loosening)","change":0.2,"period":"2026-04","previous":8.56,"is_aggregate":false},{"code":"CHL","name":"Chile","rank":40,"rate":8.9,"trend":"rising (labour market loosening)","change":0.18,"period":"2026-03","previous":8.72,"is_aggregate":false},{"code":"GRC","name":"Greece","rank":41,"rate":9.5,"trend":"falling (labour market tightening)","change":-0.9,"period":"2026-04","previous":10.4,"is_aggregate":false},{"code":"ESP","name":"Spain","rank":42,"rate":10.3,"trend":"unchanged","change":0,"period":"2026-04","previous":10.3,"is_aggregate":false},{"code":"FIN","name":"Finland","rank":43,"rate":10.7,"trend":"rising (labour market loosening)","change":0.2,"period":"2026-04","previous":10.5,"is_aggregate":false}],"count":40,"source":"OECD harmonised unemployment (SDMX), seasonally adjusted","indicator":"unemployment rate (15+)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-13T04:45:28.443Z","request_id":"9f699c4e-0632-4ae1-adbb-00b51aaf2185"},"status":"ok","message":"Unemployment board retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/youth":{"get":{"operationId":"get_v1_youth","tags":["Youth"],"summary":"Youth (15-24) unemployment rate for every economy, ranked","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"Drop aggregate groups (true)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The OECD harmonised, seasonally-adjusted youth unemployment rate (15-24) for every tracked economy (and aggregates unless countries_only=true), in percent of the labour force, ranked from the tightest labour market (lowest rate) to the loosest. change is the month-on-month move; a rising rate means the labour market is loosening. Each row carries its own period (economies report with a varying lag); discontinued series are excluded. Monthly, cached a few hours.","board":[{"code":"JPN","name":"Japan","rank":1,"rate":3.6,"trend":"falling (labour market tightening)","change":-0.2,"period":"2026-04","previous":3.8,"is_aggregate":false},{"code":"ISR","name":"Israel","rank":2,"rate":4,"trend":"falling (labour market tightening)","change":-0.3,"period":"2026-04","previous":4.3,"is_aggregate":false},{"code":"MEX","name":"Mexico","rank":3,"rate":6.1,"trend":"rising (labour market loosening)","change":0.02,"period":"2026-04","previous":6.07,"is_aggregate":false},{"code":"DEU","name":"Germany","rank":4,"rate":7.2,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":7.3,"is_aggregate":false},{"code":"KOR","name":"Korea","rank":5,"rate":7.31,"trend":"rising (labour market loosening)","change":0.46,"period":"2026-04","previous":6.84,"is_aggregate":false},{"code":"LVA","name":"Latvia","rank":6,"rate":8.2,"trend":"rising (labour market loosening)","change":0.6,"period":"2026-04","previous":7.6,"is_aggregate":false},{"code":"NLD","name":"Netherlands","rank":7,"rate":8.7,"trend":"falling (labour market tightening)","change":-0.2,"period":"2026-04","previous":8.9,"is_aggregate":false},{"code":"USA","name":"United States","rank":8,"rate":9.4,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-05","previous":9.5,"is_aggregate":false},{"code":"AUT","name":"Austria","rank":9,"rate":9.5,"trend":"falling (labour market tightening)","change":-1.8,"period":"2026-04","previous":11.3,"is_aggregate":false},{"code":"IRL","name":"Ireland","rank":10,"rate":9.8,"trend":"falling (labour market tightening)","change":-1.4,"period":"2026-04","previous":11.2,"is_aggregate":false},{"code":"CZE","name":"Czechia","rank":11,"rate":9.9,"trend":"unchanged","change":0,"period":"2026-04","previous":9.9,"is_aggregate":false},{"code":"BGR","name":"Bulgaria","rank":13,"rate":11,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-04","previous":11.1,"is_aggregate":false},{"code":"AUS","name":"Australia","rank":14,"rate":11.1,"trend":"rising (labour market loosening)","change":0.86,"period":"2026-04","previous":10.24,"is_aggregate":false},{"code":"NOR","name":"Norway","rank":15,"rate":11.2,"trend":"falling (labour market tightening)","change":-3.7,"period":"2026-04","previous":14.9,"is_aggregate":false},{"code":"POL","name":"Poland","rank":17,"rate":12.4,"trend":"rising (labour market loosening)","change":0.3,"period":"2026-04","previous":12.1,"is_aggregate":false},{"code":"HUN","name":"Hungary","rank":18,"rate":12.8,"trend":"rising (labour market loosening)","change":0.2,"period":"2026-04","previous":12.6,"is_aggregate":false},{"code":"ISL","name":"Iceland","rank":19,"rate":12.9,"trend":"rising (labour market loosening)","change":0.1,"period":"2026-04","previous":12.8,"is_aggregate":false},{"code":"DNK","name":"Denmark","rank":20,"rate":12.9,"trend":"falling (labour market tightening)","change":-2.7,"period":"2026-04","previous":15.6,"is_aggregate":false},{"code":"CAN","name":"Canada","rank":21,"rate":13.4,"trend":"falling (labour market tightening)","change":-0.9,"period":"2026-05","previous":14.3,"is_aggregate":false},{"code":"SVN","name":"Slovenia","rank":22,"rate":14.2,"trend":"unchanged","change":0,"period":"2026-03","previous":14.2,"is_aggregate":false},{"code":"LTU","name":"Lithuania","rank":23,"rate":14.4,"trend":"falling (labour market tightening)","change":-1.3,"period":"2026-04","previous":15.7,"is_aggregate":false},{"code":"TUR","name":"Türkiye","rank":24,"rate":14.5,"trend":"falling (labour market tightening)","change":-0.8,"period":"2026-04","previous":15.3,"is_aggregate":false},{"code":"EA","name":"Euro area","rank":25,"rate":14.7,"trend":"falling (labour market tightening)","change":-0.4,"period":"2026-04","previous":15.1,"is_aggregate":false},{"code":"GBR","name":"United Kingdom","rank":27,"rate":15.8,"trend":"falling (labour market tightening)","change":-0.2,"period":"2026-01","previous":16,"is_aggregate":false},{"code":"CRI","name":"Costa Rica","rank":28,"rate":16.58,"trend":"falling (labour market tightening)","change":-1.05,"period":"2026-03","previous":17.63,"is_aggregate":false},{"code":"ITA","name":"Italy","rank":29,"rate":16.9,"trend":"falling (labour market tightening)","change":-0.8,"period":"2026-04","previous":17.7,"is_aggregate":false},{"code":"HRV","name":"Croatia","rank":30,"rate":17,"trend":"unchanged","change":0,"period":"2026-03","previous":17,"is_aggregate":false},{"code":"SVK","name":"Slovak Republic","rank":31,"rate":17.5,"trend":"unchanged","change":0,"period":"2026-04","previous":17.5,"is_aggregate":false},{"code":"PRT","name":"Portugal","rank":32,"rate":17.9,"trend":"falling (labour market tightening)","change":-1.1,"period":"2026-04","previous":19,"is_aggregate":false},{"code":"GRC","name":"Greece","rank":33,"rate":18.4,"trend":"falling (labour market tightening)","change":-6.9,"period":"2026-04","previous":25.3,"is_aggregate":false},{"code":"BEL","name":"Belgium","rank":34,"rate":18.7,"trend":"unchanged","change":0,"period":"2026-03","previous":18.7,"is_aggregate":false},{"code":"COL","name":"Colombia","rank":35,"rate":18.71,"trend":"falling (labour market tightening)","change":-0.15,"period":"2026-04","previous":18.86,"is_aggregate":false},{"code":"LUX","name":"Luxembourg","rank":36,"rate":20.3,"trend":"rising (labour market loosening)","change":0.1,"period":"2026-04","previous":20.2,"is_aggregate":false},{"code":"EST","name":"Estonia","rank":37,"rate":20.3,"trend":"rising (labour market loosening)","change":0.1,"period":"2026-04","previous":20.2,"is_aggregate":false},{"code":"FRA","name":"France","rank":38,"rate":21.4,"trend":"rising (labour market loosening)","change":0.2,"period":"2026-04","previous":21.2,"is_aggregate":false},{"code":"FIN","name":"Finland","rank":39,"rate":22.4,"trend":"rising (labour market loosening)","change":2.3,"period":"2026-04","previous":20.1,"is_aggregate":false},{"code":"CHL","name":"Chile","rank":40,"rate":23.08,"trend":"rising (labour market loosening)","change":0.26,"period":"2026-03","previous":22.82,"is_aggregate":false},{"code":"ESP","name":"Spain","rank":41,"rate":23.7,"trend":"falling (labour market tightening)","change":-0.5,"period":"2026-04","previous":24.2,"is_aggregate":false},{"code":"SWE","name":"Sweden","rank":42,"rate":24.6,"trend":"falling (labour market tightening)","change":-2.1,"period":"2026-04","previous":26.7,"is_aggregate":false},{"code":"ROU","name":"Romania","rank":43,"rate":28.8,"trend":"unchanged","change":0,"period":"2026-03","previous":28.8,"is_aggregate":false}],"count":40,"source":"OECD harmonised unemployment (SDMX), seasonally adjusted","indicator":"youth unemployment rate (15-24)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:37:44.473Z","request_id":"c202b415-ae71-4742-82ad-ede4433c0c7d"},"status":"ok","message":"Youth unemployment retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Country"],"summary":"Headline + youth unemployment for one economy with its rank","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-3 code or name","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"USA","name":"United States","note":"One economy's harmonised unemployment rate (headline 15+ and youth 15-24), seasonally adjusted, with the month-on-month change and its rank among tracked economies (1 = tightest labour market). Monthly, cached a few hours.","source":"OECD harmonised unemployment (SDMX)","is_aggregate":false,"unemployment_rate":{"of":43,"rank":12,"rate":4.3,"trend":"unchanged","change":0,"period":"2026-05"},"youth_unemployment_rate":{"of":43,"rank":8,"rate":9.4,"trend":"falling (labour market tightening)","change":-0.1,"period":"2026-05"}},"meta":{"timestamp":"2026-06-12T19:37:46.529Z","request_id":"a458c21d-44fd-446b-b8c1-362c53f218e1"},"status":"ok","message":"Country unemployment retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"board and youth take countries_only (true to drop aggregates). country takes country (ISO-3 code or name, required). meta takes no parameters. Rates are in percent of the labour force; rank 1 = lowest rate (tightest labour market). Monthly data; a multi-hour protective cache fronts the OECD upstream.","source":"OECD harmonised unemployment via OECD SDMX API (monthly, seasonally adjusted), live, keyless","service":"unemployment-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/board":"Headline (15+) unemployment rate for every economy, ranked tightest to loosest (countries_only optional).","GET /v1/youth":"Youth (15-24) unemployment rate for every economy, ranked.","GET /v1/country":"Headline + youth unemployment for one economy with its rank (country=USA)."},"description":"OECD harmonised unemployment — the monthly seasonally-adjusted unemployment rate of every major economy on one comparable screen, live from the OECD (no key). board returns the headline (15+) rate for every economy ranked from tightest to loosest labour market, with the month-on-month change and trend; youth returns the 15-24 rate the same way; country puts headline and youth together for one economy with its rank and recent direction. The labour-market / unemployment cut — distinct from the annual IMF World Economic Outlook (yearly figure and forecast, not the live monthly print), the inflation and bond-yield boards, and the generic data aggregator.","united_states":{"youth":9.4,"headline":4.3},"upstream_status":"ok","youth_economies":43,"headline_economies":43},"meta":{"timestamp":"2026-06-12T19:37:46.602Z","request_id":"6167f8cb-e6be-4481-b454-b43fce1bc42d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":785,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1220,"monthly_call_quota":17700,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3760,"monthly_call_quota":90500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8420,"monthly_call_quota":502000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/unemployment-api"}