Forex Factory Calendar Scraper - Economic Events & Forecasts avatar

Forex Factory Calendar Scraper - Economic Events & Forecasts

Pricing

$0.36 / 1,000 calendar events

Go to Apify Store
Forex Factory Calendar Scraper - Economic Events & Forecasts

Forex Factory Calendar Scraper - Economic Events & Forecasts

Scrape the Forex Factory economic calendar for this week: every event with UTC and local time, currency, country, impact, type, forecast, previous and parsed numbers. Plus Metals Mine, Energy EXCH and Crypto Craft calendars, filters, news window and monitor mode. $0.36 per 1,000 events.

Pricing

$0.36 / 1,000 calendar events

Rating

0.0

(0)

Developer

Top Api

Top Api

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

5 days ago

Last modified

Features

Limited permissions

Share

Scrape the Forex Factory economic calendar for the current week: every event (CPI, Non-Farm Payrolls, rate decisions, PMIs, GDP, speeches, bond auctions, holidays) with its release time in UTC and in your time zone, currency, country, impact (High / Medium / Low / Holiday), event type, consensus forecast and previous value, the numbers parsed (0.2% -> 0.2, unit %), the direction the forecast expects against the previous release, minutes until the release and the event's Forex Factory link. The same for Forex Factory's sister calendars Metals Mine, Energy EXCH and Crypto Craft, which rate impact for their own markets. Filters, a news window for trading bots, monitor mode and webhooks. No login, no browser, no API key.

What you get

What you chooseExampleWhat you get
Forex Factory, this weekthe prefilled inputEvery event of the week, Sunday to Saturday (105 events in the week of 2026-11-08)
A periodtoday, tomorrow, todayAndTomorrow, upcoming, custom dates, or hoursAhead: 24Only those days or hours, counted in your time zone
FiltersHigh impact, USD + EUR, inflation and employment, title contains CPIOnly the events you trade
Other calendarsmetalsmine, energyexch, cryptocraftThe same events rated for metals, energy or crypto (crude oil inventories: Low on Forex Factory, High on Energy EXCH)
Monitor modescheduled hourlyOnly events that are new or whose time, impact, forecast or previous changed since the last run

Quick input

{
"calendars": ["forexfactory"],
"period": "thisWeek",
"timezone": "UTC"
}

This is the prefilled input: the whole week on Forex Factory in about one second. With no input at all, the same runs.

More examples:

{ "impacts": ["High"], "currencies": ["USD", "EUR", "GBP"], "period": "upcoming", "timezone": "America/New_York" }
{ "keywords": ["CPI", "Non-Farm", "Rate"], "onlyWithForecast": true, "sortBy": "impact" }
{ "impacts": ["High"], "hoursAhead": 24, "newsWindowMinutes": 30, "timezone": "Europe/London" }
{ "calendars": ["forexfactory", "energyexch", "metalsmine", "cryptocraft"], "impacts": ["High", "Medium"] }
{ "monitorMode": true, "impacts": ["High", "Medium"], "webhookUrl": "https://example.com/hook" }

Input

FieldWhat it doesDefault
calendarsforexfactory, metalsmine, energyexch, cryptocraft. One row per event per calendar.["forexfactory"]
periodthisWeek, today, tomorrow, yesterday, todayAndTomorrow, upcoming (still ahead), custom (uses dateFrom / dateTo). Days are counted in timezone.thisWeek
dateFrom, dateToCustom period, YYYY-MM-DD, inclusive, inside the current week. Setting a date switches the period to custom.-
hoursAheadOnly events releasing within the next N hours.-
timezoneIANA name (America/New_York, Europe/London, Asia/Tokyo ...) for date, time and localDateTime. dateTimeUtc is always UTC.UTC
impactsAny of High, Medium, Low, Holiday. minImpact (high / medium / low) works too.all
currenciesUSD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, CNY, All (global events), and MXN, RUB, INR, ZAR, BRL on the sister calendars.all
categoriesgrowth, inflation, employment, centralBank, bonds, housing, consumerSurveys, businessSurveys, speeches, misc.all
keywordsKeep events whose title, currency or country contains one of these (case-insensitive).-
excludeKeywordsDrop events whose title contains one of these, e.g. Speaks, Auction.-
eventStatusall, upcoming (release time still ahead), passed. upcomingOnly: true and onlyReleased: true work too.all
onlyWithForecastKeep only events that publish a consensus forecast.false
newsWindowMinutesinNewsWindow is true for events within this many minutes of the run, before or after.30
onlyInNewsWindowKeep only events inside the news window ("is high-impact news due now?" with impacts: ["High"]).false
sortBytime, impact (High first), currency.time
maxItemsMost rows for the run (0 = no limit).1000
monitorModeDeliver only new events and events that changed since the last run.false
monitorKeyName of the monitor's memory; use different names for separate watches.ff-calendar
resetMonitorForget what earlier runs delivered.false
webhookUrlPOST a JSON summary of the delivered events (up to 200) after the run writes them. Not called when nothing is delivered.-
proxyConfigurationNot needed. Used only if the direct request is refused (then Apify residential).none

Every filter runs before anything is charged. Field names from other Forex Factory actors are accepted too (dateRange, startDate, endDate, impactLevels, minImpact, eventKeywords, upcomingOnly, onlyReleased, changesOnly, maxResults, max_items).

Output

One row per calendar event. A real row from a run on 2026-11-13 (impacts: ["High","Medium"], timezone: America/New_York):

