Economic Calendar Scraper: CPI, NFP, Rate Decisions, PMIs, with Forex Factory Impact

Get the economic calendar as clean data: every scheduled macro release (CPI and inflation, non-farm payrolls and jobless claims, central bank rate decisions, GDP, PMIs, retail sales, trade balance, bond auctions…) for 140+ countries and areas, with its time in UTC, actual, consensus, previous (and what it was revised from), Trading Economics' own forecast and importance. Releases of the current week also carry Forex Factory's impact (high / medium / low), the label forex traders filter on.

Built for trading bots, macro dashboards, newsletters and alerts that run on a schedule. A release-watch mode delivers only the releases whose actual figure came out since your last run, so an hourly schedule pays only for new numbers.

What it reads

• Trading Economics' public economic calendar (tradingeconomics.com/calendar), the way any visitor sees it: the date ranges, countries and importance levels its menus offer to everyone, times set to UTC.
• Forex Factory's own weekly calendar export (the current week), to add Forex Factory's impact and forecast to the releases both calendars list. Releases are paired only when they have the same currency, the same minute and the same name (for example Forex Factory's "CPI y/y" and Trading Economics' "Inflation Rate YoY"); a release with no sure match keeps the impact empty rather than a wrong one.

No login, no browser, and no proxy to set up.

Use cases

• Trading bots and EAs: pull this week's high-impact releases for USD, EUR, GBP and JPY before the session, and the actual versus consensus right after each release.
• Macro dashboards and spreadsheets: a weekly or monthly table of releases for the countries you follow, with numbers ready to chart (actualValue, consensusValue, previousValue).
• Alerts and newsletters: schedule release watch every 15 minutes and send each new CPI, payrolls or rate decision as it lands.
• Research: the last 30 days of releases with their surprises (actual minus consensus) and revisions.

Input

field	what it does
period	yesterday, today, tomorrow, recent (today and the next days), thisWeek, nextWeek, previousWeek (last 7 days), thisMonth, nextMonth, previousMonth (last 30 days)
region	major (G20 and more, the default), world, europe, america, asia, africa; used when no country or currency is given
countries	pick countries and areas (euro area, European Union, OPEC…); overrides the region
currencies	ISO codes such as USD, EUR, GBP, JPY; with no countries, reads every economy paying in them
minImportance	low (all), medium, high
releaseStatus	all, released (actual out), upcoming (no actual yet)
eventKeywords	keep releases whose name or category contains any of these words (inflation, pmi, interest rate…)
maxEvents	stop after this many releases, earliest first; 0 = all
onlyNewReleases	release watch: only releases whose actual appeared or changed since your last run with the same settings

Example: this week's high-importance releases in the four major FX currencies.

{
    "period": "thisWeek",
    "currencies": ["USD", "EUR", "GBP", "JPY"],
    "minImportance": "high"
}

Output

One row per release. Example (US Housing Starts, 2026-10-20):

{
    "status": "ok",
    "reason": null,
    "eventId": "399226",
    "date": "2026-10-20",
    "time": "12:30",
    "dateTimeUtc": "2026-10-20T12:30:00.000Z",
    "country": "United States",
    "countryCode": "US",
    "currency": "USD",
    "event": "Housing Starts",
    "referencePeriod": "SEP",
    "category": "housing starts",
    "importance": "high",
    "released": true,
    "actual": "1.221M",
    "actualValue": 1.221,
    "consensus": "1.30M",
    "consensusValue": 1.3,
    "previous": "1.288M",
    "previousValue": 1.288,
    "previousRevisedFrom": "1.275M",
    "teForecast": "1.3M",
    "teForecastValue": 1.3,
    "forexFactoryImpact": "low",
    "forexFactoryTitle": "Housing Starts",
    "forexFactoryForecast": "1.30M",
    "symbol": "UNITEDSTAHOUSTA",
    "url": "https://tradingeconomics.com/united-states/housing-starts",
    "scrapedAt": "2026-10-22T13:30:00.000Z"
}

field	meaning
eventId	Trading Economics' id of this release
date, time, dateTimeUtc	when it is released, in UTC; time and dateTimeUtc are null for releases listed without a time (elections, some meetings)
country, countryCode, currency	the economy (EA is the euro area, EU the European Union) and its currency (null for the world, OPEC, IMF, G7, G20)
event, referencePeriod, category	the release name, the period it covers (SEP, Q3, OCT/17), and the indicator it belongs to
importance	Trading Economics' importance: low, medium, high (null when the calendar shows none)
released	whether the actual figure is out
actual, consensus, previous	the figures as printed, with their unit (3.5%, $-749.7M, 194K)
actualValue, consensusValue, previousValue, teForecastValue	the same figures as numbers, as printed (scale letter and unit stay in the text field)
previousRevisedFrom	when the previous figure was revised, the value it had before
teForecast	Trading Economics' own forecast (its analysts' and model's projection), not the market consensus
forexFactoryImpact, forexFactoryTitle, forexFactoryForecast	Forex Factory's impact (high, medium, low, holiday), its name for the release and its forecast; null outside the current week, for currencies Forex Factory does not cover, or when no sure match exists
symbol, url	Trading Economics' ticker of the indicator, and its page
status, reason, scrapedAt	ok for a release (its reason is null); a free row says no_results, invalid (a currency no economy pays in) or blocked with the reason; when the row was read, in UTC

A run that finds nothing stores one free row with status no_results and the reason (for example "of 54 listed, 54 in another currency"). A summary with releases listed, pages read and releases left out by each filter is in the run's key-value store as SUMMARY.

Pricing

US$0.0005 per release delivered (US$0.50 per 1,000). Releases left out by your filters, releases not new in release-watch mode, and status rows are free. A week of high-importance releases for the major economies is about 15–30 releases (about US$0.01); every release of the major economies for a whole month is about 1,300 (US$0.65).

Release watch on a schedule

Turn on onlyNewReleases and schedule the Actor (for example every 15 minutes with period today). Each run delivers only the releases whose actual figure appeared or changed since the last run with the same countries, currencies, importance and keywords; the first run delivers every release already out. Upcoming releases are never delivered in this mode. The memory lives in a key-value store named steadyscrape-economic-calendar-state in your account.

Limits

• Only the date ranges Trading Economics offers every visitor: from the last 30 days to next month. Older history and custom date ranges are not offered (Trading Economics keeps them for subscribers).
• Trading Economics shows a visitor at most 1,000 releases at once; larger selections (the world for a month) are read as several smaller country selections and merged, which takes a few more seconds.
• The site can occasionally answer a request with a table it rendered for another visitor, so every selection is read twice, at least 6 seconds apart, and kept only when both reads agree (a run takes about 10 seconds per selection). If the reads keep disagreeing, the run stops with a free blocked row instead of delivering doubtful data.
• Forex Factory's export covers the current week only and allows few requests; when it cannot be read, releases are still delivered, with the Forex Factory fields empty.

Legal

This Actor is unofficial and is not affiliated with, endorsed by or connected to Trading Economics or Forex Factory. It reads public pages and a public export that anyone can open without an account, at a gentle pace, and does not pass any login, paywall or challenge. The figures belong to their publishers; check the terms of Trading Economics and Forex Factory before redistributing them, and use them for your own analysis.