# Consumer Inflation Expectations API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/consumersurvey-api/..." ``` ## Pricing - **Free** (Free) — 795 calls/Mo, 2 req/s - **Starter** ($12/Mo) — 16,900 calls/Mo, 6 req/s - **Pro** ($36/Mo) — 85,500 calls/Mo, 16 req/s - **Business** ($81/Mo) — 486,000 calls/Mo, 40 req/s ## Endpoints ### Inflation #### `GET /v1/inflation` — Economies ranked by consumer inflation expectations **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/consumersurvey-api/v1/inflation?countries_only=true" ``` **Response:** ```json { "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", …(truncated, see openapi.json for full schema) ``` ### Economy #### `GET /v1/economy` — Economies ranked by the consumer economic-situation outlook **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/consumersurvey-api/v1/economy?countries_only=true" ``` **Response:** ```json { "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, "per …(truncated, see openapi.json for full schema) ``` ### Country #### `GET /v1/country` — One economy's inflation-expectations and economic-situation balances **Parameters:** - `country` (query, required, string) — ISO-3 code or name Example: `USA` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/consumersurvey-api/v1/country?country=USA" ``` **Response:** ```json { "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 } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/consumersurvey-api/v1/meta" ``` **Response:** ```json { "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-expecta …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/consumersurvey-api OpenAPI spec: https://www.oanor.com/api/consumersurvey-api/openapi.json