{
"eventId": "79-20261110",
"calendar": "forexfactory",
"calendarName": "Forex Factory",
"title": "Core CPI m/m",
"currency": "USD",
"country": "United States",
"countryCode": "US",
"ffCountryCode": "us",
"impact": "High",
"impactLevel": 3,
"category": "inflation",
"dateTimeUtc": "2026-11-10T13:30:00.000Z",
"timestamp": 1794317400,
"date": "2026-11-10",
"time": "08:30",
"dayOfWeek": "Tuesday",
"localDateTime": "2026-11-10T08:30:00-05:00",
"timezone": "America/New_York",
"utcOffset": "-05:00",
"allDay": false,
"forecast": "0.2%",
"previous": "0.3%",
"forecastValue": 0.2,
"previousValue": 0.3,
"unit": "%",
"forecastVsPrevious": "lower",
"forecastChange": -0.1,
"hasForecast": true,
"status": "passed",
"minutesUntil": -4597,
"inNewsWindow": false,
"url": "https://www.forexfactory.com/calendar/79-us-core-cpi-mm",
"seriesId": 79,
"seriesSlug": "us-core-cpi-mm",
"source": "https://nfs.faireconomy.media/ff_calendar_thisweek.csv",
"scrapedAt": "2026-11-13T18:06:38.296Z"
}
FieldMeaning
eventIdForex Factory series id + UTC day. Stable across runs; the same event has the same id on all four calendars.
calendar, calendarNameWhich calendar the row comes from.
titleEvent title as Forex Factory shows it.
currencyThe currency the event moves (All = global events such as G7 or OPEC meetings).
country, countryCode, ffCountryCodeCountry of the release, from Forex Factory's own series code (ge = Germany for a EUR event).
impact, impactLevelExpected impact (High 3, Medium 2, Low 1, Holiday 0) as rated by that calendar.
categoryEvent type, classified from the title.
dateTimeUtc, timestampRelease time in UTC (ISO) and as Unix seconds.
date, time, dayOfWeek, localDateTime, timezone, utcOffsetRelease time in your time zone.
allDayTrue when the calendar gives a day but no time.
forecast, previousAs shown on the calendar.
forecastValue, previousValue, unitThe same as numbers (19.2B -> 19.2, unit B). Bond auctions show "yield|bid-to-cover" and stay text.
forecastVsPrevious, forecastChangehigher / lower / same, and the difference.
hasForecastA consensus forecast is published.
status, minutesUntil, inNewsWindowUpcoming or passed at run time, minutes to the release, inside the news window.
url, seriesId, seriesSlugThe event's page on the calendar's site (history, specs, source).
changeType, changedFields, previousValues, firstSeenAtMonitor mode only.
source, scrapedAtThe calendar file read and when.

Released actual values and past or next weeks are not in this actor: Forex Factory shows them only on its calendar pages, which answer automated requests with a Cloudflare challenge.

Fields and how often they are filled

Measured on the Forex Factory week of 2026-11-08 to 2026-11-14 (105 events):

FieldFilled
eventId, title, currency, country, impact, category, dateTimeUtc, date, time, url, seriesId, status, minutesUntil100%
countryCode, ffCountryCode98% (global events have none)
previous60%
previousValue55% (bond auctions show "yield|bid-to-cover", kept as text)
forecast, forecastValue, forecastVsPrevious46% (speeches, meetings and holidays have none)

Impact in that week: 5 High, 6 Medium, 91 Low, 3 Holiday. Metals Mine had 69 events, Energy EXCH 44, Crypto Craft 15.

Monitor mode

Turn on monitorMode and schedule the actor (hourly is plenty: Forex Factory updates the calendar file about once an hour). The first run delivers every matching event (changeType: "new"). Every later run delivers only:

  • events not delivered before (changeType: "new"), and
  • events whose time, impact, title, forecast or previous changed (changeType: "changed", with changedFields and the old values in previousValues).

A run with nothing new delivers nothing and charges nothing. The memory is kept per monitorKey and calendar set; resetMonitor: true starts over. With webhookUrl, each run that delivers something POSTs a summary:

{ "actor": "forexfactory-scraper", "runId": "...", "calendars": ["forexfactory"], "delivered": 2, "newEvents": 1, "changedEvents": 1, "datasetId": "...", "items": [{ "eventId": "78-20261110", "title": "CPI m/m", "currency": "USD", "impact": "High", "dateTimeUtc": "2026-11-10T13:30:00.000Z", "forecast": "0.3%", "previous": "0.6%", "changeType": "changed", "changedFields": ["forecast"], "url": "https://www.forexfactory.com/calendar/78-us-cpi-mm" }] }

Pricing

$0.36 per 1,000 events ($0.00036 per delivered row). No start fee. Rows removed by a filter, rows over maxItems and unchanged rows in monitor mode are not charged. A full Forex Factory week (about 100 events) costs about $0.04.

Speed and limits

  • A run reads one small file per calendar (2-13 KB) and takes 1-2 seconds (measured on 120+ runs on 2026-11-13).
  • The calendar covers the current week only (Sunday to Saturday, US Eastern), as Forex Factory publishes it.
  • Forex Factory allows a few downloads of the calendar file per IP address in five minutes. If the direct download is refused, the run retries through Apify's proxies once per rung; if every rung is refused, the run fails without charging and says so.
  • category is our classification from the title; it is not a Forex Factory field.