Crawlsmith

Forex Factory Economic Calendar Scraper

Economic calendar events from Forex Factory.

What it does

This scraper reads the Forex Factory economic calendar and collects structured, ready-to-use data for any date range from 2007 to the end of next year. No copying tables by hand, no timezone math — pick your days, filters and timezone and hit Start.

Three ways to use it:

  1. Date range — today, tomorrow, this / next / last week, this / next / last month, or any custom dates (years of history in one run).
  2. Calendar links — paste any Forex Factory calendar link (a day, week, month or range — or one event) and get exactly what that page shows.
  3. Monitor mode — schedule it every 1–15 minutes; each run outputs only the events whose actual just came out (or, if you prefer, every change: new events, forecast revisions, reschedules).

Who uses it

Use Case How It Helps
Algo & bot traders Feed actual vs forecast into your strategy seconds after the release, and pause trading around high-impact news
Discretionary FX traders A clean weekly plan of high-impact events in your own timezone, plus alerts the moment NFP, CPI or a rate decision lands
Quants & researchers Years of releases with forecasts and revisions for backtesting news-driven moves and surprise indices
Financial media & newsletters Auto-build "week ahead" calendars and "what just printed" posts
Brokers & fintech apps Power an in-app economic calendar or news-risk warnings without maintaining a scraper
Analysts & dashboards Send the calendar to Google Sheets, Power BI or your database on a schedule

Input

27 options. Required ones are marked.

