Economic Calendar API for Official Release Dates

CleanScrape · @cleanscrape

Release dates and times for CPI, jobs, GDP and central bank decisions in five economies, straight from the official agencies.

AIAutomationDeveloper toolsNews

About

An economic calendar built only from official sources: release dates and times for CPI, jobs, GDP, retail sales, PCE and central bank rate decisions in the United States, the euro area, the United Kingdom, Canada and Australia. Pick countries and dates, export the calendar as CSV, Excel or JSON, or run it on a schedule to get only new, moved and released events. No login or API key.

Every date comes from the agency that publishes the number: BLS, BEA, Census Bureau, Federal Reserve, Eurostat, ECB, ONS, Statistics Canada, Bank of Canada, ABS and RBA. Times are in UTC and local time. No forecasts: consensus forecasts are compiled privately by calendar sites and are not included. Calendar coverage is broader than value coverage, and this is not a low-latency trading feed.

Start with a small run

  1. Choose United States, or another economy, under Countries.
  2. Choose Next 7 days and start the run. The other settings can stay as they are.
  3. Open the run's dataset for the events and download it as CSV, Excel or JSON. Coverage notes per source are in the SOURCES record of the run's key-value store.

No source-site account, API key, cookie or proxy is needed.

Examples

US events for the coming week:

{
  "countries": ["US"],
  "dateRange": "next7"
}

High-impact releases across all five economies:

{
  "countries": ["US", "EA", "UK", "CA", "AU"],
  "dateRange": "next30",
  "minimumImpact": "high"
}

Past UK inflation releases with their values:

{
  "countries": ["UK"],
  "dateRange": "pastYear",
  "categories": ["inflation"],
  "includeValues": true
}

A daily watch of central bank rate decisions:

{
  "countries": ["US", "EA", "CA", "AU"],
  "dateRange": "next30",
  "categories": ["rates"],
  "watchName": "rate-decisions",
  "onlyChanges": true
}

The first watch run returns the matching events and saves them as the starting point. Run it again with the same name and filters (for example on a daily schedule) to get only new, moved, cancelled and released events. Use a new watch name if you change the countries or filters.

Coverage

EconomyCalendar sources
United StatesBLS, BEA, Census Bureau, Federal Reserve, DOL weekly claims and EIA weekly petroleum
Euro areaEurostat euro-indicators and ECB monetary policy meetings
United KingdomOffice for National Statistics
CanadaStatistics Canada and Bank of Canada rate announcements
AustraliaABS and RBA policy board meetings

Fed Chair and Governor speeches and testimony are optional. Bank of England dates, consensus forecasts, private PMI values and nowcasts are not included.

How far back and ahead each agency lists releases (measured October 2026):

