ForexFactory Economic Calendar Scraper

Scrape the ForexFactory economic calendar as clean JSON — every scheduled event with its actual released value alongside the forecast and previous readings, plus revisions, impact level, currency, and event time. Pick this week, next/last week, a month, a single day, or any custom date range.

Why use this actor

• No account, no login, no API key — just press Run.
• Actual vs forecast vs previous on every data release — the numbers traders and analysts actually watch, not just the schedule.
• Revision, impact level, and "better/worse than expected" signals included, so you can rank surprises at a glance.
• Any date window — this/next/last week, the current month, a single day, or a custom From–To range (long ranges are fetched and merged automatically).
• Filter by currency and minimum impact (e.g. only high-impact USD & EUR events).
• Stable JSON output ready for spreadsheets, databases, dashboards, or trading pipelines. Automatic retries; runs on Apify's schedule.

How it works

1. Choose a date range (or a specific day / custom span).
2. Optionally narrow to specific currencies and a minimum impact level, or keep only upcoming events.
3. The actor pulls the calendar for that window and returns one clean row per event.
4. Export to JSON, CSV, or Excel, or pull it straight from the dataset via the API.

You don't manage any scrapers, browsers, or blocks — just the inputs.

Input

{
  "dateRange": "lastWeek",
  "currencies": ["USD", "CAD"],
  "minImpact": "medium",
  "upcomingOnly": false,
  "maxItems": 500
}

Field	Type	Description
dateRange	string	thisWeek, nextWeek, lastWeek, thisMonth, day, or range.
day	string	Used when dateRange = day. A single date, YYYY-MM-DD (e.g. 2026-07-06).
rangeFrom	string	Used when dateRange = range. Start date, YYYY-MM-DD.
rangeTo	string	Used when dateRange = range. End date, YYYY-MM-DD. Long spans are split and merged automatically.
currencies	array	Keep only these currencies (USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, CNY). Empty = all.
minImpact	string	low (all, incl. holidays), medium (medium + high), or high (high only).
upcomingOnly	boolean	Keep only events scheduled from now onward.
maxItems	integer	Max events to return (0 = no cap).
proxyConfiguration	object	Optional. Not required — ForexFactory is a public source.

Output

One row per event. Real sample (a released US-session data event from lastWeek):

{
  "_input": "lastWeek",
  "_source": "S1-onsite",
  "_scrapedAt": "2026-07-10T20:21:57Z",
  "id": 149224,
  "title": "GDP m/m",
  "prefixedName": "CA GDP m/m",
  "currency": "CAD",
  "country": "CA",
  "dateline": 1782822600,
  "datetimeISO": "2026-06-30T12:30:00Z",
  "timeLabel": "7:30pm",
  "impact": "high",
  "impactTitle": "High Impact Expected",
  "actual": "0.5%",
  "forecast": "0.4%",
  "previous": "-0.1%",
  "revision": "",
  "actualBetterWorse": 1,
  "revisionBetterWorse": 0,
  "leaked": false,
  "soloUrl": "/calendar/29-ca-gdp-mm",
  "url": "/calendar?day=jun30.2026#detail=149224"
}

Field	Type	Description
_input	string	The date range you requested.
_source	string	Where the row came from (S1-onsite = live calendar with actuals).
_scrapedAt	string	When the row was captured (UTC).
id	number	Stable event ID (used to de-duplicate across a long range).
title	string	Event name (e.g. GDP m/m, Core CPI m/m).
prefixedName	string	Event name prefixed with its currency/region.
currency	string	Currency the event affects.
country	string	Country/region code.
dateline	number	Event time as a Unix timestamp.
datetimeISO	string	Event time as UTC ISO 8601.
timeLabel	string	Human-readable event time as shown on the calendar.
impact	string	Expected impact: high, medium, low, or holiday.
impactTitle	string	Full impact label.
actual	string / null	The released value. null for events that haven't been released yet (all future events) and for speeches/holidays with no reading.
forecast	string	Consensus forecast (may be empty).
previous	string	Prior period's value (may be empty).
revision	string	Revised prior value, if any.
actualBetterWorse	number	1 = better than forecast, -1 = worse, 0 = in line / n/a.
revisionBetterWorse	number	Same scale, applied to the revision.
leaked	boolean	Whether the figure was released early.
soloUrl	string	Path to the event's dedicated page.
url	string	Path to the event on the calendar.

Notes / limits

• Actual values are populated at release time. Past events carry a filled actual; future events return actual: null by design (the forecast and previous are still provided). Speeches, meetings, and holidays have no numeric actual.
• Custom ranges longer than about two months are fetched in several windows and merged, with duplicate events removed automatically.
• A proxy is not required. If your own network can't reach the source, enable Residential proxy in the input.

Other finance actors

Actor	What it does
TradingView Screener, Ideas & Quotes	Screen stocks/crypto/forex, community ideas, live quotes.
CoinMarketCap Listings & Airdrops	Crypto market data, new coins, airdrops, per-coin detail.
TipRanks Stock Signals	Analyst ratings and price-target signals per ticker.