{
"openapi": "3.0.1",
"info": {
"title": "Economic Release Calendar: Official US, UK, CA, AU Dates",
"description": "Official macro release dates and times from OMB (BLS), Census, BEA, the Fed (FOMC), ONS, Statistics Canada and ABS: CPI, jobs, GDP, retail sales, rate decisions. Timezone-aware, filters, change alerts and ICS. No forecasts. $3 per 1,000 releases.",
"version": "0.1",
"x-build-id": "jpje1KbsuGzRoag3H"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cprussin~economic-release-calendar/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cprussin-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/cprussin~economic-release-calendar/runs": {
"post": {
"operationId": "runs-sync-cprussin-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/cprussin~economic-release-calendar/run-sync": {
"post": {
"operationId": "run-sync-cprussin-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": {
"mode": {
"title": "Mode",
"enum": [
"calendar",
"changes"
],
"type": "string",
"description": "Calendar: one row per scheduled release in the date window. Changes: compares with the previous run (same state key) and outputs only releases that were added, removed, rescheduled or changed status. The first changes run saves a baseline and outputs nothing.",
"default": "calendar"
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Keep only these countries. Empty: all four.",
"items": {
"type": "string",
"enum": [
"US",
"GB",
"CA",
"AU"
],
"enumTitles": [
"United States",
"United Kingdom",
"Canada",
"Australia"
]
}
},
"agencies": {
"title": "Agencies",
"type": "array",
"description": "Keep only these agencies. Empty: all. BLS dates come from the OMB schedule (bls.gov is not read).",
"items": {
"type": "string",
"enum": [
"BLS",
"CENSUS",
"BEA",
"FED",
"ONS",
"STATCAN",
"ABS"
],
"enumTitles": [
"US Bureau of Labor Statistics",
"US Census Bureau",
"US Bureau of Economic Analysis",
"Federal Reserve (FOMC, G.17, G.19)",
"UK Office for National Statistics",
"Statistics Canada",
"Australian Bureau of Statistics"
]
}
},
"indicators": {
"title": "Indicators",
"type": "array",
"description": "Keep only these normalized indicators, e.g. cpi, employment-situation, gdp, retail-sales, fomc-decision. Empty: every recognized headline indicator.",
"items": {
"type": "string",
"enum": [
"advance-indicators",
"balance-of-payments",
"building-approvals",
"building-permits",
"business-conditions",
"business-formation",
"business-indicators",
"business-inventories",
"business-investment",
"capex",
"construction-output",
"construction-spending",
"construction-work-done",
"consumer-credit",
"corporate-profits",
"cpi",
"durable-goods",
"eci",
"employment-situation",
"factory-orders",
"fomc-decision",
"gdp",
"gdp-monthly",
"house-prices",
"household-spending",
"housing-starts",
"housing-vacancies",
"import-export-prices",
"index-of-production",
"index-of-services",
"industrial-prices",
"industrial-production",
"international-securities",
"international-transactions",
"job-vacancies",
"labour-force",
"labour-force-detailed",
"labour-force-survey",
"labour-market",
"manufacturing-sales",
"new-home-sales",
"new-housing-prices",
"payroll-employment",
"personal-income",
"ppi",
"productivity",
"productivity-costs",
"public-finances",
"qfr-manufacturing",
"qfr-retail",
"quarterly-services",
"real-earnings",
"retail-sales",
"trade",
"wage-price-index",
"wholesale-trade"
]
}
},
"includeOtherReleases": {
"title": "Include other releases",
"type": "boolean",
"description": "Also output releases without a normalized indicator (ONS, Statistics Canada and ABS publish dozens of smaller statistical releases a week). Ignored when Indicators is set.",
"default": false
},
"dateFrom": {
"title": "Date from",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
"type": "string",
"description": "First release date (YYYY-MM-DD, local date of the release). Empty: today."
},
"dateTo": {
"title": "Date to",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
"type": "string",
"description": "Last release date, inclusive. Empty: 30 days after Date from. At most 400 days. Statistics Canada lists two weeks ahead, ABS about six months, the OMB schedule the current and next year."
},
"outputFormat": {
"title": "Output format",
"enum": [
"dataset",
"datasetAndIcs"
],
"type": "string",
"description": "Dataset: rows only. Dataset + ICS: also saves the releases as an iCalendar file (calendar.ics) in the run's key-value store, for Google Calendar, Outlook or Apple Calendar.",
"default": "dataset"
},
"stateKey": {
"title": "State key",
"type": "string",
"description": "Changes mode: name of the saved snapshot. Use one key per schedule or filter set; changing the filters under the same key starts a new baseline.",
"default": "default"
},
"maxItems": {
"title": "Max rows",
"minimum": 1,
"maximum": 20000,
"type": "integer",
"description": "Stop after this many rows. Each row is billed once.",
"default": 1000
}
}
},
"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
}
}
}
}
}
}
}
}
}
}