SourcePastAhead
BLSFrom January 2025To the end of the year (next year's schedule appears in December)
BEA, Census BureauFrom January 2025About 14 months
Federal ReserveFOMC decisions from 2021; speeches and other events from 2017FOMC next year; other events this year
DOL weekly claims, EIA petroleumAny dateTo the end of the year
EurostatThe past yearAbout 12 months
ECBDecisions from 1999About 2 years
ONSThe past yearAbout 12 months
Statistics CanadaFrom 2012 (key indicators)About 5 months
Bank of Canada, RBAThis yearAbout 14 months
ABSAbout the latest 250 releases (back to late April 2026)About 5 months

Each run's SOURCES record shows the dates each source covered and any gap.

DOL and EIA dates follow published weekly schedules and holiday exceptions. Regular weekly entries are provisional. ECB rate decisions carry the ECB's standard announcement time, 14:15 CET, and Bank of Canada rate announcements its published time, 09:45 ET; both are marked standard. RBA board meetings are date-only: the RBA calendar gives no announcement time. Eurostat euro indicators are date-only because Eurostat's calendar does not give a time.

Reading the output

FieldMeaning
nameAgency's release or meeting name
eventDateDate in the agency's local time zone
scheduledAtExact time where available; otherwise blank
timeStatusconfirmed (the agency's calendar gives the time), standard (the institution's published standard time), provisional or date_only
impactCleanScrape's classification, not a prediction of market movement
statusScheduled, released, moved or cancelled, based on source evidence
actualA supported first-release figure, not a later revision
latestValueCurrent series value for that reference period; it may be revised
unitPercentage or index base used by the figure
periodMonth, quarter or other period covered
releaseUrlLink to check the release or calendar

Blank values are intentional, not zero. Many entries are schedule-only. Passing an announcement time does not by itself mark a release as published. Local times account for daylight-saving changes; date-only entries do not receive an invented midnight timestamp.

Values included
SourceMeasureTreatment
BLSAll-items CPI annual changeFirst-published figure from a matched dated release; latest annual change calculated from CUUR0000SA0 and rounded to one decimal
ONSAll-items CPI annual change, D7G7/MM23Latest value for the exact month
Statistics CanadaAll-items CPI annual change, vector 41690973Calculated from the official index (2002=100) and rounded to one decimal; matched the published headline for June to September 2026
ABSAll-groups monthly CPI annual change, CPI 2.0.0Calculated from the official monthly index and rounded to one decimal; matched the published headline for January and May to July 2026
EurostatFinal HICP annual change, ECOICOP v2Official first-published series, not flash or revised values

Other indicators, policy-rate figures and quarterly ABS CPI are schedule-only for now. latestValueAsOf is the retrieval time, not the original announcement time. valueNote explains each matched figure: whether it describes actual (first published) or latestValue (may be revised).

Watches and interrupted runs

Watches report new events, moved times, cancellations and changes to supported values; the change field says which (new, moved, cancelled, released, value_updated or updated). Only complete source reads update the watch. A disappearing entry is not treated as cancelled. When a source gives neither a stable identifier nor a reference period, a date change can appear as a new event instead of a move. Two runs of the same watch never run at once: the second ends at the start and says so.

If one agency is unavailable, the others still return data and SOURCES records the gap. If every requested source fails, the run ends with nothing collected and says which sources failed.

Progress is saved as the run goes. Restart an interrupted run without changing its input to continue. Start a new run for a fresh snapshot.

Run report

SUMMARY in the run's key-value store gives the run's status, the number of events, the countries checked and one report per source. SOURCES lists each source with the dates it covered, its row count and any error, for people and for automation.

Pricing

$19 a month to rent it, after a 3-day free trial. Cancel at any time; access runs to the end of the month you paid for.

Runs use compute, paid from your Bytewells credit at Bytewells' rates, separately from the rental. No proxy is used. In tests on Bytewells, one country for a week used $0.0005 of credit, all five economies for 30 days $0.0007, and a year of UK inflation releases $0.0008.

There is no charge per event, so all five economies, past years and daily watches cost the same rental.

Sources and reuse

Each event and source row includes attribution and an official link. Original data are available directly from the agencies.

  • BLS: public-domain agency data; BLS cannot vouch for analyses after retrieval. Reuse policy.
  • BEA: source attribution. Reuse policy.
  • Census Bureau: source attribution for government-produced statistics.
  • Federal Reserve: source attribution, no endorsement. Disclaimer.
  • Department of Labor: source attribution. Copyright.
  • EIA: source and access date. Reuse policy.
  • Eurostat: source attribution; formatting adapted by CleanScrape. Copyright.
  • ECB: Original data available free of charge from the ECB. Terms.
  • ONS: Open Government Licence v3.0. Terms.
  • Statistics Canada: adapted from its release calendar and supported tables. This does not constitute an endorsement by Statistics Canada of this product. Open licence.
  • Bank of Canada: source attribution and adapted formatting. Terms.
  • ABS: CC BY 4.0, formatting adapted by CleanScrape. Copyright.
  • RBA: Original cash-rate data available free of charge from the RBA. Copyright and data conditions.

Use it from the API

The Actor runs through the Bytewells API, which works with Apify's API clients: point the client's base URL at Bytewells (see Bytewells docs) and call cleanscrape/economic-calendar-api with the input JSON from the examples above. The events are in the run's default dataset.

Common questions

Where does the data come from?

From the agencies that publish the numbers: their release calendars, calendar files and public data APIs. Free calendar websites copy the same agency schedules and type the values in by hand; this Actor reads them directly and links to the official release.

Does it include consensus forecasts?

No. Consensus forecasts are collected privately by data vendors and calendar sites, and no official source publishes them. The Actor gives the official schedule, the first-published value where it can be read from the release itself, and the latest value of the series.

How accurate are the times?

They come from the agencies' own calendars and are converted to UTC with daylight-saving changes taken into account (the UK and the US change clocks a week apart). In October 2026 all 27 US releases for November and December matched an independent release calendar to the minute.

Can I export to Excel or Google Sheets?

Yes. Download the run's dataset as Excel, CSV or JSON, or read it from the API into a sheet.

What does a run cost on top of the rental?

Only the compute it uses, from your Bytewells credit. Test runs used $0.0005 to $0.0008 each.

Is it legal to use the data?

The data is published by government agencies and central banks for public use; each row carries the source's attribution and licence link. Some sources ask you to mention that the original data is available free of charge from them (ECB, RBA). This is not legal advice.

Support

CleanScrape maintains this Actor and fixes it when an agency changes its calendar. If something looks wrong, email [email protected] with the run ID, the agency and the release you expected. Never include API tokens or private data.

Disclaimer

This Actor is an independent tool developed by CleanScrape. It is not affiliated with or endorsed by the source agencies or central banks. Source names identify coverage, not sponsorship. Schedules can change. This is not investment advice.

More tools from CleanScrape

FAQ

Where does the data come from?
From the agencies that publish the numbers: BLS, BEA, Census Bureau, Federal Reserve, Eurostat, ECB, ONS, Statistics Canada, Bank of Canada, ABS and RBA. Each row links to the official release or calendar.
Does it include consensus forecasts?
No. Consensus forecasts are compiled privately by data vendors and no official source publishes them. You get the official schedule, the first-published value where it can be read from the release, and the latest value of the series.
How do I get only new or moved events?
Give the run a watch name, turn on Only new or changed events and schedule it. The first run saves the matching events; later runs return only new, moved, cancelled and released ones.
What does a run cost on top of the rental?
Only the compute it uses, from your Bytewells credit. No proxy is used. Test runs used $0.0005 to $0.0008 each.
Is this investment advice?
No. It is a calendar of official release dates and published figures. Schedules can change, and this is not a low-latency trading feed.

Related

More Actors from the same publisher.

View all from @cleanscrape