Option What it does
Date range Which days to scrape, counted in the timezone you pick below.
Start date (custom) First day for the "Custom dates" range, YYYY-MM-DD.
End date (custom) Last day (inclusive) for the "Custom dates" range, YYYY-MM-DD.
Timezone IANA timezone for every date and time in the output and for the date range, e.g. "UTC", "America/New_York", "Europe/London", "Europe/Warsaw", "Asia/Tokyo", "Australia/Sydney".
Week starts on First day of the week for "This / Next / Last week".
Currencies Only events for these currencies.
Impact Only events with these expected impact levels.
Categories Only these event categories (Forex Factory's own classification).
Keywords Only events whose title contains any of these words (case-insensitive), e.g. "CPI", "Non-Farm", "PMI", "Rate", "Lagarde".
Exclude keywords Drop events whose title contains any of these words, e.g. "Bond Auction", "Speaks".
Only events with an actual Keep only events whose actual figure is already published.
Include event details & history Add each event's specs (source, what it measures, usual effect, frequency, next release, notes, why traders care) and its past releases.
History length How many past releases to add per event when details are on.
Monitor mode Remember figures between runs and output only what moved.

Plus 13 more options. Full input reference on Apify.

Output fields

26 fields, grouped the way the dataset views show them. Export to JSON, CSV, Excel or pull them through the API.

Overview

  • date
  • time
  • currency
  • impact
  • fullTitle
  • actual
  • forecast
  • previous
  • revisedPrevious
  • actualVsForecast
  • category
  • eventUrl

Figures

  • dateTimeUtc
  • currency
  • title
  • actualValue
  • forecastValue
  • previousValue
  • revisedPreviousValue
  • unit
  • actualVsForecast
  • isReleased

Monitor

  • changeType
  • actualReleased
  • changedFields
  • date
  • time
  • currency
  • impact
  • fullTitle
  • actual
  • forecast
  • previousActual

Details

  • fullTitle
  • details
  • history

Example output

One record, shortened. Real runs return one row like this per result.

{
  "eventId": 146912,
  "eventTypeId": 66,
  "title": "Non-Farm Employment Change",
  "fullTitle": "US Non-Farm Employment Change",
  "currency": "USD",
  "region": "US",
  "countryCode": "US",
  "country": "United States",
  "impact": "high",
  "impactTitle": "High Impact Expected",
  "category": "Employment",
  "date": "2026-10-02",
  "time": "08:30",
  "dateTime": "2026-10-02T08:30:00-04:00",
  "dateTimeUtc": "2026-10-02T12:30:00.000Z",
  "timestamp": 1790944200,
  "timezone": "America/New_York",
  "timeStatus": "scheduled",
  "timeLabel": null,
  "actual": "29K",
  "forecast": "89K",
  "previous": "162K",
  "revisedPrevious": "133K",
  "actualValue": 29,
  "forecastValue": 89,
  "previousValue": 162,
  "revisedPreviousValue": 133,
  "unit": "K",
  "isReleased": true,
  "actualVsForecast": "worse",
  "revisionDirection": "worse",
  "hasDataValues": true,
  "notice": null,
  "eventUrl": "https://www.forexfactory.com/calendar?day=oct2.2026#detail=146912",
  "eventTypeUrl": "https://www.forexfactory.com/calendar/66-us-non-farm-employment-change",
  "details": {
    "source": "Bureau of Labor Statistics",
    "sourceUrl": "https://www.bls.gov/",
    "latestReleaseUrl": "http://www.bls.gov/news.release/empsit.nr0.htm",
    "measures": "Change in the number of employed people during the previous month, excluding the farming industry",
    "usualEffect": "'Actual' greater than 'Forecast' is good for currency",
    "frequency": "Released monthly, usually on the first Friday after the month ends",
    "nextRelease": "Nov 6, 2026",
    "nextReleaseDate": "2026-11-06",
    "nextReleaseUrl": "https://www.forexfactory.com/calendar?day=nov6.2026#detail=146914",
    "notes": "This is vital economic data released shortly after the month ends. The combination of importance and earliness makes for hefty market impacts",
    "whyTradersCare": "Job creation is an important leading indicator of consumer spending, which accounts for a majority of overall economic activity",
    "alsoCalled": "Non-Farm Payrolls, NFP, Employment Change"
  },
  "history": [
    {
      "eventId": 146911,
      "date": "2026-09-04",
      "period": "Sep 2026",
      "actual": "162K",
      "forecast": "55K",
      "revisedActual": "133K",
      "actualValue": 162,
      "forecastValue": 55,
      "revisedActualValue": 133
    }
  ],
  "scrapedAt": "2026-10-20T20:18:33.764Z"
}

How to run it

  1. 1. Open the scraper on Apify and sign in (free plan works).
  2. 2. Fill in the input: search terms, URLs or filters, and a result limit.
  3. 3. Run it, then download JSON, CSV or Excel, or pull the dataset through the API.
  4. 4. Schedule it to get fresh data daily or weekly.

FAQ

Which timezone are the times in? +

The one you choose — any timezone name such as America/New_York, Europe/London or Asia/Tokyo, daylight saving included. Every event also has its UTC time and a Unix timestamp, so nothing is ambiguous. "Today" and "this week" are counted in your timezone too.

How fast do I get a fresh actual? +

As fast as you schedule it. A monitor run takes a few seconds; scheduled every minute or every few minutes, you see the actual shortly after Forex Factory shows it. Only the new releases are output, so frequent runs stay cheap.

What about holidays and "Tentative" events? +

They are included with timeStatus set to allDay, tentative or other, the original label (e.g. "Day 2") and no clock time — they stay on the calendar day Forex Factory lists them under.

How far back does the history go? +

The calendar itself goes back to 2007 — ask for any custom date range. With details on, the history of a major indicator goes back to 2000.

Can I export the data? +

Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

How often should I run this? +

Weekly or daily for planning; every few minutes in monitor mode for live releases. You can schedule automatic runs on Apify with just a few clicks.

Does it work with proxies? +

Yes — it works with Apify's built-in proxy service and the standard datacenter proxy is all it needs. No residential proxy required.

Need something this scraper does not do?

Extra fields, a different filter, a recurring feed into your database or a one-off bulk export.

Ask for a custom version

Related scrapers