{"openapi":"3.1.0","info":{"title":"OECD Economic Indicators API","version":"1.0.0","description":"Key macroeconomic indicators for the 38 OECD member countries, sourced from the official OECD SDMX data service. Pull the harmonised unemployment rate, the consumer price index and the long-term (10-year government bond) interest rate for any member country, look up a single indicator for one country, or read a full country snapshot with all indicators at once. Every value carries the indicator label, its unit and the exact period it refers to, and always resolves to the latest published observation — no date juggling. Coverage spans Australia to the United States, with the United Kingdom, Germany, Japan, France and every other OECD member in between. Built for dashboards, macro research and currency or rates models that need authoritative, comparable cross-country economic data. Distinct from market and FX feeds: this surfaces official OECD statistics.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/oecd-api","description":"oanor gateway"}],"tags":[{"name":"Reference"},{"name":"Indicators"},{"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/countries":{"get":{"operationId":"get_v1_countries","tags":["Reference"],"summary":"List supported OECD countries","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":38,"countries":[{"code":"AUS","name":"Australia"},{"code":"AUT","name":"Austria"},{"code":"BEL","name":"Belgium"},{"code":"CAN","name":"Canada"},{"code":"CHL","name":"Chile"},{"code":"COL","name":"Colombia"},{"code":"CRI","name":"Costa Rica"},{"code":"CZE","name":"Czechia"},{"code":"DNK","name":"Denmark"},{"code":"EST","name":"Estonia"},{"code":"FIN","name":"Finland"},{"code":"FRA","name":"France"},{"code":"DEU","name":"Germany"},{"code":"GRC","name":"Greece"},{"code":"HUN","name":"Hungary"},{"code":"ISL","name":"Iceland"},{"code":"IRL","name":"Ireland"},{"code":"ISR","name":"Israel"},{"code":"ITA","name":"Italy"},{"code":"JPN","name":"Japan"},{"code":"KOR","name":"Korea"},{"code":"LVA","name":"Latvia"},{"code":"LTU","name":"Lithuania"},{"code":"LUX","name":"Luxembourg"},{"code":"MEX","name":"Mexico"},{"code":"NLD","name":"Netherlands"},{"code":"NZL","name":"New Zealand"},{"code":"NOR","name":"Norway"},{"code":"POL","name":"Poland"},{"code":"PRT","name":"Portugal"},{"code":"SVK","name":"Slovak Republic"},{"code":"SVN","name":"Slovenia"},{"code":"ESP","name":"Spain"},{"code":"SWE","name":"Sweden"},{"code":"CHE","name":"Switzerland"},{"code":"TUR","name":"Türkiye"},{"code":"GBR","name":"United Kingdom"},{"code":"USA","name":"United States"}]},"meta":{"timestamp":"2026-06-15T11:15:01.744Z","request_id":"0350da1e-3bfc-4b61-9744-67655a491ec7"},"status":"ok","message":"Countries 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/indicators":{"get":{"operationId":"get_v1_indicators","tags":["Reference"],"summary":"List available indicators","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"indicators":[{"code":"unemployment_rate","unit":"% of labour force","label":"Harmonised unemployment rate (monthly)"},{"code":"cpi_index","unit":"index","label":"Consumer Price Index (all items, monthly)"},{"code":"long_term_interest_rate","unit":"% per annum","label":"Long-term interest rate (10-year government bonds, monthly)"}]},"meta":{"timestamp":"2026-06-15T11:15:01.827Z","request_id":"5dd6e3cd-1bb0-486b-9d2c-1695d8bf1e1b"},"status":"ok","message":"Indicators 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/indicator":{"get":{"operationId":"get_v1_indicator","tags":["Indicators"],"summary":"Latest value of one indicator for a country","description":"","parameters":[{"name":"code","in":"query","required":false,"description":"Indicator code","schema":{"type":"string"},"example":"unemployment_rate"},{"name":"country","in":"query","required":false,"description":"OECD country (ISO3)","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"unit":"% of labour force","label":"Harmonised unemployment rate (monthly)","value":4.3,"period":"2026-05","source":"OECD","country":"USA","indicator":"unemployment_rate","country_name":"United States"},"meta":{"timestamp":"2026-06-15T11:15:05.101Z","request_id":"4d71e190-39a0-40a2-ad1d-9ace8256a1d3"},"status":"ok","message":"Indicator 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/snapshot":{"get":{"operationId":"get_v1_snapshot","tags":["Indicators"],"summary":"All indicators for one country","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"OECD country (ISO3)","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"OECD","country":"USA","indicators":[{"unit":"% of labour force","label":"Harmonised unemployment rate (monthly)","value":4.3,"period":"2026-05","indicator":"unemployment_rate"},{"unit":"index","label":"Consumer Price Index (all items, monthly)","value":141.392,"period":"2026-05","indicator":"cpi_index"},{"unit":"% per annum","label":"Long-term interest rate (10-year government bonds, monthly)","value":4.48,"period":"2026-05","indicator":"long_term_interest_rate"}],"country_name":"United States"},"meta":{"timestamp":"2026-06-15T11:15:07.836Z","request_id":"2776d3c8-0a55-4c56-b2b4-8be8bfbd3490"},"status":"ok","message":"Snapshot 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":{"name":"OECD Economic Indicators API","source":"OECD SDMX Data API (sdmx.oecd.org)","endpoints":[{"path":"/v1/indicators","description":"List available indicators"},{"path":"/v1/countries","description":"List supported OECD countries"},{"path":"/v1/indicator","description":"Latest value of one indicator for one country (?code=unemployment_rate&country=USA)"},{"path":"/v1/snapshot","description":"All indicators for one country (?country=USA)"},{"path":"/v1/meta","description":"This metadata document"}],"disclaimer":"Unofficial proxy of the public OECD SDMX data API. Not affiliated with the OECD. Data only; refer to OECD for authoritative figures.","indicators":["unemployment_rate","cpi_index","long_term_interest_rate"],"description":"Key macroeconomic indicators for OECD member countries, sourced from the official OECD SDMX data API: harmonised unemployment rate, consumer price index and long-term (10-year government bond) interest rate. Values always resolve to the latest published period."},"meta":{"timestamp":"2026-06-15T11:15:07.934Z","request_id":"6789d2de-5370-424c-980d-493d817b3db4"},"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":1840,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1340,"monthly_call_quota":54700,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3560,"monthly_call_quota":218000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":8120,"monthly_call_quota":896000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/oecd-api"}