{ "openapi": "3.0.1", "info": { "title": "Trading Economics Market, Indicator & Calendar Scraper", "description": "Get live commodity, currency, stock index, bond yield, and crypto quotes, country economic indicators and forecasts, global rankings, the economic calendar, public holidays, and corporate earnings releases from Trading Economics.", "version": "1.1", "x-build-id": "46I5WSgnDTPdSK55W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~trading-economics-market-indicator-and-calendar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-trading-economics-market-indicator-and-calendar", "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/dataspryva~trading-economics-market-indicator-and-calendar/runs": { "post": { "operationId": "runs-sync-dataspryva-trading-economics-market-indicator-and-calendar", "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/dataspryva~trading-economics-market-indicator-and-calendar/run-sync": { "post": { "operationId": "run-sync-dataspryva-trading-economics-market-indicator-and-calendar", "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", "indicatorHistory", "marketHistory", "marketForecast", "news", "search", "creditRatingHistory", "bondYields" ], "type": "string", "description": "Which Trading Economics surface to collect.", "default": "markets" }, "marketType": { "title": "Market type (mode=markets)", "enum": [ "commodities", "currencies", "stocks", "bonds", "crypto", "shares" ], "type": "string", "description": "Which live market table to collect.", "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. Commodities use Energy/Metals/Agricultural/Industrial/Livestock/Index/Electricity; currencies, stocks and bonds use Major/Europe/America/Asia/Oceania/Africa; crypto uses Crypto/BTC/ETH; shares use Top Gainers/Top Losers. Leave unset for all rows.", "default": "" }, "countries": { "title": "Countries (multi-select)", "type": "array", "description": "One or more countries. Required for countryIndicators, countryForecast, creditRatingHistory and bondYields. Optional for calendar, holidays and earningsCalendar (leave empty for global data).", "items": { "type": "string", "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" ] }, "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` only appears on the forecast page and `health` only on the indicators page. Leave unset for all categories.", "default": "" }, "rankingIndicators": { "title": "Ranking indicators (mode=indicatorRanking)", "type": "array", "description": "One or more indicators to rank across every country. The `rating` indicator returns sovereign credit ratings instead of a numeric series.", "items": { "type": "string", "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" ] }, "default": [ "interest-rate" ] }, "indicatorHistoryUrls": { "title": "Indicator pages (mode=indicatorHistory)", "type": "array", "description": "Trading Economics indicator pages as full URLs or `country/indicator-slug`, e.g. `united-states/inflation-cpi` or `https://tradingeconomics.com/germany/unemployment-rate`. Up to 100 pages.", "items": { "type": "string" }, "default": [] }, "marketSymbols": { "title": "Market symbols or pages (mode=marketHistory)", "type": "array", "description": "Symbols such as `CL1:COM`, `AAPL:US`, `USGG10YR:IND` or full Trading Economics market URLs. Up to 100 symbols.", "items": { "type": "string" }, "default": [] }, "forecastAssetClass": { "title": "Forecast asset class (mode=marketForecast)", "enum": [ "commodity", "currency", "crypto", "stockMarket", "governmentBond10Y" ], "type": "string", "description": "Which public forecast table to collect.", "default": "commodity" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Keyword used to resolve indicators and markets, e.g. `gold`, `inflation`, `EURUSD`. Required for mode=search.", "default": "" }, "historySpan": { "title": "History span (history modes)", "enum": [ "1m", "3m", "6m", "1y", "2y", "5y", "10y", "max" ], "type": "string", "description": "How far back to fetch historical series. `max` returns the full available history.", "default": "5y" }, "marketInterval": { "title": "Market interval (mode=marketHistory)", "enum": [ "auto", "1m", "5m", "15m", "30m", "1h", "1d", "1w", "1M" ], "type": "string", "description": "Intraday or daily interval for market history. Leave on `auto` to use the span's natural frequency.", "default": "auto" }, "searchKeyword": { "title": "Keyword filter", "type": "string", "description": "Case-insensitive substring filter on the record name/title (instrument, indicator, event, company or news headline). Leave blank for no filtering.", "default": "" }, "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. 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", "type": "string", "description": "ISO date (YYYY-MM-DD). Lower bound for calendar, holidays, earnings, credit-rating history, bond yields and history points. For calendar this fetches the requested range, not just the default page.", "default": "" }, "dateTo": { "title": "Date to", "type": "string", "description": "ISO date (YYYY-MM-DD). Upper bound for the same date-aware modes.", "default": "" }, "importance": { "title": "Importance (calendar, earnings, news)", "enum": [ "", "low", "medium", "high" ], "type": "string", "description": "Keep only releases/news at this market-impact level. Leave unset for all levels.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on emitted records. History modes cap the total number of points across all requested series.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }