{ "openapi": "3.0.1", "info": { "title": "SEC Earnings Release Scraper — Text & Metrics", "description": "Parsed earnings-release text and headline metrics from SEC 8-K filings — not just a link to the filing. Get the full quarterly press release body plus revenue, EPS, margin and net income figures, each with its SEC source URL. Financial data for analysts, investor relations and AI agents.", "version": "0.1", "x-build-id": "o0x6UnSeU3csXNdXK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourcesauce~sec-earnings-release/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourcesauce-sec-earnings-release", "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/sourcesauce~sec-earnings-release/runs": { "post": { "operationId": "runs-sync-sourcesauce-sec-earnings-release", "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/sourcesauce~sec-earnings-release/run-sync": { "post": { "operationId": "run-sync-sourcesauce-sec-earnings-release", "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", "required": [ "contactEmail" ], "properties": { "mode": { "title": "What to fetch", "enum": [ "watchlist", "fullMarket" ], "type": "string", "description": "Watchlist returns earnings releases for the issuers you list. Full market returns every issuer that reported results on a given date — no ticker list needed. Full market reads roughly 300 filings per day and takes a few minutes.", "default": "watchlist" }, "tickers": { "title": "Tickers (watchlist mode)", "type": "array", "description": "Stock tickers to fetch, e.g. AAPL. Resolved via SEC's own ticker-to-CIK map; a ticker missing from that map is reported, never silently dropped. Ignored in full-market mode.", "items": { "type": "string" } }, "date": { "title": "Filing date (full-market mode)", "type": "string", "description": "Which day's filings to read, as YYYY-MM-DD. Leave empty for the most recent published day. Weekends and holidays have no filings, so the actor walks back to the last trading day that does." }, "maxFilings": { "title": "Max filings to scan (full-market mode)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper bound on how many of the day's 8-K filings are examined. Roughly 300 are filed on a typical business day and about a third report results. Lower this to shorten a run.", "default": 400 }, "ciks": { "title": "CIK numbers", "type": "array", "description": "SEC CIK numbers, for issuers whose ticker is not in SEC's map. Used in addition to tickers.", "items": { "type": "string" } }, "limit": { "title": "Filings per issuer", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many matching 8-K filings to return per issuer, newest first.", "default": 2 }, "includeText": { "title": "Include release text", "type": "boolean", "description": "If false, returns metadata and metrics only (smaller payloads).", "default": true }, "contactEmail": { "title": "Your contact email", "type": "string", "description": "Required by the SEC: EDGAR requests must carry a User-Agent identifying the requester with a contact email. Your email is sent only to the SEC, never stored or shared otherwise. Replace the prefilled address with your own for production use." } } }, "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 } } } } } } } } } }