{"openapi":"3.1.0","info":{"title":"Consumer Inflation Expectations API","version":"1.0.0","description":"What households in each economy expect for prices and for the wider economy — the OECD consumer surveys as an API, live, no key. Every month consumers are asked whether they expect prices to rise faster or slower over the year ahead, and whether they think the general economic situation will improve or worsen. The OECD harmonises the answers into balances — the share answering up/better minus the share answering down/worse, on a scale around zero. Consumer inflation expectations are one of the most closely watched soft indicators in central banking: if households start expecting higher inflation, they bring forward purchases and demand higher wages, which can make inflation self-fulfilling, so policymakers track whether expectations stay anchored. The economic-situation balance is the household read on where the economy is heading, and it leads consumer spending. The inflation endpoint ranks every economy by its consumer inflation-expectations balance — where households most expect prices to climb. The economy endpoint ranks by the economic-situation outlook. The country endpoint gives one economy's inflation and economic-situation balances side by side with the month-on-month change. Each reading carries its own month and discontinued series are excluded, so the board is genuinely current. The consumer-survey / inflation-expectations cut — distinct from the composite Business & Consumer Confidence board (which gives only the headline confidence index, not the inflation-expectations component), the manufacturing business-survey board, the realised-inflation feeds, and the generic multi-provider data aggregator. Balances are in percentage points; figures are monthly.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/consumersurvey-api","description":"oanor gateway"}],"tags":[{"name":"Inflation"},{"name":"Economy"},{"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/inflation":{"get":{"operationId":"get_v1_inflation","tags":["Inflation"],"summary":"Economies ranked by consumer inflation expectations","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":"Economies ranked by the consumer inflation-expectations balance — the share of households expecting prices to rise faster over the next year minus those expecting them to rise more slowly. The higher the balance, the more inflation households are bracing for; central banks watch this closely because unanchored expectations can make inflation self-fulfilling. Each row carries its own month; discontinued series excluded. Monthly, cached a few hours.","board":[{"code":"AUS","name":"Australia","change":2,"period":"2026-05","balance":66,"is_aggregate":false},{"code":"COL","name":"Colombia","change":-1.8,"period":"2026-04","balance":59.5,"is_aggregate":false},{"code":"PRT","name":"Portugal","change":-9.2,"period":"2026-05","balance":58.5,"is_aggregate":false},{"code":"NLD","name":"Netherlands","change":-11.4,"period":"2026-05","balance":56.1,"is_aggregate":false},{"code":"SVN","name":"Slovenia","change":-15.4,"period":"2026-05","balance":55.2,"is_aggregate":false},{"code":"GRC","name":"Greece","change":-1.2,"period":"2026-05","balance":53.3,"is_aggregate":false},{"code":"LUX","name":"Luxembourg","change":1.9,"period":"2026-05","balance":53,"is_aggregate":false},{"code":"TUR","name":"Türkiye","change":4.4,"period":"2026-05","balance":52.7,"is_aggregate":false},{"code":"EST","name":"Estonia","change":8.9,"period":"2026-04","balance":52.6,"is_aggregate":false},{"code":"KOR","name":"Korea","change":-2,"period":"2026-05","balance":51,"is_aggregate":false},{"code":"LTU","name":"Lithuania","change":-7.4,"period":"2026-05","balance":49.5,"is_aggregate":false},{"code":"LVA","name":"Latvia","change":-6.5,"period":"2026-05","balance":48.2,"is_aggregate":false},{"code":"BEL","name":"Belgium","change":-6,"period":"2026-05","balance":43.5,"is_aggregate":false},{"code":"FRA","name":"France","change":-8.4,"period":"2026-05","balance":42.6,"is_aggregate":false},{"code":"DEU","name":"Germany","change":-7.9,"period":"2026-05","balance":42.6,"is_aggregate":false},{"code":"IRL","name":"Ireland","change":-18.3,"period":"2026-05","balance":41.4,"is_aggregate":false},{"code":"DNK","name":"Denmark","change":-3,"period":"2026-05","balance":40.8,"is_aggregate":false},{"code":"GBR","name":"United Kingdom","change":2.8,"period":"2026-05","balance":35.9,"is_aggregate":false},{"code":"SVK","name":"Slovak Republic","change":-2.5,"period":"2026-05","balance":35.6,"is_aggregate":false},{"code":"HRV","name":"Croatia","change":0.3,"period":"2026-05","balance":35,"is_aggregate":false},{"code":"ROU","name":"Romania","change":-9.9,"period":"2026-05","balance":34.9,"is_aggregate":false},{"code":"AUT","name":"Austria","change":-8.9,"period":"2026-05","balance":34.1,"is_aggregate":false},{"code":"FIN","name":"Finland","change":-7,"period":"2026-05","balance":33.1,"is_aggregate":false},{"code":"ESP","name":"Spain","change":-1.8,"period":"2026-05","balance":32.1,"is_aggregate":false},{"code":"CZE","name":"Czechia","change":-1.2,"period":"2026-05","balance":28.4,"is_aggregate":false},{"code":"ITA","name":"Italy","change":-14.6,"period":"2026-05","balance":26.3,"is_aggregate":false},{"code":"POL","name":"Poland","change":-4.7,"period":"2026-05","balance":24.7,"is_aggregate":false},{"code":"SWE","name":"Sweden","change":-5.7,"period":"2026-05","balance":21.8,"is_aggregate":false},{"code":"BGR","name":"Bulgaria","change":-7.9,"period":"2026-05","balance":18.6,"is_aggregate":false},{"code":"USA","name":"United States","change":0.7,"period":"2026-05","balance":8.3,"is_aggregate":false},{"code":"HUN","name":"Hungary","change":-16,"period":"2026-05","balance":7.5,"is_aggregate":false}],"count":31,"source":"OECD Consumer Opinion Surveys (SDMX), percentage balance, seasonally adjusted","indicator":"Consumer inflation expectations (survey balance)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:36:33.594Z","request_id":"0559b701-269a-4a89-91ba-86c3df2e49d5"},"status":"ok","message":"Consumer inflation expectations 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/economy":{"get":{"operationId":"get_v1_economy","tags":["Economy"],"summary":"Economies ranked by the consumer economic-situation outlook","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":"Economies ranked by the consumer economic-situation balance — the share of households expecting the general economy to improve over the next year minus those expecting it to worsen. A positive balance means households are optimistic; it leads consumer spending. Each row carries its own month; discontinued series excluded. Monthly, cached a few hours.","board":[{"code":"CHN","name":"China (People’s Republic of)","change":-0.6,"period":"2026-04","balance":90.5,"is_aggregate":false},{"code":"MEX","name":"Mexico","change":-1.6,"period":"2026-05","balance":43.3,"is_aggregate":false},{"code":"CHL","name":"Chile","change":1.2,"period":"2026-05","balance":41.3,"is_aggregate":false},{"code":"HUN","name":"Hungary","change":27,"period":"2026-05","balance":10.5,"is_aggregate":false},{"code":"COL","name":"Colombia","change":-10.5,"period":"2026-04","balance":9.2,"is_aggregate":false},{"code":"KOR","name":"Korea","change":14,"period":"2026-05","balance":-7,"is_aggregate":false},{"code":"CZE","name":"Czechia","change":3,"period":"2026-05","balance":-13.3,"is_aggregate":false},{"code":"SWE","name":"Sweden","change":2.4,"period":"2026-05","balance":-14.2,"is_aggregate":false},{"code":"LTU","name":"Lithuania","change":6.7,"period":"2026-05","balance":-16.2,"is_aggregate":false},{"code":"TUR","name":"Türkiye","change":3.1,"period":"2026-05","balance":-18.6,"is_aggregate":false},{"code":"POL","name":"Poland","change":2.9,"period":"2026-05","balance":-20.9,"is_aggregate":false},{"code":"FIN","name":"Finland","change":1.2,"period":"2026-05","balance":-22,"is_aggregate":false},{"code":"ESP","name":"Spain","change":0,"period":"2026-05","balance":-22.4,"is_aggregate":false},{"code":"AUS","name":"Australia","change":-1,"period":"2026-05","balance":-26,"is_aggregate":false},{"code":"DNK","name":"Denmark","change":0,"period":"2026-05","balance":-28.3,"is_aggregate":false},{"code":"HRV","name":"Croatia","change":4.4,"period":"2026-05","balance":-29.2,"is_aggregate":false},{"code":"ISR","name":"Israel","change":-3.6,"period":"2026-04","balance":-29.5,"is_aggregate":false},{"code":"LUX","name":"Luxembourg","change":3.6,"period":"2026-05","balance":-29.9,"is_aggregate":false},{"code":"BGR","name":"Bulgaria","change":5.4,"period":"2026-05","balance":-31.3,"is_aggregate":false},{"code":"LVA","name":"Latvia","change":1.4,"period":"2026-05","balance":-31.7,"is_aggregate":false},{"code":"ROU","name":"Romania","change":11.3,"period":"2026-05","balance":-33.2,"is_aggregate":false},{"code":"AUT","name":"Austria","change":4.4,"period":"2026-05","balance":-33.9,"is_aggregate":false},{"code":"DEU","name":"Germany","change":1.7,"period":"2026-05","balance":-34.7,"is_aggregate":false},{"code":"SVN","name":"Slovenia","change":6.3,"period":"2026-05","balance":-34.8,"is_aggregate":false},{"code":"ITA","name":"Italy","change":5.3,"period":"2026-05","balance":-35.6,"is_aggregate":false},{"code":"GBR","name":"United Kingdom","change":5,"period":"2026-05","balance":-38,"is_aggregate":false},{"code":"BEL","name":"Belgium","change":2.3,"period":"2026-05","balance":-39.4,"is_aggregate":false},{"code":"IRL","name":"Ireland","change":9.9,"period":"2026-05","balance":-40.3,"is_aggregate":false},{"code":"SVK","name":"Slovak Republic","change":3.4,"period":"2026-05","balance":-42.9,"is_aggregate":false},{"code":"NLD","name":"Netherlands","change":8.3,"period":"2026-05","balance":-45.5,"is_aggregate":false},{"code":"PRT","name":"Portugal","change":6.3,"period":"2026-05","balance":-46,"is_aggregate":false},{"code":"EST","name":"Estonia","change":-7.4,"period":"2026-04","balance":-49.8,"is_aggregate":false},{"code":"USA","name":"United States","change":-6,"period":"2026-05","balance":-51,"is_aggregate":false},{"code":"FRA","name":"France","change":2.8,"period":"2026-05","balance":-51.5,"is_aggregate":false},{"code":"GRC","name":"Greece","change":1.1,"period":"2026-05","balance":-58.1,"is_aggregate":false}],"count":35,"source":"OECD Consumer Opinion Surveys (SDMX), percentage balance, seasonally adjusted","indicator":"Consumer economic-situation outlook (survey balance)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:36:33.686Z","request_id":"d2531850-ed01-487f-8dc5-e0dc6de78eb1"},"status":"ok","message":"Consumer economic outlook 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":"One economy's inflation-expectations and economic-situation balances","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 consumer survey: the inflation-expectations balance (how much households expect prices to rise over the year ahead) and the economic-situation balance (whether they expect the economy to improve), each a percentage balance around zero with the month-on-month change. Soft data that leads consumer spending and informs central-bank policy. Monthly, cached a few hours.","period":"2026-05","source":"OECD Consumer Opinion Surveys (SDMX)","is_aggregate":false,"economic_situation":{"change":-6,"balance":-51},"inflation_expectations":{"change":0.7,"balance":8.3}},"meta":{"timestamp":"2026-06-12T19:36:33.811Z","request_id":"798eb911-f464-400e-8764-b345254f5aee"},"status":"ok","message":"Country consumer survey 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":"inflation and economy take countries_only (true to drop aggregates such as the euro area). country takes country (ISO-3 code or name, required). meta takes no parameters. Balances are percentage points around zero (higher inflation balance = more price rises expected; higher economy balance = more optimism); the change is month-on-month. Monthly data; a multi-hour protective cache fronts the OECD upstream.","source":"OECD Consumer Opinion Surveys (DF_CS, consumer prices IN + economic situation ES) via OECD SDMX API, percentage balance, seasonally adjusted, live, keyless","service":"consumersurvey-api","economies":37,"endpoints":{"GET /v1/meta":"This document.","GET /v1/country":"One economy's inflation-expectations and economic-situation balances (country=USA).","GET /v1/economy":"Economies ranked by the consumer economic-situation outlook.","GET /v1/inflation":"Economies ranked by consumer inflation expectations (countries_only optional)."},"description":"Consumer inflation expectations & economic outlook — what households expect for prices and the economy, live from the OECD's consumer surveys (no key). It exposes two survey balances: consumer inflation expectations (the central-bank-watched gauge of whether households expect faster price rises) and the economic-situation outlook. inflation ranks economies by inflation-expectations balance; economy ranks by economic-situation balance; country gives one economy's both balances. The consumer-survey / inflation-expectations cut — distinct from the composite Business & Consumer Confidence board (only the headline index, not the inflation-expectations component), the manufacturing business survey, and the realised-inflation feeds.","united_states":{"period":"2026-05","economic_situation":-51,"inflation_expectations":8.3},"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T19:36:33.914Z","request_id":"40157927-780d-4cbb-a9dd-29eb0f8f3bef"},"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":795,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1210,"monthly_call_quota":16900,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3600,"monthly_call_quota":85500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8120,"monthly_call_quota":486000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/consumersurvey-api"}