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:
- Date range — today, tomorrow, this / next / last week, this / next / last month, or any custom dates (years of history in one run).
- Calendar links — paste any Forex Factory calendar link (a day, week, month or range — or one event) and get exactly what that page shows.
- 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 | Type | What it does |
|---|---|---|
| Date range | Text | Which days to scrape, counted in the timezone you pick below. |
| Start date (custom) | Text | First day for the "Custom dates" range, YYYY-MM-DD. |
| End date (custom) | Text | Last day (inclusive) for the "Custom dates" range, YYYY-MM-DD. |
| Timezone | Text | 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 | Text | First day of the week for "This / Next / Last week". |
| Currencies | List | Only events for these currencies. |
| Impact | List | Only events with these expected impact levels. |
| Categories | List | Only these event categories (Forex Factory's own classification). |
| Keywords | List | Only events whose title contains any of these words (case-insensitive), e.g. "CPI", "Non-Farm", "PMI", "Rate", "Lagarde". |
| Exclude keywords | List | Drop events whose title contains any of these words, e.g. "Bond Auction", "Speaks". |
| Only events with an actual | Yes / no | Keep only events whose actual figure is already published. |
| Include event details & history | Yes / no | Add each event's specs (source, what it measures, usual effect, frequency, next release, notes, why traders care) and its past releases. |
| History length | Number | How many past releases to add per event when details are on. |
| Monitor mode | Yes / no | 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. Open the scraper on Apify and sign in (free plan works).
- 2. Fill in the input: search terms, URLs or filters, and a result limit.
- 3. Run it, then download JSON, CSV or Excel, or pull the dataset through the API.
- 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 versionRelated scrapers
Doctoralia Scraper
Global
Scrape doctors from the whole Doctoralia network — doctoralia.es/.com.br/.com.mx and 9 more sites incl. ZnanyLekarz, MioDottore, Doktortakvimi and Jameda. Profiles, license numbers, services with prices, GPS locations and every patient review. Incremental monitoring for cheap recurring runs.
Posh.vip Scraper
Global
Scrape live events, organizers, tickets, performer lineups and venue details from Posh.vip. Supports event pages, organizer/group pages, and explore (marketplace) URLs with location-based filtering.
Bazaarvoice & PowerReviews Reviews + Q&A Scraper
Global
Reviews, Q&A and rating summaries from any shop on Bazaarvoice or PowerReviews: Target, Home Depot, Sephora, Costco, Lowe's, Boots, Argos, MediaMarkt, Ulta and thousands more. Paste a product URL; filter by stars, date, language, photos, verified buyers; only-new mode.
SimilarWeb Scraper
Global
Scrape SimilarWeb data for any domain: global/country/category rank, monthly visits, traffic sources, top countries, top keywords, engagement (bounce rate, time on site), competitors, and AI traffic details.