Investing.com Economic Calendar Scraper - 107 Countries
parseforge/investing-com-economic-calendar-scraper
BusinessDeveloper toolsAutomation
Scrape the Investing.com economic calendar: releases, speeches and holidays with actual, forecast, previous and revised values. Optionally add each indicator's description, source and past releases. Export to CSV, JSON, Excel or XML.
- Total runs
- 201
- Bookmarked
- 0
- Last modified
- 2 days ago
This scraper was last updated on .
What does the Investing.com Economic Calendar Scraper - 107 Countries return?

๐ Investing.com Economic Calendar Scraper
๐ Export the Investing.com economic calendar in seconds. 107 countries, 8 categories, 3 importance levels, 24 fields per row, and a full week of the global calendar (439 rows across 62 countries in the verification week) in about one minute.
The Actor reads the Investing.com economic calendar through the same request the page itself makes, and turns every scheduled entry into one clean row: data releases, central bank speeches, reports and market holidays, each with the actual, forecast, previous and revised values once they are published, the release time in UTC and in a time zone of your choice, the volatility rating, the currency and the country. Ask for today, tomorrow, this week, next week or any custom date range (the archive is verified back to 2020), narrow it down by country, importance or category, and download the result as CSV, JSON, Excel or XML.
Coverage is the whole calendar: 107 countries from Albania to Zimbabwe, the euro zone included, 8 event categories (central banks, confidence, balance of payments, bonds, credit, economic activity, employment, inflation) and the three volatility levels the site uses. Filters are applied by Investing.com itself, so Max Items is spent only on rows you asked for. Values the source has not published yet come back as Not Disclosed and fields that cannot apply to a row (the figures of a holiday) come back as N/A, never as an empty cell.
| ๐ฏ Target Audience | ๐ก Primary Use Cases |
|---|---|
| Traders and quant researchers | Build the week's event risk calendar for FX, rates, index and crypto desks |
| Macro analysts and economists | Track actual vs forecast surprises for CPI, NFP, GDP, PMI and rate decisions |
| Fintech and data teams | Feed a calendar widget, an alert bot or a backtest with a clean structured source |
| Newsrooms and content teams | Publish "the week ahead" pieces from a machine-readable schedule |
๐ What the Investing.com Economic Calendar Scraper does
๐ก Why it matters: the calendar page loads its rows through a client-side request, sits behind Cloudflare and rate limits every IP, so copying it by hand or with a plain script breaks quickly. This Actor speaks the page's own listing endpoint, takes a fresh exit IP for every request, walks your date range one day at a time so a busy week never drops rows, and never bills for a row it did not deliver.
- ๐ Every entry type: data releases, reports, central bank speeches and market holidays, flagged with
eventType,isSpeech,isReportandisHoliday. - ๐ข The figures that matter:
actual,forecast,previous, the original figure when the previous one was revised, andactualVsForecast(better, worse or in line) read from the site's own colour coding. - โฐ Exact timing:
dateTimeUtcas an ISO 8601 instant computed from the offset the site reports, plusdateLocalandtimeLocalin any IANA time zone you pick. - ๐ 107 countries and 8 categories as validated pick lists, so a typo cannot silently return the whole world.
- ๐ Importance as a number (1 to 3), a label (
low,moderate,high) and the site's own wording (High Volatility Expected). - ๐ Stable identifiers: the event id, the occurrence id of this particular release and the event's page URL on Investing.com.
- ๐๏ธ Any date range: today, tomorrow, this week, next week or a custom range, past or future.
- ๐ Optional depth, per indicator: the official description and the institution that publishes it, up to 100 past releases as numbers, and the latest and next scheduled print. All three are off by default and billed only when they actually carry data.
๐ฌ Full Demo (๐ง Coming soon)
A short walkthrough video is in production.
๐ Output
Each row is one calendar entry. Fields, in dataset order:
| Field | Description |
|---|---|
๐ eventName |
Event title without the period suffix, for example Initial Jobless Claims |
๐ country |
Country or zone as Investing.com names it (United States, Euro Zone) |
๐ฑ currency |
ISO currency code of the release (USD, EUR); N/A for holidays |
๐ eventUrl |
The event's page on Investing.com |
๐ eventId |
Investing.com id of the indicator, stable across releases |
๐ข occurrenceId |
Id of this specific release or holiday row |
๐ท eventType |
release, report, speech or holiday |
โฐ dateTimeUtc |
Release instant in ISO 8601 UTC |
๐
dateLocal / ๐ timeLocal |
Same instant in your chosen time zone; holidays show All Day |
๐ referencePeriod |
The period the figure covers (Aug, Q2), when the title carries one |
๐ actual |
Published value, or Not Disclosed until the release |
๐ฎ forecast |
Consensus forecast |
โฎ previous |
Previous value |
โ๏ธ previousRevisedFrom |
Original figure when the previous value was revised |
โ๏ธ actualVsForecast |
better than forecast, worse than forecast, in line with forecast, or N/A before release |
๐ importance |
1, 2 or 3 (the site's volatility bullets) |
๐จ importanceLabel |
low, moderate or high |
๐ volatilityExpected |
The site's own wording, for example High Volatility Expected |
๐ค isSpeech / ๐ isReport / ๐ isHoliday |
Yes or No |
๐ description |
Optional block. Official definition of the indicator and how to read a higher or lower print |
๐ source / ๐ sourceUrl |
Optional block. The institution that publishes the figure and its home page |
๐ท category |
Optional block. inflation, employment, economic activity and so on |
๐ countryId |
Optional block. Investing.com's numeric country id |
๐ eventLongName / eventMetaTitle |
Optional block. The indicator's full and qualified names |
๐ history |
Optional block. Past releases, each with actual, forecast, previous, previousRevisedFrom, referencePeriod, isPreliminary and the release time in UTC, as numbers |
โฑ latestRelease / nextRelease |
Optional block. The most recent published figure and the next scheduled one |
๐ scrapedAt |
ISO timestamp of the collection |
โ error |
null on success; error rows carry only this field and are never charged |
Three real rows from the verification run (this week, United States, Max Items 5):
[
{
"eventName": "OPEC Meeting",
"country": "United States",
"currency": "USD",
"eventUrl": "https://www.investing.com/economic-calendar/opec-meeting-230",
"eventId": "230",
"occurrenceId": "556230",
"eventType": "speech",
"dateTimeUtc": "2026-09-06T10:00:00.000Z",
"dateLocal": "2026-09-06",
"timeLocal": "10:00",
"referencePeriod": "Not Disclosed",
"actual": "Not Disclosed",
"forecast": "Not Disclosed",
"previous": "Not Disclosed",
"previousRevisedFrom": "Not Disclosed",
"actualVsForecast": "N/A",
"importance": 2,
"importanceLabel": "moderate",
"volatilityExpected": "Moderate Volatility Expected",
"isSpeech": "Yes",
"isReport": "No",
"isHoliday": "No",
"scrapedAt": "2026-09-08T04:52:41.709Z",
"error": null
},
{
"eventName": "United States - Labor Day",
"country": "United States",
"currency": "N/A",
"eventUrl": "N/A",
"eventId": "N/A",
"occurrenceId": "98",
"eventType": "holiday",
"dateTimeUtc": "N/A",
"dateLocal": "2026-09-07",
"timeLocal": "All Day",
"referencePeriod": "N/A",
"actual": "N/A",
"forecast": "N/A",
"previous": "N/A",
"previousRevisedFrom": "N/A",
"actualVsForecast": "N/A",
"importance": "N/A",
"importanceLabel": "N/A",
"volatilityExpected": "N/A",
"isSpeech": "No",
"isReport": "No",
"isHoliday": "Yes",
"scrapedAt": "2026-09-08T04:52:42.357Z",
"error": null
},
{
"eventName": "NFIB Small Business Optimism",
"country": "United States",
"currency": "USD",
"eventUrl": "https://www.investing.com/economic-calendar/nfib-small-business-optimism-537",
"eventId": "537",
"occurrenceId": "555661",
"eventType": "release",
"dateTimeUtc": "2026-09-08T10:00:00.000Z",
"dateLocal": "2026-09-08",
"timeLocal": "10:00",
"referencePeriod": "Aug",
"actual": "Not Disclosed",
"forecast": "99.2",
"previous": "99.8",
"previousRevisedFrom": "Not Disclosed",
"actualVsForecast": "N/A",
"importance": 1,
"importanceLabel": "low",
"volatilityExpected": "Low Volatility Expected",
"isSpeech": "No",
"isReport": "No",
"isHoliday": "No",
"scrapedAt": "2026-09-08T04:52:42.891Z",
"error": null
}
]
โจ Why choose this Actor
| What you get | |
|---|---|
| The whole calendar | 107 countries, not a hand-picked subset; holidays included or excluded with one switch. |
| Exact release instants | UTC computed from the offset the site reports, plus your own time zone, so 08:30 New York never becomes 12:30 by accident. |
| Surprise ready | actualVsForecast and previousRevisedFrom are extracted, not left for you to infer. |
| Filters at the source | Country, importance and category are applied by Investing.com, so Max Items 100 means 100 rows you wanted. |
| Any date, past or future | Custom ranges are walked day by day; the archive is verified back to March 2020. |
| Honest blanks | Not Disclosed and N/A instead of empty cells, so filters in Excel and pandas behave. |
| No browser, no key | Plain HTTP with a real browser TLS fingerprint and a fresh exit IP per request; runs in 256 MB. |
๐ How it compares to alternatives
| Feature | This Actor | Other Investing.com calendar scrapers | ForexFactory scrapers | By hand |
|---|---|---|---|---|
| Countries | 107 (validated pick list) | Often 45 or fewer | Major currencies only | One page at a time |
| Holidays | Yes, optional | Rare | No | Manual |
| Revised previous value | Yes | Rare | Rare | Manual |
| Actual vs forecast verdict | Yes | Rare | Some | Manual |
| Time zone | UTC plus any IANA zone | Site time only | Site time only | Manual |
| Rows per request ceiling | 200, paged automatically and walked per day | Varies | Varies | Scroll |
| Setup | Zero, run it now | Zero | Zero | Hours per week |
๐ How to use
- Create a free Apify account with $5 in credit.
- Open the Investing.com Economic Calendar Scraper.
- Pick a time frame (or a custom date range), choose countries, importance and categories, set Max Items and click Start.
- Download the dataset as CSV, Excel, JSON or XML from the Storage tab, or read it through the API.
A first run:
{
"timeFrame": "custom",
"dateFrom": "2026-09-08",
"dateTo": "2026-09-12",
"countries": ["United States", "Euro Zone"],
"importance": ["high"],
"outputTimeZone": "America/New_York",
"maxItems": 100
}
Free-plan runs return up to 10 rows as a preview. Upgrade your Apify plan to collect up to 1,000,000 rows per run.
๐ผ Business use cases
๐ Event risk for trading desks. Run nextWeek with importance: ["high"] every Friday and push the rows to the desk's shared calendar, so FOMC, CPI, NFP and ECB decisions are on every screen with the exact UTC instant.
๐ Surprise index research. Pull a custom range for the United States, the Euro Zone, the United Kingdom and Japan, keep rows where actualVsForecast is not N/A, and build a rolling surprise score per country from actual, forecast and previous.
๐ Alerting products. Schedule the Actor hourly for today, diff actual against the previous run and fire a Slack or Telegram message the moment a figure prints.
๐ฐ Editorial calendars. Newsrooms export thisWeek for a handful of countries on Sunday evening and draft the "week ahead" piece from the table, with eventUrl linking readers to each indicator.
๐ Automating Investing.com Economic Calendar Scraper
- Make and Zapier: run the Actor on a schedule and append new rows to Google Sheets or Airtable.
- Slack: post a message when a
highimportance release printsworse than forecast. - Airbyte: sync the dataset into BigQuery, Snowflake or Postgres for dashboards.
- GitHub Actions: rebuild a static "week ahead" page on every push.
- Google Drive: save each run as CSV or Excel for a shared folder.
Every integration starts from the Apify API or the ApifyClient for JavaScript and Python.
๐ Beyond business use cases
- Research: collect two years of releases for a thesis on how markets react to inflation surprises.
- Personal: know before a trip which markets are closed for a holiday.
- Non-profit: economics educators can hand students a clean weekly dataset instead of screenshots.
- Experimentation: feed the rows to an LLM to prototype a plain-language daily macro briefing.
๐ค Ask an AI assistant about this scraper
Give an AI agent live access to the calendar through the Model Context Protocol:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/investing-com-economic-calendar-scraper"
Then ask in plain language, for example "List the high importance US and Euro Zone releases next week in New York time".
โ Frequently Asked Questions
๐ Which countries can I filter on?
All 107 countries Investing.com offers in its own country picker, from Albania to Zimbabwe, including the Euro Zone. Pick them by name in the Countries field; leave it empty for the whole world.
๐๏ธ How far back does the archive go?
Years. The Actor was verified against March 2020 and January 2026 weeks. Use timeFrame: "custom" with dateFrom and dateTo.
โฐ What time zone are the times in?
dateTimeUtc is always UTC, computed from the offset the site reports with each response. dateLocal and timeLocal use the Output time zone field (any IANA name such as Europe/London); it defaults to UTC.
๐ฆ How many rows can I collect?
Free users get 10 rows as a preview. Paid Apify users can set Max Items up to 1,000,000 per run. A full unfiltered week is a few hundred rows (439 in the verification week).
๐ข Why do some rows say Not Disclosed?
The value has not been published yet (a future release has no actual), or the site does not carry it for that event (speeches have no forecast). N/A marks fields that cannot apply, such as the figures of a market holiday.
๐๏ธ Can I drop the holidays?
Yes. Turn off "Include market holidays" and only releases, reports and speeches are delivered.
โ๏ธ How is actualVsForecast computed?
From the colour Investing.com assigns to the published figure: green is better than forecast, red is worse than forecast, black is in line with forecast. It stays N/A until both actual and forecast exist.
๐ What is the 200-row ceiling?
The listing endpoint returns at most 200 rows per request. The Actor walks your range one day at a time and pages inside a day when needed, so the ceiling never costs you rows.
๐ก๏ธ Do I need a proxy?
Investing.com sits behind Cloudflare and rate limits each IP after roughly a dozen requests, so the Actor uses Apify Proxy (datacenter) by default and takes a fresh exit IP for every request. If datacenter IPs run out for a request, it switches the rest of the run to residential IPs; turn "Fall back to residential IPs" off if you prefer the run to stop instead.
โ What happens if a day fails?
The other days are still delivered. The failed day adds one row containing only an error field, which is never charged, and the run status message says so.
๐ Can I run this on a schedule?
Yes. Create an Apify schedule to run the Actor hourly, daily or weekly and connect the dataset to your pipeline.
๐ What output formats are supported?
CSV, JSON, Excel and XML from the Apify Console or the API.
๐ Integrate with any app
The dataset is available through the Apify API the moment the run finishes. Use the run-sync-get-dataset-items endpoint for one-shot calls, webhooks to trigger downstream jobs, or the Make, Zapier, Airbyte and LangChain integrations listed on the Actor page.
๐ Recommended Actors
- Morningstar Fund & ETF Scraper
- Benzinga Financial News Scraper
- FINRA BrokerCheck Scraper
- UK Companies House Scraper
๐ก Pro Tip: browse the complete ParseForge collection.
๐ Need Help? Open our contact form with your run ID, your input and what you expected.
โ ๏ธ Disclaimer: This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Investing.com or Fusion Media Limited. It collects only publicly available data. You are responsible for using the data in compliance with Investing.com's terms of use and applicable laws.
What input does the Investing.com Economic Calendar Scraper - 107 Countries accept?
| Field | Type | What it does | Default |
|---|---|---|---|
| timeFrame | string (5 options) | Which range of the calendar to scrape. Pick 'Custom date range' to use the two date fields below. The site's week runs Sunday to Saturday. | thisWeek |
| maxItems | integer | Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 | 10 |
| dateFrom | string | First day to scrape, as YYYY-MM-DD. Used only when the time frame is 'Custom date range'. The archive goes back years (verified to 2020). | not set |
| dateTo | string | Last day to scrape, as YYYY-MM-DD. Used only when the time frame is 'Custom date range'. Defaults to Date from. | not set |
| countries | array | Limit the calendar to these countries. 107 countries are supported; leave empty for all of them. | ["United States"] |
| importance | array | Keep only events with these volatility ratings (the one, two or three bullets on the site). Leave empty for all three. | not set |
| categories | array | Keep only events in these categories. Leave empty for all of them. | not set |
| includeHolidays | boolean | The calendar also lists market holidays. Turn this off to keep only data releases, reports and speeches. | true |
| outputTimeZone | string | IANA time zone used for the dateLocal and timeLocal columns, for example 'America/New_York' or 'Europe/London'. | UTC |
| includeEventDetails | boolean | Adds the official description of the indicator and how to read a higher or lower print, the institution that publishes it, its home page, the event category and the country id. | false |
| includeEventHistory | boolean | Adds previously published values with actual, forecast, previous, revised-from, the reference period and whether the print was preliminary, as numbers rather than display strings. | false |
| historyLimit | integer | How many past releases to keep per indicator when the history block is on. The site holds up to 100, going back years. | 12 |
| includeClosestReleases | boolean | Adds the most recent published figure for the indicator and its next scheduled release, already parsed as numbers. | false |
| proxyConfiguration | object | Apify Proxy or your own proxies. Datacenter is the default; the Actor switches to residential on its own if datacenter gets blocked (see below). | {"useApifyProxy":true} |
| residentialFallback | boolean | If a request runs out of clean datacenter IPs, switch the rest of the run to Apify residential proxy. Slower and more expensive, but it finishes the run. Turn off to fail instead. | true |
| proxyCountry | string | Two-letter country code for the residential exit node, used only by the fallback above. | US |
How much does the Investing.com Economic Calendar Scraper - 107 Countries cost?
from $7.12 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| Actor Start | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). | $0.00178 to $0.002 |
| Calendar row | One calendar entry written: the event and its Investing.com id and URL, country, currency, volatility rating, the release time in UTC and in your chosen time zone, the reference period, and the actual, forecast, previous and revised-from values with the comparison against the forecast. Market holidays count as a row. | $0.00712 to $0.008 |
| Calendar day scanned | One request to the Investing.com calendar, covering one day of your date range with your country, importance and category filters already applied. Charged only when that day delivered at least one row you kept, so a filtered-out day is free. | $0.00534 to $0.006 |
| Event description and source | Optional, off by default. The official description of the indicator and how to read a higher or lower print, the institution that publishes it and its home page, the event category and the country id. Charged per row that actually received the block. | $0.00356 to $0.004 |
| Past releases | Optional, off by default. Up to 100 previous publications of the same indicator, each with actual, forecast, previous, revised-from, the reference period and whether it was preliminary, as numbers rather than display strings. Charged per row that actually received at least one past release. | $0.00445 to $0.005 |
| Latest and next release | Optional, off by default. The most recent published figure for the indicator and its next scheduled release, already parsed as numbers. Charged per row that actually received at least one of the two. | $0.00267 to $0.003 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
How do I call the Investing.com Economic Calendar Scraper - 107 Countries API?
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~investing-com-economic-calendar-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"timeFrame": "custom",
"dateFrom": "2026-09-08",
"dateTo": "2026-09-12",
"countries": [
"United States",
"Euro Zone"
],
"importance": [
"high"
],
"outputTimeZone": "America/New_York",
"maxItems": 500
}' What example inputs can I use?
Use these inputs to see how a run is configured.
{
"timeFrame": "custom",
"dateFrom": "2026-09-08",
"dateTo": "2026-09-12",
"countries": [
"United States",
"Euro Zone"
],
"importance": [
"high"
],
"outputTimeZone": "America/New_York",
"maxItems": 500
} What do users say about the Investing.com Economic Calendar Scraper - 107 Countries?
No reviews yet. Be the first.
How do I report an issue with the Investing.com Economic Calendar Scraper - 107 Countries?
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
What related scrapers can I use?
Run Investing.com Economic Calendar Scraper - 107 Countries on Apify All scrapers