{ "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Scraper & API - 10-K, 10-Q, 8-K by Ticker", "description": "For equity research, fintech products and compliance teams: company filings from the SEC's own EDGAR API by ticker or CIK, with the full history and not just the recent window. EDGAR keeps about 1,000 filings in its main response - for Apple that hides 1,246 of 2,246 filings, 55.5% of the history.", "version": "0.1", "x-build-id": "PQpUTdz7Tfn0kln5A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~sec-edgar-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-sec-edgar-filings", "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/neverempty~sec-edgar-filings/runs": { "post": { "operationId": "runs-sync-neverempty-sec-edgar-filings", "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/neverempty~sec-edgar-filings/run-sync": { "post": { "operationId": "run-sync-neverempty-sec-edgar-filings", "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": { "companies": { "title": "Companies", "type": "array", "description": "Tickers such as AAPL, or CIK numbers such as 320193. Tickers are resolved through the SEC's own company_tickers.json, which holds 10,407 tickers for 8,013 companies. The SEC writes share classes with a hyphen (BRK-B); a dot (BRK.A) is accepted here and converted. A ticker it does not list comes back as its own row saying so, never as a company with no filings. Naming the same company twice - once by ticker and once by CIK - collects it once, so you are never charged twice for the same filings. CIK numbers work for companies with no ticker at all. Leave the whole input empty and the example companies AAPL and MSFT are used; every row then says so in its note. If you set form types or dates but no company, one unpaid row asks for a company instead of charging you for the example.", "items": { "type": "string" } }, "forms": { "title": "Form types", "type": "array", "description": "Keep only these form types, matched exactly and case-insensitively: 10-K, 10-Q, 8-K, DEF 14A, S-1, 4, 13F-HR and so on. Leave empty for every form. This matters more than it looks: of Apple's most recent 1,000 filings, 589 are Form 4 insider transactions and only 34 are 10-Q.", "items": { "type": "string" } }, "includeFullHistory": { "title": "Read the full filing history", "type": "boolean", "description": "EDGAR puts only the most recent 1,000 filings in the main response and the rest in separate files. Off, you get the recent block alone - for Apple that is everything back to 2015 and misses 1,246 older filings, 55 per cent of its history. On, the older files are read too, which costs one extra request per file. When you set filedSince or filedUntil and those dates reach back before the recent block, the older files covering those dates are read automatically even with this off - so a date range is never cut short silently. Banks such as JPMorgan keep only about a year in the recent block.", "default": false }, "filedSince": { "title": "Filed on or after", "type": "string", "description": "A date such as 2024-01-01. Filings with no readable filing date are excluded when this is set, so the result never implies a date the source did not give.", "default": "" }, "filedUntil": { "title": "Filed on or before", "type": "string", "description": "A date such as 2024-12-31.", "default": "" }, "maxFilingsPerCompany": { "title": "Maximum filings per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper limit of rows kept per company, applied after the form and date filters rather than before, so asking for 100 10-K filings gives you up to 100 10-K filings. You are charged for the rows you actually receive.", "default": 100 }, "maxRetries": { "title": "Attempts per request", "minimum": 1, "maximum": 6, "type": "integer", "description": "How many times to try a request in total when EDGAR does not answer. HTTP 404 is a permanent answer and is never retried. Requests are paced to stay inside the SEC's published limit of ten per second.", "default": 4 } } }, "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 } } } } } } } } } }