{ "openapi": "3.0.1", "info": { "title": "Stock Earnings Calendar — Nasdaq EPS Consensus & Surprises", "description": "Fetch Nasdaq stock earnings dates, EPS consensus estimates, actuals, surprise percentages, and revenue beats. Optional Yahoo Finance enrichment adds sector, price, and PE ratios. Filter by ticker, sector, or date range. No API key. Active PPE: $0.001 start and $0.001 per row after 25 free rows.", "version": "0.14", "x-build-id": "qkTb64v5jWmP7mf7q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gochujang~stock-earnings-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gochujang-stock-earnings-tracker", "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/gochujang~stock-earnings-tracker/runs": { "post": { "operationId": "runs-sync-gochujang-stock-earnings-tracker", "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/gochujang~stock-earnings-tracker/run-sync": { "post": { "operationId": "run-sync-gochujang-stock-earnings-tracker", "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": [ "upcoming", "recent", "search" ], "type": "string", "description": "'upcoming' = estimated future SEC filing dates. 'recent' = past Item 2.02 filing dates. 'search' = a wider date window. SEC does not provide analyst EPS actuals or consensus.", "default": "upcoming" }, "earningsWeek": { "title": "Earnings week shortcut", "enum": [ "this_week", "next_week", "custom" ], "type": "string", "description": "Quick date-range shortcut. 'This week' = Mon-Fri of current week. 'Next week' = Mon-Fri of next week. 'Custom' = use daysBack/daysAhead. Example: \"custom\".", "default": "custom" }, "daysAhead": { "title": "Days ahead", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many days from today to include (used when earningsWeek=custom). Example: 7.", "default": 7 }, "daysBack": { "title": "Days back", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many past days to include for EPS surprise data (used when earningsWeek=custom). Example: 3 for recent reports.", "default": 0 }, "enrichWithMarketData": { "title": "Market data enrichment (unavailable)", "type": "boolean", "description": "Legacy compatibility switch. SEC only provides SIC industry; current price, sector, and PE fields remain null.", "default": false }, "includeEpsSurprise": { "title": "Include EPS & revenue surprise %", "type": "boolean", "description": "Legacy compatibility switch. SEC submissions do not include analyst estimates, so surprise fields remain null.", "default": true }, "includeSectorBreakdown": { "title": "Include sector breakdown summary", "type": "boolean", "description": "Attach a sector_summary array with Unknown sector and null average surprise; SEC does not provide a market sector.", "default": false }, "includeGuide": { "title": "Next-quarter guidance (unavailable)", "type": "boolean", "description": "Legacy compatibility switch. SEC filings do not provide a normalized analyst guidance feed; guidance fields remain null.", "default": false }, "sectors": { "title": "Sector filter", "type": "array", "description": "Legacy filter. SEC SIC industry does not map to these market sectors, so a nonempty list returns no rows.", "default": [], "items": { "type": "string" } }, "symbols": { "title": "Ticker filter", "type": "array", "description": "Only include these SEC-listed tickers (case-insensitive). Empty = bounded built-in set of 60 widely followed companies, not all reporters.", "default": [], "items": { "type": "string" } }, "minMarketCapUsd": { "title": "Min market cap (USD)", "minimum": 0, "type": "integer", "description": "Legacy filter. SEC does not provide live market cap; any positive threshold returns no rows.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "date_asc", "report_date", "mcap_desc", "market_cap", "eps_estimate_desc", "eps_surprise_desc", "eps_surprise" ], "type": "string", "description": "Row order. Example: \"date_asc\".", "default": "date_asc" }, "limit": { "title": "Max rows", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Max earnings rows to return.", "default": 500 }, "alertOnUpcoming": { "title": "Telegram alert", "type": "boolean", "description": "Send list of upcoming earnings to Telegram after run. Example: true with Telegram credentials.", "default": false }, "alertDaysAhead": { "title": "Alert: days ahead filter", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only alert for earnings happening within this many days from today (e.g. 3 = earnings in the next 3 days). 0 = no day filter, alert all results. Example: 3.", "default": 3 }, "alertTickers": { "title": "Alert: ticker watchlist", "type": "array", "description": "Only send Telegram alerts for these specific tickers (e.g. AAPL, MSFT, NVDA). Empty = alert for all tickers that match the days-ahead filter. Example: [\"AAPL\"].", "default": [], "items": { "type": "string" } }, "telegramBotToken": { "title": "Telegram Bot Token", "type": "string", "description": "Telegram bot token. Example: a private bot token." }, "telegramChatId": { "title": "Telegram Chat ID", "type": "string", "description": "Telegram chat ID to send alerts to (get it from @userinfobot) Example: \"123456789\" from your Telegram chat.", "default": "" } } }, "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 } } } } } } } } } }