# Economic Calendar Data Scraper (`solidcode/economic-calendar-data-scraper`) Actor \[💰 $8.0 / 1K] Extract economic calendar events from Investing.com — event name, country, date, time, importance, and actual/forecast/previous values. Filter by countries, importance, categories, and date range. - **URL**: https://apify.com/solidcode/economic-calendar-data-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Economic Calendar Data Scraper Pull the full Investing.com economic calendar at scale — every macro release with its country, currency, importance tier, scheduled time, and the actual, forecast, and previous values that move markets. Filter by ~45 economies, three impact levels, and eight event categories, then convert every timestamp into your own trading zone. Built for forex and CFD traders, macro analysts, and algorithmic trading desks who need structured, machine-readable economic-event data without copying rows out of a calendar by hand. ### Why This Scraper? - **~45 economies in one feed** — United States, Euro Zone, United Kingdom, Japan, China, Germany, India, Brazil and 37 more, each tagged with its ISO currency so you can route events straight to the right instrument. - **Actual, forecast, and previous on every event** — the three numbers that drive volatility delivered side by side, unit-formatted (`16.7%`, `250K`) and ready to diff for surprise calculations. - **Three importance tiers, multi-select** — isolate market-moving High-impact releases like CPI, Non-Farm Payrolls, and central-bank rate decisions, or widen to Medium and Low for full coverage. - **Eight event categories** — Inflation, Employment, Central Banks, Economic Activity, Confidence Index, Credit, Bonds, and Balance — pick any combination to build a focused macro stream. - **Automatic time-zone conversion across 27 GMT offsets** — every event time is recalculated into your selected zone, from GMT-12:00 to GMT+13:00, including half-hour offsets like India (GMT+05:30). - **Historical and forward-looking date ranges** — pull any window from past prints to upcoming releases with a simple from/to date pair; reversed ranges are auto-corrected. - **Multi-filter fan-out with automatic dedupe** — select several importance levels and categories at once and the actor merges every combination into one clean, duplicate-free event list. - **Midnight releases flagged "All Day"** — undated tentative events are clearly marked instead of being mislabeled as a 00:00 release, so your calendar stays accurate. - **Direct event links** — every row carries the source `eventUrl` so analysts can jump to the full release detail in one click. ### Use Cases **Algorithmic Trading** - Schedule strategies around High-impact releases like CPI, NFP, and rate decisions - Compute surprise factors by diffing actual against forecast in real time - Halt or hedge positions in the minutes around scheduled volatility - Backtest signals against historical event windows by date range **Macro Research** - Track inflation and employment prints across ~45 economies in one dataset - Compare central-bank actions and confidence indices side by side - Build event-study models around forecast-versus-actual gaps - Assemble a longitudinal archive of releases for trend analysis **Risk Management** - Map upcoming High-impact events to exposed currency pairs - Pre-position alerts for the trading day's market-moving releases - Monitor a watchlist of countries and categories on a rolling window - Quantify how often a given release beats or misses consensus **Fintech & Data Products** - Power an economic-calendar widget in a trading app or dashboard - Feed forecast/actual deltas into automated trade-signal pipelines - Localize event times to each end-user's zone automatically - Enrich charting tools with event markers tied to the source release **Content & Media** - Generate "week ahead" macro previews for newsletters and reports - Publish post-release recaps comparing actual to forecast - Auto-populate market-calendar pages with structured data ### Getting Started #### Today's US Calendar The simplest run — today's events for a single country: ```json { "countries": ["united states"] } ```` #### High-Impact Releases This Week Focus on the events that actually move markets, in your trading zone: ```json { "countries": ["united states", "euro zone", "united kingdom"], "importances": ["high"], "fromDate": "2026-06-01", "toDate": "2026-06-05", "timeZone": "GMT -05:00" } ``` #### Targeted Macro Stream A focused multi-filter pull across categories and importance tiers: ```json { "countries": ["united states", "japan", "germany", "china"], "importances": ["high", "medium"], "categories": ["inflation", "employment", "central_banks"], "fromDate": "2026-05-01", "toDate": "2026-05-31", "timeZone": "GMT +01:00", "maxResults": 5000 } ``` ### Input Reference #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `countries` | array | `[]` | Only include events from these economies. Choose from ~45 markets (United States, Euro Zone, United Kingdom, Japan, China, and more). Leave empty for every country on the calendar. | | `importances` | array | `[]` | Limit to selected impact tiers: `high`, `medium`, `low`. Leave empty to include all levels. | | `categories` | array | `[]` | Limit to selected event categories: `credit`, `economic_activity`, `central_banks`, `bonds`, `inflation`, `confidence_index`, `balance`, `employment`. Leave empty for all categories. | #### Date Range | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `fromDate` | string | today | Start of the date range (`YYYY-MM-DD`). Leave empty to start from today. | | `toDate` | string | same as start | End of the date range (`YYYY-MM-DD`). Leave empty to use the same day as the start date. | #### Localization & Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `timeZone` | string | `"GMT"` | Time zone for event times. Choose any offset from GMT-12:00 to GMT+13:00 (including GMT+05:30 for India). Defaults to GMT (UTC). | | `maxResults` | integer | `1000` | Maximum number of events to return. Set to `0` for no limit (a safety ceiling of 100,000 prevents runaway wide-range runs). | ### Output Each result is one flat event row — easy to load into a spreadsheet, database, or trading pipeline with no nesting to unpack. ```json { "id": "488521", "date": "2026-06-05", "time": "08:30", "country": "United States", "currency": "USD", "importance": "high", "event": "Nonfarm Payrolls (May)", "actual": "250K", "forecast": "180K", "previous": "175K", "eventUrl": "https://www.investing.com/economic-calendar/nonfarm-payrolls-227", "retrievedAt": "2026-06-05T12:30:00.000Z" } ``` #### Event Fields | Field | Type | Description | |-------|------|-------------| | `id` | string | Unique identifier for this event occurrence. | | `date` | string | Event date (`YYYY-MM-DD`) in your selected time zone. | | `time` | string | Event time (`HH:MM`) in your selected zone, or `All Day` for undated tentative releases. | | `country` | string | Country or region the release belongs to (e.g. `United States`, `Euro Zone`). | | `currency` | string | ISO currency code tied to the event (e.g. `USD`, `EUR`, `JPY`). | | `importance` | string | Impact tier: `high`, `medium`, or `low`. | | `event` | string | Full release name, including the reference period (e.g. `Nonfarm Payrolls (May)`). | | `actual` | string | null | The released value, unit-formatted (e.g. `250K`, `16.7%`); `null` if not yet published. | | `forecast` | string | null | The consensus forecast for this release; `null` when none exists. | | `previous` | string | null | The prior period's value for the same release; `null` when unavailable. | | `eventUrl` | string | null | Direct link to the full release detail page; `null` when no link is available. | | `retrievedAt` | string | UTC ISO 8601 timestamp of when the row was collected. | ### Tips for Best Results - **Select only High importance to focus on market-moving releases** — CPI, Non-Farm Payrolls, GDP, and central-bank rate decisions live in the High tier; this trims noise dramatically for trading desks. - **Always set `timeZone` to your trading zone** — times default to GMT (UTC). Set it once and every row aligns to your session, so an 08:30 US Eastern print reads as `08:30`, not a UTC offset you have to convert. - **Combine `categories` with `importances`** — pairing `inflation` + `high` surfaces only the headline price prints, ideal for rates-focused strategies. - **Use a date range for historical event studies** — set `fromDate` and `toDate` to backfill past prints with their actual/forecast/previous values for backtesting. - **Diff `actual` against `forecast` for surprise signals** — the gap between the two is the number that drives the immediate market reaction. - **Leave `countries` empty for a global sweep** — combined with a tight date range and High importance, this captures every major release worldwide for that window. - **Set `maxResults` to `0` for full multi-month pulls** — the actor pages to exhaustion while a 100,000 safety ceiling protects against an accidental all-country, all-time run. ### Pricing **$8.00 per 1,000 results** — about 20% below comparable economic-calendar actors, with no compute charges. | Results | Estimated Cost | |---------|----------------| | 100 | $0.80 | | 1,000 | $8.00 | | 10,000 | $80.00 | | 100,000 | $800.00 | A "result" is one economic event row returned in your dataset. No compute charges — you only pay per result returned. Standard Apify platform fees apply to your account separately. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new releases - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor collects publicly available economic-calendar data for research, analysis, and integration purposes. You are responsible for using the data in compliance with the source website's terms of service and all applicable laws. Economic-event data is factual and non-personal; use it responsibly and respect rate limits. This tool is not affiliated with or endorsed by Investing.com. # Actor input Schema ## `countries` (type: `array`): Only include events from these countries. Leave empty to include every country on the calendar. ## `importances` (type: `array`): Only include events with these importance levels. Leave empty to include all importance levels. ## `categories` (type: `array`): Only include events from these categories. Leave empty to include all categories. ## `fromDate` (type: `string`): Start of the date range (YYYY-MM-DD). Leave empty to start from today. ## `toDate` (type: `string`): End of the date range (YYYY-MM-DD). Leave empty to use the same day as the start date. ## `timeZone` (type: `string`): Time zone used for event times. Defaults to GMT (UTC) if not set. ## `maxResults` (type: `integer`): Maximum number of events to return. Set to 0 for no limit (an internal safety ceiling of 100,000 applies to prevent runaway wide-range runs). ## Actor input object example ```json { "countries": [ "united states" ], "importances": [], "categories": [], "timeZone": "GMT", "maxResults": 1000 } ``` # Actor output Schema ## `overview` (type: `string`): Table of economic calendar events with key fields. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "countries": [ "united states" ], "importances": [], "categories": [], "fromDate": "", "toDate": "", "timeZone": "GMT", "maxResults": 1000 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/economic-calendar-data-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "countries": ["united states"], "importances": [], "categories": [], "fromDate": "", "toDate": "", "timeZone": "GMT", "maxResults": 1000, } # Run the Actor and wait for it to finish run = client.actor("solidcode/economic-calendar-data-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "countries": [ "united states" ], "importances": [], "categories": [], "fromDate": "", "toDate": "", "timeZone": "GMT", "maxResults": 1000 }' | apify call solidcode/economic-calendar-data-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/economic-calendar-data-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Economic Calendar Data Scraper", "description": "[💰 $8.0 / 1K] Extract economic calendar events from Investing.com — event name, country, date, time, importance, and actual/forecast/previous values. Filter by countries, importance, categories, and date range.", "version": "1.0", "x-build-id": "a7RKDWIYQdgJFecdH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~economic-calendar-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-economic-calendar-data-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/solidcode~economic-calendar-data-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-economic-calendar-data-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/solidcode~economic-calendar-data-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-economic-calendar-data-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", "properties": { "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "Only include events from these countries. Leave empty to include every country on the calendar.", "items": { "type": "string", "enum": [ "united states", "euro zone", "united kingdom", "japan", "china", "germany", "france", "italy", "spain", "netherlands", "switzerland", "canada", "australia", "new zealand", "india", "brazil", "mexico", "south korea", "russia", "south africa", "turkey", "singapore", "hong kong", "indonesia", "saudi arabia", "norway", "sweden", "denmark", "poland", "ireland", "portugal", "belgium", "austria", "greece", "israel", "argentina", "chile", "colombia", "philippines", "thailand", "malaysia", "taiwan", "ukraine", "egypt", "nigeria" ], "enumTitles": [ "United States", "Euro Zone", "United Kingdom", "Japan", "China", "Germany", "France", "Italy", "Spain", "Netherlands", "Switzerland", "Canada", "Australia", "New Zealand", "India", "Brazil", "Mexico", "South Korea", "Russia", "South Africa", "Turkey", "Singapore", "Hong Kong", "Indonesia", "Saudi Arabia", "Norway", "Sweden", "Denmark", "Poland", "Ireland", "Portugal", "Belgium", "Austria", "Greece", "Israel", "Argentina", "Chile", "Colombia", "Philippines", "Thailand", "Malaysia", "Taiwan", "Ukraine", "Egypt", "Nigeria" ] }, "default": [] }, "importances": { "title": "Importance Levels", "uniqueItems": true, "type": "array", "description": "Only include events with these importance levels. Leave empty to include all importance levels.", "items": { "type": "string", "enum": [ "high", "medium", "low" ], "enumTitles": [ "High impact", "Medium impact", "Low impact" ] }, "default": [] }, "categories": { "title": "Event Categories", "uniqueItems": true, "type": "array", "description": "Only include events from these categories. Leave empty to include all categories.", "items": { "type": "string", "enum": [ "credit", "economic_activity", "central_banks", "bonds", "inflation", "confidence_index", "balance", "employment" ], "enumTitles": [ "Credit", "Economic Activity", "Central Banks", "Bonds", "Inflation", "Confidence Index", "Balance", "Employment" ] }, "default": [] }, "fromDate": { "title": "From Date", "type": "string", "description": "Start of the date range (YYYY-MM-DD). Leave empty to start from today." }, "toDate": { "title": "To Date", "type": "string", "description": "End of the date range (YYYY-MM-DD). Leave empty to use the same day as the start date." }, "timeZone": { "title": "Time Zone", "enum": [ "GMT", "GMT -12:00", "GMT -11:00", "GMT -10:00", "GMT -09:00", "GMT -08:00", "GMT -07:00", "GMT -06:00", "GMT -05:00", "GMT -04:00", "GMT -03:00", "GMT -02:00", "GMT -01:00", "GMT +01:00", "GMT +02:00", "GMT +03:00", "GMT +04:00", "GMT +05:00", "GMT +05:30", "GMT +06:00", "GMT +07:00", "GMT +08:00", "GMT +09:00", "GMT +10:00", "GMT +11:00", "GMT +12:00", "GMT +13:00" ], "type": "string", "description": "Time zone used for event times. Defaults to GMT (UTC) if not set.", "default": "GMT" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of events to return. Set to 0 for no limit (an internal safety ceiling of 100,000 applies to prevent runaway wide-range runs).", "default": 1000 } } }, "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 } } } } } } } } } } ```