📅 Economic Calendar Scraper

Pull scheduled macroeconomic events (CPI, interest rate decisions, jobless claims, PMIs, bond auctions, central bank speeches and more) for 47 countries and regions, as clean structured JSON.

Every event comes with its actual, forecast and previous values as real numbers, the unit and scale they are in, the surprise versus forecast, and the agency that publishes it.

⚙️ What it does

• Covers 47 countries and regions, including the US, Euro Area, UK, Japan, China, Germany, Canada and Australia
• Filters by country, date range, importance and category, so you only get (and pay for) the events you need
• Returns events sorted by date, with times in UTC plus your own timezone
• Works for past releases (backtesting) and upcoming events (planning, alerts)

With no input at all, it returns US, Euro Area and Japan events from 3 days ago to 3 days ahead.

📥 Input

Field	Type	Default	Description
countries	array	["US", "EU", "JP"]	Country or region codes to include
daysBack	integer	3	Days before today to include (0–30). Ignored when fromDate is set
daysAhead	integer	3	Days after today to include (0–30). Ignored when toDate is set
fromDate	string	–	Fixed start date, YYYY-MM-DD
toDate	string	–	Fixed end date, YYYY-MM-DD
importance	array	all	Any of high, medium, low
categories	array	all	Any of prce (prices & inflation), lbr (labour), gdp, mny (money & interest rates), bsnss (business), cnsm (consumer), hse (housing), trd (trade), gov (government), bnd (bonds), enrg (energy), mrkt (markets)
timezone	string	UTC	IANA timezone for local_date and local_time, e.g. Europe/Berlin
maxEvents	integer	no limit	Stop after this many events
proxyConfiguration	object	none	Optional Apify proxy settings

A few events have no category. They are left out whenever categories is set.

Example: US and UK high-impact inflation and jobs data this week

{
  "countries": ["US", "GB"],
  "importance": ["high", "medium"],
  "categories": ["prce", "lbr"],
  "daysBack": 0,
  "daysAhead": 7,
  "timezone": "America/New_York"
}

Example: every German release in a fixed window

{
  "countries": ["DE"],
  "fromDate": "2026-09-01",
  "toDate": "2026-09-30"
}

📤 Output

Each dataset item is one event:

{
  "id": "403228",
  "date": "2026-09-14T04:30:00.000Z",
  "country": "JP",
  "currency": "JPY",
  "title": "Industrial Production MoM Final",
  "indicator": "Industrial Production Mom",
  "ticker": "ECONOMICS:JPIPMM",
  "category": "bsnss",
  "categoryName": "Business",
  "importance": -1,
  "importanceLabel": "low",
  "actual": -0.2,
  "actualRaw": -0.2,
  "forecast": 0.1,
  "forecastRaw": 0.1,
  "previous": 1.9,
  "previousRaw": 1.9,
  "surprise": -0.3,
  "unit": "%",
  "scale": null,
  "referenceDate": "2026-07-31T00:00:00Z",
  "period": "Jul",
  "source": "Ministry of Economy Trade and Industry (METI)",
  "source_url": "http://www.meti.go.jp",
  "comment": "In Japan, industrial production measures the output of businesses integrated in industrial sector of the economy such as manufacturing, mining, and utilities.",
  "local_date": "2026-09-14",
  "local_time": "04:30:00",
  "scrapedAt": "2026-09-15T15:29:52.114Z"
}

Field	Description
date	Release time in UTC
local_date, local_time	Release time in the timezone you chose
importance / importanceLabel	-1 / low, 0 / medium, 1 / high
category / categoryName	Category code and its readable name
actual, forecast, previous	Values in the display scale, e.g. 206 for 206K jobless claims
actualRaw, forecastRaw, previousRaw	Full values, e.g. 206000
unit, scale	What the values are in: %, $, €… and K, M, B, T
surprise	actual − forecast, in the same unit and scale. null until the event is released or when there is no forecast
ticker	Indicator ticker, e.g. ECONOMICS:USCPI
period, referenceDate	The period the release covers
source, source_url	The agency that publishes the figure
comment	Short description of the indicator
scrapedAt	When the data was fetched (UTC)

Fields with no value are null.

💰 Pricing

You pay per event returned. Use the filters to pull only what you need: a single country with importance: ["high"] typically returns a handful of events per week.

🔁 Use cases

• Feed macro data into trading bots, backtests and AI agents
• Build economic dashboards and reports
• Get alerted before high-impact releases, or react to surprises as they print

❗ Notes

• A run fails with a clear message if the input is invalid (unknown timezone, fromDate after toDate) or the calendar source does not respond, so you never get a silent empty dataset.
• Upcoming events have actual: null until they are released. Schedule the Actor to run again after the release to pick up the actual value.

---

This actor is intended for internal analytics and research purposes. Ensure compliance with any third-party data terms.