{ "openapi": "3.0.1", "info": { "title": "SEC 8-K Filings Scraper: Events and Press Releases", "description": "Track SEC 8-K filings by ticker, company name or across the whole market. Get every item with its text and category, the press release headline and earnings figures, executive change details, filing time and a risk score. Filter by event type, item code or industry. Export to CSV or Excel.", "version": "1.0", "x-build-id": "L1T7OBia3Q3vROv9S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parselab~sec-8k-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parselab-sec-8k-events-scraper", "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/parselab~sec-8k-events-scraper/runs": { "post": { "operationId": "runs-sync-parselab-sec-8k-events-scraper", "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/parselab~sec-8k-events-scraper/run-sync": { "post": { "operationId": "run-sync-parselab-sec-8k-events-scraper", "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": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000." }, "mode": { "title": "What to collect", "enum": [ "events", "digest" ], "type": "string", "description": "Filings returns one row per 8-K with the items, the text of each item and the press release. Company digest returns one row per company with item counts, risk signals and a risk score for the period.", "default": "events" }, "tickers": { "title": "Stock tickers", "type": "array", "description": "Tickers of the companies to follow, for example AAPL, NVDA, TSLA. Leave empty together with company names and CIK numbers to scan all companies in the date range.", "items": { "type": "string" } }, "companies": { "title": "Company names", "type": "array", "description": "Part of a company name, for example Tesla or Microsoft. The closest matches in the SEC company list are used.", "items": { "type": "string" } }, "ciks": { "title": "Company IDs (CIK)", "type": "array", "description": "SEC company numbers, for companies that have no ticker or when you prefer the number, for example 320193.", "items": { "type": "string" } }, "categories": { "title": "Event categories", "type": "array", "description": "Keep only filings about these kinds of events. Executive changes covers item 5.02, Earnings covers 2.02, Cybersecurity covers 1.05. Leave empty for all events.", "items": { "type": "string", "enum": [ "Earnings", "Executive changes", "Material agreements", "Mergers and acquisitions", "Cybersecurity", "Bankruptcy", "Restatement", "Auditor change", "Listing", "Debt and financing", "Equity issuance", "Restructuring", "Impairment", "Control change", "Shareholder rights", "Shareholder vote", "Governance", "Regulation FD", "Other events" ] } }, "itemCodes": { "title": "Item codes", "type": "array", "description": "Exact 8-K item numbers, for example 5.02 or 1.05. Use this instead of categories when you know the item. Filings that contain any of the codes are kept.", "items": { "type": "string" } }, "sic": { "title": "Industry code (SIC)", "type": "string", "description": "Keep only companies whose industry code starts with these digits, for example 7372 for software or 28 for chemicals and drugs." }, "dateFrom": { "title": "Filed from", "type": "string", "description": "First filing date, YYYY-MM-DD. The default is 5 days ago, or 365 days ago when you choose companies." }, "dateTo": { "title": "Filed to", "type": "string", "description": "Last filing date, YYYY-MM-DD. The default is today." }, "includeText": { "title": "Include the text of each item", "type": "boolean", "description": "Adds the written text of every item, cut to the length below. Also adds a summary of executive changes and cybersecurity incidents. Turn it off for faster, smaller results.", "default": true }, "includePressRelease": { "title": "Include the press release", "type": "boolean", "description": "Adds the headline and text of the press release attached to the filing (exhibit 99), and the main numbers of earnings releases.", "default": true }, "textLimit": { "title": "Text length limit", "minimum": 200, "maximum": 20000, "type": "integer", "description": "Maximum characters kept per item text and per press release.", "default": 1500 }, "includeAmendments": { "title": "Include amendments (8-K/A)", "type": "boolean", "description": "Also return amended filings.", "default": true }, "onlyNewSinceLastRun": { "title": "Only filings not returned before", "type": "boolean", "description": "Skips filings that an earlier run already returned. Use it for daily alerts.", "default": false }, "maxFilingsToScan": { "title": "Max filings to scan", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Safety limit for how many filings are read before the run stops, even when few match your filters.", "default": 1500 }, "contactEmail": { "title": "Contact email (optional)", "type": "string", "description": "Added to the request header as SEC fair access guidelines recommend. Leave empty if you prefer." } } }, "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 } } } } } } } } } }