{"openapi":"3.1.0","info":{"title":"Business Tendency Survey API","version":"1.0.0","description":"What manufacturers in each economy are actually reporting about their order books, output, prices, exports and hiring — the OECD business tendency surveys as an API, live, no key. Every month national statistics offices ask factory managers whether order books are full or thin, whether they expect to raise or cut production, whether they plan to put prices up, whether export demand is strong, and whether they will hire or fire. The OECD harmonises the answers into balances — the share answering up/good minus the share answering down/bad, on a scale around zero (positive = expansion/optimism, negative = contraction/pessimism). These survey balances are pure soft data that move before the hard numbers, which is why they are watched as one of the earliest reads on the manufacturing cycle — and the selling-price balance, in particular, is a leading signal of pipeline inflation. This API exposes the manufacturing survey components themselves, not just the composite confidence index: order books (current demand), production expectations, selling-price expectations, employment expectations and export order books. The country endpoint returns one economy's full survey panel with the month-on-month change in each balance. The orderbooks endpoint ranks every economy by its order-books balance (who has the fullest order books right now). The sellingprices endpoint ranks by the selling-price balance — the pipeline-inflation gauge, where firms are planning the biggest price rises. Each reading carries its own month and discontinued series are excluded, so the board is genuinely current. The business-survey-components cut — distinct from the composite Business & Consumer Confidence board (which gives only the headline index), the leading-indicator board, 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/businesssurvey-api","description":"oanor gateway"}],"tags":[{"name":"Country"},{"name":"Order books"},{"name":"Selling prices"},{"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/country":{"get":{"operationId":"get_v1_country","tags":["Country"],"summary":"One economy's full manufacturing survey panel","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-3 code or name","schema":{"type":"string"},"example":"DEU"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"DEU","name":"Germany","note":"One economy's manufacturing business-tendency survey panel: order books and export order books (current demand), and production, selling-price and employment expectations (forward-looking). Each is a percentage balance — positive means expansion/optimism (or, for selling prices, price rises planned), with the month-on-month change. Soft data that leads the hard numbers. Monthly, cached a few hours.","period":"2026-05","source":"OECD Business Tendency Surveys (SDMX), manufacturing","survey":{"order_books":{"change":-0.8,"balance":-28.7},"selling_prices":{"change":-2.3,"balance":30.9},"export_order_books":{"change":-3.1,"balance":-27.5},"employment_expectations":{"change":1.3,"balance":-19.2},"production_expectations":{"change":-1.7,"balance":-5.7}},"is_aggregate":false},"meta":{"timestamp":"2026-06-12T19:36:36.740Z","request_id":"cd7b551f-8035-455b-90ed-d71ee57449e6"},"status":"ok","message":"Country business 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/orderbooks":{"get":{"operationId":"get_v1_orderbooks","tags":["Order books"],"summary":"Economies ranked by the order-books balance (current demand)","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 manufacturing order-books balance — the share of factories reporting full order books minus those reporting thin ones. A positive balance means demand is strong; it leads production. Each row carries its own month; discontinued series excluded. Monthly, cached a few hours.","board":[{"code":"IRL","name":"Ireland","change":10.7,"period":"2026-05","balance":9.4,"is_aggregate":false},{"code":"USA","name":"United States","change":1,"period":"2026-05","balance":4,"is_aggregate":false},{"code":"GRC","name":"Greece","change":7,"period":"2026-05","balance":0.4,"is_aggregate":false},{"code":"HRV","name":"Croatia","change":3.2,"period":"2026-05","balance":-0.1,"is_aggregate":false},{"code":"BRA","name":"Brazil","change":3.7,"period":"2026-05","balance":-3.4,"is_aggregate":false},{"code":"NLD","name":"Netherlands","change":0.9,"period":"2026-05","balance":-5.2,"is_aggregate":false},{"code":"GBR","name":"United Kingdom","change":18.9,"period":"2026-05","balance":-7.2,"is_aggregate":false},{"code":"ESP","name":"Spain","change":2.1,"period":"2026-05","balance":-7.7,"is_aggregate":false},{"code":"CZE","name":"Czechia","change":2,"period":"2026-05","balance":-8.8,"is_aggregate":false},{"code":"SVK","name":"Slovak Republic","change":-10,"period":"2026-05","balance":-10,"is_aggregate":false},{"code":"ROU","name":"Romania","change":-0.4,"period":"2026-05","balance":-11.2,"is_aggregate":false},{"code":"PRT","name":"Portugal","change":-1.6,"period":"2026-05","balance":-11.4,"is_aggregate":false},{"code":"TUR","name":"Türkiye","change":1,"period":"2026-05","balance":-12.5,"is_aggregate":false},{"code":"SWE","name":"Sweden","change":0.2,"period":"2026-05","balance":-12.5,"is_aggregate":false},{"code":"FRA","name":"France","change":1,"period":"2026-05","balance":-13.8,"is_aggregate":false},{"code":"FIN","name":"Finland","change":-1.3,"period":"2026-05","balance":-14.2,"is_aggregate":false},{"code":"BGR","name":"Bulgaria","change":0.5,"period":"2026-05","balance":-18,"is_aggregate":false},{"code":"ITA","name":"Italy","change":0.8,"period":"2026-05","balance":-18.6,"is_aggregate":false},{"code":"SVN","name":"Slovenia","change":4.9,"period":"2026-05","balance":-20,"is_aggregate":false},{"code":"LVA","name":"Latvia","change":-0.7,"period":"2026-05","balance":-20.6,"is_aggregate":false},{"code":"CHE","name":"Switzerland","change":0.3,"period":"2026-05","balance":-21.1,"is_aggregate":false},{"code":"DNK","name":"Denmark","change":14.7,"period":"2026-05","balance":-23.1,"is_aggregate":false},{"code":"COL","name":"Colombia","change":2.7,"period":"2026-04","balance":-23.2,"is_aggregate":false},{"code":"BEL","name":"Belgium","change":1.6,"period":"2026-05","balance":-24.2,"is_aggregate":false},{"code":"HUN","name":"Hungary","change":2.7,"period":"2026-05","balance":-24.8,"is_aggregate":false},{"code":"DEU","name":"Germany","change":-0.8,"period":"2026-05","balance":-28.7,"is_aggregate":false},{"code":"EST","name":"Estonia","change":3.7,"period":"2026-04","balance":-28.9,"is_aggregate":false},{"code":"LTU","name":"Lithuania","change":0.3,"period":"2026-05","balance":-30.8,"is_aggregate":false},{"code":"CHL","name":"Chile","change":-6.8,"period":"2026-05","balance":-31.5,"is_aggregate":false},{"code":"AUT","name":"Austria","change":0.9,"period":"2026-05","balance":-31.7,"is_aggregate":false},{"code":"POL","name":"Poland","change":-1.7,"period":"2026-05","balance":-39.8,"is_aggregate":false},{"code":"LUX","name":"Luxembourg","change":-4.2,"period":"2026-05","balance":-40.7,"is_aggregate":false}],"count":32,"source":"OECD Business Tendency Surveys (SDMX), manufacturing, percentage balance, seasonally adjusted","indicator":"Manufacturing order books (survey balance)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:36:36.854Z","request_id":"13718756-ce07-4600-9589-14632266f62b"},"status":"ok","message":"Order books 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/sellingprices":{"get":{"operationId":"get_v1_sellingprices","tags":["Selling prices"],"summary":"Economies ranked by the selling-price balance (pipeline inflation)","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 selling-price-expectations balance — the share of factories planning to raise prices minus those planning to cut. A leading gauge of pipeline inflation: a rising balance flags price pressure building before it shows in the CPI. Each row carries its own month; discontinued series excluded. Monthly, cached a few hours.","board":[{"code":"LUX","name":"Luxembourg","change":17.8,"period":"2026-05","balance":57.2,"is_aggregate":false},{"code":"TUR","name":"Türkiye","change":-1.2,"period":"2026-05","balance":47.8,"is_aggregate":false},{"code":"COL","name":"Colombia","change":4.7,"period":"2026-04","balance":47.8,"is_aggregate":false},{"code":"CHL","name":"Chile","change":-9.8,"period":"2026-05","balance":42.7,"is_aggregate":false},{"code":"IRL","name":"Ireland","change":-20.4,"period":"2026-05","balance":40.7,"is_aggregate":false},{"code":"FIN","name":"Finland","change":2,"period":"2026-05","balance":36,"is_aggregate":false},{"code":"ROU","name":"Romania","change":-3.7,"period":"2026-05","balance":33.3,"is_aggregate":false},{"code":"DEU","name":"Germany","change":-2.3,"period":"2026-05","balance":30.9,"is_aggregate":false},{"code":"BEL","name":"Belgium","change":2.6,"period":"2026-05","balance":30.5,"is_aggregate":false},{"code":"PRT","name":"Portugal","change":0.7,"period":"2026-05","balance":29.2,"is_aggregate":false},{"code":"HUN","name":"Hungary","change":3.3,"period":"2026-05","balance":29,"is_aggregate":false},{"code":"EST","name":"Estonia","change":13.8,"period":"2026-04","balance":29,"is_aggregate":false},{"code":"NLD","name":"Netherlands","change":2,"period":"2026-05","balance":28.1,"is_aggregate":false},{"code":"HRV","name":"Croatia","change":-2.3,"period":"2026-05","balance":27.1,"is_aggregate":false},{"code":"GRC","name":"Greece","change":-1.5,"period":"2026-05","balance":26.2,"is_aggregate":false},{"code":"ITA","name":"Italy","change":0.1,"period":"2026-05","balance":24.9,"is_aggregate":false},{"code":"SWE","name":"Sweden","change":1.9,"period":"2026-05","balance":24.5,"is_aggregate":false},{"code":"AUT","name":"Austria","change":-8.7,"period":"2026-05","balance":23.8,"is_aggregate":false},{"code":"CZE","name":"Czechia","change":-6.1,"period":"2026-05","balance":23.1,"is_aggregate":false},{"code":"GBR","name":"United Kingdom","change":16,"period":"2026-05","balance":22,"is_aggregate":false},{"code":"SVN","name":"Slovenia","change":-3.9,"period":"2026-05","balance":20.6,"is_aggregate":false},{"code":"LTU","name":"Lithuania","change":0,"period":"2026-05","balance":20.5,"is_aggregate":false},{"code":"FRA","name":"France","change":3.9,"period":"2026-05","balance":20.2,"is_aggregate":false},{"code":"DNK","name":"Denmark","change":-10.1,"period":"2026-05","balance":19.8,"is_aggregate":false},{"code":"LVA","name":"Latvia","change":-2.8,"period":"2026-05","balance":19.6,"is_aggregate":false},{"code":"ESP","name":"Spain","change":-9.8,"period":"2026-05","balance":18.8,"is_aggregate":false},{"code":"BGR","name":"Bulgaria","change":-5.4,"period":"2026-05","balance":16.3,"is_aggregate":false},{"code":"POL","name":"Poland","change":-2.1,"period":"2026-05","balance":14.6,"is_aggregate":false},{"code":"CHE","name":"Switzerland","change":-4.3,"period":"2026-05","balance":14.3,"is_aggregate":false},{"code":"SVK","name":"Slovak Republic","change":-9,"period":"2026-05","balance":14,"is_aggregate":false},{"code":"KOR","name":"Korea","change":-1,"period":"2026-05","balance":10,"is_aggregate":false},{"code":"ISR","name":"Israel","change":0.1,"period":"2026-05","balance":4.6,"is_aggregate":false}],"count":32,"source":"OECD Business Tendency Surveys (SDMX), manufacturing, percentage balance, seasonally adjusted","indicator":"Manufacturing selling-price expectations (survey balance)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:36:36.944Z","request_id":"0d561ea4-1a45-4a54-92be-cf4cdc905793"},"status":"ok","message":"Selling prices 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/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":"orderbooks and sellingprices take countries_only (true to drop aggregates). country takes country (ISO-3 code or name, required) and returns the full survey panel. meta takes no parameters. Balances are percentage points around zero (positive = expansion/optimism); the change is month-on-month. Monthly data; a multi-hour protective cache fronts the OECD upstream.","source":"OECD Business Tendency Surveys (DF_BTS, manufacturing) via OECD SDMX API, percentage balance, seasonally adjusted, live, keyless","germany":{"period":"2026-05","order_books":-28.7,"selling_prices":30.9},"service":"businesssurvey-api","economies":35,"endpoints":{"GET /v1/meta":"This document.","GET /v1/country":"One economy's full manufacturing survey panel (country=DEU).","GET /v1/orderbooks":"Economies ranked by the order-books balance (current demand).","GET /v1/sellingprices":"Economies ranked by the selling-price balance (pipeline inflation)."},"description":"Business tendency survey — what manufacturers report about order books, output, prices, exports and hiring, live from the OECD's business surveys (no key). It exposes the manufacturing survey components as percentage balances: order books, production expectations, selling-price expectations, employment expectations and export order books. country returns one economy's full survey panel; orderbooks ranks economies by the order-books balance (current demand); sellingprices ranks by the selling-price balance (a leading pipeline-inflation gauge). Soft data that leads the hard numbers. The survey-components cut — distinct from the composite Business & Consumer Confidence board (only the headline index), the leading-indicator board, and the generic data aggregator.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T19:36:37.043Z","request_id":"90c0bdd6-cb84-4b88-9a1b-a5fb9f959a71"},"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":760,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1260,"monthly_call_quota":16300,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3920,"monthly_call_quota":84000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8720,"monthly_call_quota":480000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/businesssurvey-api"}