# Official US Economic Release Calendar API (`redfoxxie/official-us-economic-release-calendar`) Actor Aggregate official BLS, Census, BEA, and Federal Reserve release schedules into a normalized API-ready calendar with UTC timestamps, Eastern times, period labels, source links, major-event filtering, and bounded output for agents, alerts, spreadsheets, and automation. - **URL**: https://apify.com/redfoxxie/official-us-economic-release-calendar.md - **Developed by:** [João Ferreira](https://apify.com/redfoxxie) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 official macro releases This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README Unofficial independent tool. It is not affiliated with, sponsored by, or endorsed by the U.S. Bureau of Labor Statistics, U.S. Census Bureau, U.S. Bureau of Economic Analysis, or Board of Governors of the Federal Reserve System. Turn the official BLS, Census Bureau, BEA, and Federal Reserve schedules into one bounded, normalized dataset for alerts, calendars, agents, spreadsheets, and research pipelines. The Actor reads the BLS-published iCalendar feed, the Census-published economic-indicator calendar, BEA machine-readable release-date feed, and Federal Reserve calendar JSON directly. It does not scrape a third-party economic calendar, invent consensus estimates, or resell proprietary actual-value data. ### What does the official macro calendar return? Each row includes a deterministic event ID, source agencies, official title, scheduled UTC timestamp, Eastern date and time, period covered when Census supplies one, source identity, official source links, retrieval timestamp, and a transparent `major` or `standard` label. The major label is a title-based convenience filter for widely followed labor, inflation, trade, housing, productivity, and retail releases. It is not an investment recommendation or a claim about future market impact. Major releases are the default; set `majorOnly=false` when daily and weekly Federal Reserve statistical series are also required. The output schema is stable and documented for JSON, CSV, Excel, Apify API, webhook, and MCP or AI-agent use. Event times are interpreted in `America/New_York`, including daylight-saving transitions, and also emitted as ISO 8601 UTC timestamps. ### Example Fetch the next 30 days of major releases from all four agencies: ```json { "startDate": "", "endDate": "", "daysAhead": 30, "agencies": ["BLS", "CENSUS", "BEA", "FED"], "search": "", "majorOnly": true, "maxItems": 200 } ```` Use explicit `startDate` and `endDate` values for reproducible historical or forward schedule snapshots. Search is case-insensitive and applies only to the official release title. The date range is inclusive in Eastern time. Every run has bounded agency, date, query, and record inputs, so scheduled jobs cannot silently turn into an unbounded crawl. ### Primary-source behavior The BLS feed provides persistent event UIDs and Eastern release times. The Census calendar supplies indicator pages, scheduled dates and times, and periods covered. BEA provides ISO 8601 release dates for GDP, personal income, trade, international accounts, and related releases. The Federal Reserve feed is restricted to timed statistical releases, FOMC events, and Beige Book releases; speeches, testimony, conferences, generic events, and rows without a scheduled time are excluded. Identical normalized titles at the same timestamp are merged across agencies with every supporting source retained, so a joint BEA/Census release is not returned or charged twice. Other rows are deduplicated by source identity. If one configured agency is temporarily unavailable but another succeeds, the run returns the available official records. It fails clearly when every configured source fails, rather than returning a misleading empty success. Government agencies can revise or postpone release schedules. Treat every row as a timestamped schedule observation, not a permanent guarantee. Schedule a fresh run shortly before a release if timing is operationally important, and retain `retrieved_at_utc` for auditability. The Actor does not return released values, surprise calculations, forecasts, trading signals, or consensus estimates. ### Pricing The first 10 returned records in each run are free. Each additional `official_macro_release` costs **$0.005**. There is no start fee. The launch uses **Pay per event + usage**, so Apify platform usage is billed separately to the account running the Actor, including runs that return only free rows. `maxItems` hard-caps both output volume and possible paid events. ### Responsible use and support This product repackages publicly available schedule metadata for convenience; the linked government pages remain authoritative. Users are responsible for checking revisions, applicable terms, and the fitness of the data for their own alerts or automation. For a reproducible parsing or timing issue, open the Actor's Apify Issues tab with the run ID, agency, event ID, and source URL. # Actor input Schema ## `startDate` (type: `string`): First Eastern calendar date to include in YYYY-MM-DD form. Leave empty to use today. ## `endDate` (type: `string`): Last Eastern calendar date to include. Leave empty to derive it from days ahead. ## `daysAhead` (type: `integer`): Calendar horizon used only when end date is empty. ## `agencies` (type: `array`): Fetch any combination of the official BLS, Census, BEA, and Federal Reserve schedules. ## `search` (type: `string`): Case-insensitive text contained in the official release title. Leave empty for all releases. ## `majorOnly` (type: `boolean`): Restrict results to a transparent built-in list of widely followed labor, inflation, trade, housing, and retail releases. ## `maxItems` (type: `integer`): Hard cap on returned calendar records and possible paid events for one run. ## Actor input object example ```json { "startDate": "2026-07-20", "endDate": "2026-08-19", "daysAhead": 30, "agencies": [ "BLS", "CENSUS", "BEA", "FED" ], "search": "Consumer Price Index", "majorOnly": true, "maxItems": 200 } ``` # Actor output Schema ## `calendar` (type: `string`): One normalized row per official scheduled release matching the requested agencies, dates, and filters. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("redfoxxie/official-us-economic-release-calendar").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("redfoxxie/official-us-economic-release-calendar").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call redfoxxie/official-us-economic-release-calendar --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=redfoxxie/official-us-economic-release-calendar", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Official US Economic Release Calendar API", "description": "Aggregate official BLS, Census, BEA, and Federal Reserve release schedules into a normalized API-ready calendar with UTC timestamps, Eastern times, period labels, source links, major-event filtering, and bounded output for agents, alerts, spreadsheets, and automation.", "version": "0.2", "x-build-id": "97uRPq2cZWAC9wXz1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/redfoxxie~official-us-economic-release-calendar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-redfoxxie-official-us-economic-release-calendar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/redfoxxie~official-us-economic-release-calendar/runs": { "post": { "operationId": "runs-sync-redfoxxie-official-us-economic-release-calendar", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/redfoxxie~official-us-economic-release-calendar/run-sync": { "post": { "operationId": "run-sync-redfoxxie-official-us-economic-release-calendar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startDate": { "title": "Start date", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "maxLength": 10, "type": "string", "description": "First Eastern calendar date to include in YYYY-MM-DD form. Leave empty to use today.", "default": "" }, "endDate": { "title": "End date", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "maxLength": 10, "type": "string", "description": "Last Eastern calendar date to include. Leave empty to derive it from days ahead.", "default": "" }, "daysAhead": { "title": "Days ahead", "minimum": 0, "maximum": 365, "type": "integer", "description": "Calendar horizon used only when end date is empty.", "default": 30 }, "agencies": { "title": "Official agencies", "minItems": 1, "maxItems": 4, "type": "array", "description": "Fetch any combination of the official BLS, Census, BEA, and Federal Reserve schedules.", "items": { "type": "string", "enum": [ "BLS", "CENSUS", "BEA", "FED" ] }, "default": [ "BLS", "CENSUS", "BEA", "FED" ] }, "search": { "title": "Title search", "maxLength": 200, "type": "string", "description": "Case-insensitive text contained in the official release title. Leave empty for all releases.", "default": "" }, "majorOnly": { "title": "Major releases only", "type": "boolean", "description": "Restrict results to a transparent built-in list of widely followed labor, inflation, trade, housing, and retail releases.", "default": true }, "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on returned calendar records and possible paid events for one run.", "default": 200 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```