{ "openapi": "3.0.1", "info": { "title": "Trading Economics Scraper", "description": "Scrape live macro/finance data from tradingeconomics.com - commodities, currencies, stock indices, government bond yields, crypto prices, country-by-country economic indicators (GDP, inflation, unemployment...), global indicator rankings, and the economic calendar.", "version": "1.0", "x-build-id": "UmokB3Xe7BexI9XEA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~trading-economics-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-trading-economics-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~trading-economics-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-trading-economics-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~trading-economics-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-trading-economics-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "markets", "countryIndicators", "indicatorRanking", "calendar", "countryForecast", "holidays", "earningsCalendar" ], "type": "string", "description": "Which data surface to scrape.", "default": "markets" }, "marketType": { "title": "Market type (mode=markets)", "enum": [ "commodities", "currencies", "stocks", "bonds", "crypto", "shares" ], "type": "string", "description": "Which live market table to scrape.", "default": "commodities" }, "category": { "title": "Category / region (mode=markets)", "enum": [ "", "Energy", "Metals", "Agricultural", "Industrial", "Livestock", "Index", "Electricity", "Major", "Europe", "America", "Asia", "Oceania", "Africa", "Crypto", "BTC", "ETH", "Top Gainers", "Top Losers" ], "type": "string", "description": "Restrict the market table to one category or region. Options depend on marketType: commodities -> Energy/Metals/Agricultural/Industrial/Livestock/Index/Electricity; currencies, stocks, bonds -> Major/Europe/America/Asia/Oceania/Africa; crypto -> Crypto (USD pairs) / BTC pairs / ETH pairs; shares -> Top Gainers / Top Losers. Leave unset for all rows across every category/region.", "default": "" }, "country": { "title": "Country (mode=countryIndicators, calendar, countryForecast, holidays, earningsCalendar)", "enum": [ "", "afghanistan", "albania", "algeria", "andorra", "angola", "antigua-and-barbuda", "argentina", "armenia", "aruba", "australia", "austria", "azerbaijan", "bahamas", "bahrain", "bangladesh", "barbados", "belarus", "belgium", "belize", "benin", "bermuda", "bhutan", "bolivia", "bosnia-and-herzegovina", "botswana", "brazil", "brunei", "bulgaria", "burkina-faso", "burundi", "cambodia", "cameroon", "canada", "cape-verde", "cayman-islands", "central-african-republic", "chad", "chile", "china", "colombia", "comoros", "congo", "costa-rica", "croatia", "cuba", "cyprus", "czech-republic", "denmark", "djibouti", "dominica", "dominican-republic", "east-timor", "ecuador", "egypt", "el-salvador", "equatorial-guinea", "eritrea", "estonia", "ethiopia", "euro-area", "faroe-islands", "fiji", "finland", "france", "gabon", "gambia", "georgia", "germany", "ghana", "greece", "grenada", "guatemala", "guinea", "guinea-bissau", "guyana", "haiti", "honduras", "hong-kong", "hungary", "iceland", "india", "indonesia", "iran", "iraq", "ireland", "isle-of-man", "israel", "italy", "ivory-coast", "jamaica", "japan", "jordan", "kazakhstan", "kenya", "kiribati", "kosovo", "kuwait", "kyrgyzstan", "laos", "latvia", "lebanon", "lesotho", "liberia", "libya", "liechtenstein", "lithuania", "luxembourg", "macau", "macedonia", "madagascar", "malawi", "malaysia", "maldives", "mali", "malta", "mauritania", "mauritius", "mexico", "moldova", "monaco", "mongolia", "montenegro", "morocco", "mozambique", "myanmar", "namibia", "nepal", "netherlands", "new-caledonia", "new-zealand", "nicaragua", "niger", "nigeria", "north-korea", "norway", "oman", "pakistan", "palestine", "panama", "papua-new-guinea", "paraguay", "peru", "philippines", "poland", "portugal", "puerto-rico", "qatar", "republic-of-the-congo", "romania", "russia", "rwanda", "samoa", "sao-tome-and-principe", "saudi-arabia", "senegal", "serbia", "seychelles", "sierra-leone", "singapore", "slovakia", "slovenia", "solomon-islands", "somalia", "south-africa", "south-korea", "south-sudan", "spain", "sri-lanka", "sudan", "suriname", "swaziland", "sweden", "switzerland", "syria", "taiwan", "tajikistan", "tanzania", "thailand", "togo", "tonga", "trinidad-and-tobago", "tunisia", "turkey", "turkmenistan", "uganda", "ukraine", "united-arab-emirates", "united-kingdom", "united-states", "uruguay", "uzbekistan", "vanuatu", "venezuela", "vietnam", "yemen", "zambia", "zimbabwe" ], "type": "string", "description": "Country to fetch indicators, calendar events, forecasts, public holidays or the earnings calendar for. Required for mode=countryIndicators, mode=countryForecast and mode=earningsCalendar. Optional for mode=calendar and mode=holidays (omit for the global calendar / global holiday list).", "default": "" }, "indicatorCategory": { "title": "Indicator category (mode=countryIndicators, countryForecast)", "enum": [ "", "overview", "gdp", "labour", "prices", "money", "trade", "government", "business", "consumer", "housing", "energy", "health", "markets" ], "type": "string", "description": "Restrict country indicators or forecasts to one category. `markets` (currency / stock market / 10Y bond yield forecast) and `health` are not both available in every mode: `health` only appears for mode=countryIndicators, `markets` only for mode=countryForecast. Leave unset for all categories.", "default": "" }, "indicator": { "title": "Indicator (mode=indicatorRanking)", "enum": [ "interest-rate", "inflation-rate", "unemployment-rate", "gdp-growth-rate", "gdp-per-capita", "current-account-to-gdp", "gold-reserves", "government-debt-to-gdp", "crude-oil-production", "gasoline-prices", "rating", "asylum-applications", "average-annual-wages", "balance-of-trade", "bank-lending-rate", "bankruptcies", "banks-balance-sheet", "building-permits", "business-confidence", "capacity-utilization", "capital-flows", "car-production", "car-registrations", "cash-reserve-ratio", "cement-production", "central-bank-balance-sheet", "changes-in-inventories", "co2-emissions", "construction-output", "consumer-confidence", "consumer-credit", "consumer-price-index-cpi", "consumer-spending", "core-consumer-prices", "core-inflation-rate", "corporate-profits", "corporate-tax-rate", "corruption-index", "corruption-rank", "cpi-housing-utilities", "crude-oil-rigs", "current-account", "deposit-interest-rate", "disposable-personal-income", "electric-car-registrations", "electricity-production", "employed-persons", "employment-change", "employment-change-yoy", "employment-rate", "export-prices", "exports", "external-debt", "factory-orders", "fiscal-expenditure", "food-inflation", "foreign-direct-investment", "foreign-exchange-reserves", "full-time-employment", "full-year-gdp-growth", "gdp", "gdp-annual-growth-rate", "gdp-constant-prices", "gdp-deflator", "gdp-from-agriculture", "gdp-from-construction", "gdp-from-manufacturing", "gdp-from-mining", "gdp-from-public-administration", "gdp-from-services", "gdp-from-transport", "gdp-from-utilities", "gdp-per-capita-ppp", "government-budget", "government-budget-value", "government-debt", "government-revenues", "government-spending", "government-spending-to-gdp", "gross-average-monthly-wages", "gross-fixed-capital-formation", "gross-national-product", "harmonised-consumer-prices", "harmonised-inflation-rate-mom", "harmonised-inflation-rate-yoy", "home-ownership-rate", "hospital-beds", "hospitals", "households-debt-to-gdp", "households-debt-to-income", "housing-index", "housing-starts", "icu-beds", "import-prices", "imports", "industrial-production", "industrial-production-mom", "inflation-expectations", "inflation-rate-mom", "initial-jobless-claims", "interbank-rate", "job-vacancies", "labor-force-participation-rate", "labour-costs", "leading-economic-index", "lending-rate", "loan-growth", "loans-to-private-sector", "long-term-unemployment-rate", "manufacturing-production", "medical-doctors", "military-expenditure", "minimum-wages", "mining-production", "money-supply-m0", "money-supply-m1", "money-supply-m2", "money-supply-m3", "natural-gas-stocks-capacity", "natural-gas-stocks-injection", "natural-gas-stocks-inventory", "natural-gas-stocks-withdrawal", "new-orders", "non-farm-payrolls", "nurses", "part-time-employment", "personal-income-tax-rate", "personal-savings", "personal-spending", "population", "precipitation", "price-to-rent-ratio", "private-debt-to-gdp", "private-sector-credit", "producer-price-inflation-mom", "producer-prices", "producer-prices-change", "productivity", "remittances", "residential-property-prices", "retail-sales-mom", "retail-sales-yoy", "retirement-age-men", "retirement-age-women", "sales-tax-rate", "small-business-sentiment", "social-security-rate", "social-security-rate-for-companies", "social-security-rate-for-employees", "steel-production", "temperature", "terms-of-trade", "terrorism-index", "total-vehicle-sales", "tourism-revenues", "tourist-arrivals", "unemployed-persons", "wage-growth", "wages", "wages-in-manufacturing", "weapons-sales", "youth-unemployment-rate", "zew-economic-sentiment-index" ], "type": "string", "description": "Economic indicator to rank across all countries (163 indicators covering macro, labour, trade, prices, health, demographics and more).", "default": "interest-rate" }, "searchKeyword": { "title": "Keyword filter", "type": "string", "description": "Case-insensitive substring match against the record name (commodity/pair/index/indicator/event/holiday/company name). Leave blank for no filtering." }, "minChangePercent": { "title": "Min daily % change (mode=markets)", "minimum": -1000, "maximum": 1000, "type": "number", "description": "Only keep instruments whose daily percent change is at least this value (e.g. -100 to 100). Uses whole percent; enter -5 for -5%." }, "maxChangePercent": { "title": "Max daily % change (mode=markets)", "minimum": -1000, "maximum": 1000, "type": "number", "description": "Only keep instruments whose daily percent change is at most this value." }, "dateFrom": { "title": "Date from (mode=calendar, holidays, earningsCalendar)", "type": "string", "description": "ISO date (YYYY-MM-DD). Only keep calendar events / holidays / earnings releases on/after this date." }, "dateTo": { "title": "Date to (mode=calendar, holidays, earningsCalendar)", "type": "string", "description": "ISO date (YYYY-MM-DD). Only keep calendar events / holidays / earnings releases on/before this date." }, "importance": { "title": "Importance (mode=calendar, earningsCalendar)", "enum": [ "", "low", "medium", "high" ], "type": "string", "description": "Only keep calendar events / earnings releases at this market-impact level. Trading Economics color-codes each release's importance; leave unset for all levels.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }