{ "openapi": "3.0.1", "info": { "title": "Economic Calendar Scraper & API (Official Sources)", "description": "Macro release calendar for the US, euro area, UK, Canada and Australia from BLS, BEA, Fed, ECB and ONS with actual values. AI agents ready via MCP.", "version": "0.1", "x-build-id": "m93qHAgbrYwpy5HGz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ocius-data~economic-calendar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ocius-data-economic-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/ocius-data~economic-calendar/runs": { "post": { "operationId": "runs-sync-ocius-data-economic-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/ocius-data~economic-calendar/run-sync": { "post": { "operationId": "run-sync-ocius-data-economic-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": { "dateFrom": { "title": "From date", "type": "string", "description": "First day of the calendar, as YYYY-MM-DD or a relative value: \"today\", \"tomorrow\", \"yesterday\", \"-7d\", \"+2w\". Leave empty for today." }, "dateTo": { "title": "To date", "type": "string", "description": "Last day of the calendar (included), as YYYY-MM-DD or a relative value such as \"+7d\". Leave empty for 7 days after the start date. Maximum range: 366 days." }, "countries": { "title": "Countries", "type": "array", "description": "Economies to include. Leave empty for all: United States (US), euro area (EA), United Kingdom (GB), Canada (CA) and Australia (AU).", "items": { "type": "string", "enum": [ "US", "EA", "GB", "CA", "AU" ], "enumTitles": [ "United States (USD)", "Euro area (EUR)", "United Kingdom (GBP)", "Canada (CAD)", "Australia (AUD)" ] } }, "importance": { "title": "Importance", "type": "array", "description": "Expected market impact of each release (our rating by release type: high = CPI, jobs report, GDP, retail sales, central bank decisions; medium = PPI, trade, industrial production, housing, sentiment; low = everything else). Leave empty for all levels.", "items": { "type": "string", "enum": [ "high", "medium", "low" ], "enumTitles": [ "High", "Medium", "Low" ] }, "default": [ "high", "medium" ] }, "categories": { "title": "Event categories", "type": "array", "description": "Limit the calendar to these categories. Leave empty for all.", "items": { "type": "string", "enum": [ "inflation", "labour", "growth", "consumer", "business", "housing", "trade", "central-bank", "government", "sentiment", "other" ], "enumTitles": [ "Inflation and prices", "Labour market", "Growth (GDP)", "Consumer (retail, income, spending)", "Business and industry", "Housing and construction", "Trade and external accounts", "Central bank decisions", "Government finance", "Sentiment surveys", "Other" ] } }, "releaseStatus": { "title": "Release status", "enum": [ "all", "released", "scheduled" ], "type": "string", "description": "All events, only those already released, or only upcoming (scheduled) ones.", "default": "all" }, "includeValues": { "title": "Include actual and previous values", "type": "boolean", "description": "Adds the headline actual and previous values for the most traded releases (CPI, jobs report, PPI, JOLTS, euro area HICP, unemployment, GDP, retail and industry, UK CPI, labour market, GDP and retail sales, Canada CPI, Labour Force Survey and GDP) from the official statistics APIs. Free of extra charge.", "default": true }, "timezone": { "title": "Time zone for the date range", "type": "string", "description": "IANA time zone used to read From/To dates and to add a converted timestamp to each row, for example UTC, America/New_York, Europe/London or America/Bogota. Every row always includes the UTC time and the local time of the publishing agency.", "default": "UTC" }, "maxEvents": { "title": "Maximum events", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stops after this many events. You are charged once per event saved.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Official calendars are read with a direct connection. A proxy is used only as a fallback when a source blocks a request. Usually no change is needed." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }