Investing.com Economic Calendar Scraper

Scrapes the Investing.com economic calendar for any date range: every scheduled release with its actual, forecast and previous values, impact level, country and currency. Optionally includes stock exchange holidays. No browser, no login.

What you get

One record per event occurrence:

{
  "type": "event",
  "eventId": 63,
  "occurrenceId": 556265,
  "date": "2026-09-16",
  "time": "2026-09-16T12:30:00Z",
  "country": "United States",
  "countryCode": "US",
  "countryId": 5,
  "currency": "USD",
  "event": "U.S. Core Retail Sales MoM",
  "shortName": "Core Retail Sales",
  "importance": "high",
  "category": "consumer",
  "actual": 0.5,
  "forecast": 0.4,
  "previous": -0.3,
  "revisedFrom": null,
  "unit": "%",
  "precision": 1,
  "referencePeriod": "Aug",
  "actualVsForecast": "bullish",
  "revisedVsPrevious": "neutral",
  "preliminary": false,
  "url": "https://www.investing.com/economic-calendar/core-retail-sales-63"
}

• actual / forecast / previous — released value, consensus and prior reading. forecast, actual are null until published, so one run captures both the schedule and the results.
• revisedFrom — present when the previous figure was later revised.
• actualVsForecast / revisedVsPrevious — Investing.com's own read on the surprise: bullish, bearish or neutral.
• importance — high, medium or low, the calendar's impact rating.
• category — inflation, employment, central_banks, economic_activity, confidence_index, balance, bonds, credit, housing and so on.
• unit / precision / referencePeriod — e.g. %, 1 decimal, Aug.
• description — the plain-text explanation of what the event measures (only with includeDescriptions).
• type: "holiday" records (only with includeExchangeHolidays) carry the exchange, its country and timezone, and whether it is closed.

Input

Field	Description
startDate	First day, YYYY-MM-DD. Default: today.
days	Length of the range, 1–90. Default: 7.
countries	ISO codes, e.g. US, EU, GB, JP, DE. Empty returns every country.
importance	all (default), high, or high_medium.
includeExchangeHolidays	Also return market holidays for the range (default false).
includeDescriptions	Add the event explanation text (default false).

Running with no input returns every event for the next 7 days.

What it does not do

• It is a calendar, not a news feed — it does not scrape the articles linked from events.
• The importance filter is applied after download, since the calendar API returns the whole day's schedule regardless.
• Dates and times are UTC, so a release late in the US evening lands on the next day in Asia. Times come straight from the calendar and are not converted.
• Historical values are whatever Investing.com still publishes; revisions show up as revisedFrom, not as a separate record.
• The calendar only publishes roughly the next month in detail. Fewer than 100 events are listed beyond ~30 days out and essentially none past ~50, so a long forward range returns sparse results and then nothing — that is the source, not a failed run. Past dates are unaffected.

Notes

• One request covers 1000 occurrences, so a month is 2–3 requests plus one for the country list.
• A country code the calendar does not know is ignored with a warning rather than failing the run.
• If the country name lookup fails, records still carry countryId and the run continues.