{ "openapi": "3.0.1", "info": { "title": "FRED Release Calendar: Upcoming CPI, Jobs and GDP Releases", "description": "Upcoming and just-published US economic data release dates (CPI, jobs, GDP and every other FRED release) from the FRED API, with a monitoring mode that only returns and bills release dates you have not seen. Bring your own free FRED key.", "version": "1.0", "x-build-id": "KJbCFfbT4OT8apmkL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/accountable_eel~fred-release-calendar-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-accountable_eel-fred-release-calendar-alerts", "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/accountable_eel~fred-release-calendar-alerts/runs": { "post": { "operationId": "runs-sync-accountable_eel-fred-release-calendar-alerts", "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/accountable_eel~fred-release-calendar-alerts/run-sync": { "post": { "operationId": "run-sync-accountable_eel-fred-release-calendar-alerts", "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": { "releases": { "title": "Releases to follow (name, alias or FRED release ID)", "type": "array", "description": "One per line: a short alias for the headline release (CPI, jobs, GDP, PPI, PCE, retail sales), a numeric FRED release ID (10 is Consumer Price Index, 50 is Employment Situation, 53 is Gross Domestic Product) or any part of a release name (\"Gross Domestic Product by State\"). Leave empty to get every release in the window. Accepted formats: CPI, jobs, GDP, 53, \"Producer Price Index\". You're only charged for the ones we actually find — a miss costs nothing.", "items": { "type": "string" } }, "fredApiKey": { "title": "Your FRED API key", "type": "string", "description": "Optional. Get a free key in about a minute by creating a free FRED account (instant, nothing to wait for) at fred.stlouisfed.org/docs/api/api_key.html and paste your own key here. This actor never ships or shares a key; the key and its request limit are yours. Without a key every search comes back as one NEEDS_KEY row and nothing is charged." }, "testRun": { "title": "Try it first — only process the first 5", "type": "boolean", "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.", "default": false }, "onlyFound": { "title": "Hide rows with no result", "type": "boolean", "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.", "default": false }, "includeKeywords": { "title": "Only keep rows containing", "type": "array", "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip rows containing", "type": "array", "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.", "items": { "type": "string" } }, "maxResults": { "title": "Max release dates per run", "type": "integer", "description": "Up to 500. Caps how many release dates you get (and pay for) in one run.", "default": 100 }, "daysBack": { "title": "Days back", "type": "integer", "description": "How many days before today to include. Release dates already past come back as PUBLISHED. 0 returns upcoming dates only. Up to 120.", "default": 7 }, "daysAhead": { "title": "Days ahead", "type": "integer", "description": "How many days after today to include. FRED lists scheduled dates for roughly the next few months. Up to 120.", "default": 14 }, "onlyNewSinceLastRun": { "title": "Only return release dates new since the last run (monitoring)", "type": "boolean", "description": "On: only release dates you have not been given before are returned and charged for. A release counts as new when it first appears as UPCOMING and again the first run after its date passes (PUBLISHED). Run it on a daily schedule as a release alert. Off: every matching release date is returned every time.", "default": false }, "deltaName": { "title": "Watchlist name (optional)", "type": "string", "description": "Optional. Name this search's monitoring memory so you can tell two schedules apart, or keep one memory across an input change. Leave empty to auto-derive one from your release list.", "default": "" }, "columns": { "title": "Which columns do you want?", "type": "array", "description": "Choose which pieces of information to include in each result row. All are included by default.", "items": { "type": "string", "enum": [ "searchSummary", "releaseCount", "truncated", "monitorStatus", "releaseDates", "source", "releaseId", "releaseName", "releaseDate", "releaseStatus", "daysUntil", "lastUpdated", "releaseUrl", "isNew", "firstSeenAt" ], "enumTitles": [ "Search run", "Release dates returned", "More results were available", "Monitoring status", "All release dates (full list)", "Source", "FRED release ID", "Release name", "Release date", "Status", "Days until release", "Data last updated", "FRED release page", "Is this release date new?", "First seen on a run" ] }, "default": [ "searchSummary", "releaseCount", "truncated", "monitorStatus", "releaseDates", "source", "releaseId", "releaseName", "releaseDate", "releaseStatus", "daysUntil", "lastUpdated", "releaseUrl", "isNew", "firstSeenAt" ] }, "expandRows": { "title": "One row per release date (recommended) — turn off for one row per search instead", "type": "boolean", "description": "When on, each release date found gets its own row instead of being grouped under its search. You're still only charged once per search, no matter how many rows it produces.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 1, "type": "integer", "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.", "default": 1 } } }, "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 } } } } } } } } } }