{ "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Scraper: 10-K, 10-Q, 8-K, Form 4", "description": "Scrape SEC EDGAR filings by ticker, CIK, company name or full-text search. Get 10-K, 10-Q, 8-K, Form 4 and every form with filing dates, accession numbers, item codes, direct document links, XBRL financials and insider transactions. No API key. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "diMcdziWUfPNegL5b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~sec-edgar-filings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-sec-edgar-filings-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/scrapers_lat~sec-edgar-filings-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-sec-edgar-filings-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/scrapers_lat~sec-edgar-filings-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-sec-edgar-filings-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": { "tickers": { "title": "Tickers", "type": "array", "description": "Stock ticker symbols to look up, for example AAPL or MSFT. Each ticker is resolved to its SEC CIK.", "items": { "type": "string" } }, "ciks": { "title": "CIKs", "type": "array", "description": "SEC Central Index Key numbers. Zero padding is optional, for example 320193 or 0000320193.", "items": { "type": "string" } }, "companyName": { "title": "Company Name", "type": "string", "description": "Optional company name substring. Matches every company in the SEC ticker directory whose name contains this text." }, "fullTextQuery": { "title": "Full-Text Search Query", "type": "string", "description": "Optional. Search the full text of SEC EDGAR filings (2001 to present) for these words or phrases. Supports exact phrases in \"quotes\" and boolean operators. When set, the actor returns matching filings across all filers (narrowed by the form-type, date and CIK filters below) instead of scanning a single company's history." }, "formTypes": { "title": "Form Types", "type": "array", "description": "Only keep filings whose form matches one of these (for example 10-K, 10-Q, 8-K, 4, S-1, 13F-HR, SC 13D). Use 10-K/A for amendments. Leave empty to keep all forms.", "items": { "type": "string" } }, "dateFrom": { "title": "Date From", "type": "string", "description": "Only keep filings filed on or after this date (YYYY-MM-DD)." }, "dateTo": { "title": "Date To", "type": "string", "description": "Only keep filings filed on or before this date (YYYY-MM-DD)." }, "withDetails": { "title": "Insider Transaction Details (add-on)", "type": "boolean", "description": "Paid add-on. For ownership filings (Form 3, 4 and 5), fetch the ownership document and parse insider transactions: the reporting owner, their role, and each trade (shares, price, date, shares owned after) plus an aggregate bought/sold/net signal. Adds one detail request per matching filing and bills the details event on those rows.", "default": false }, "withFinancials": { "title": "Company Financials (XBRL add-on)", "type": "boolean", "description": "Paid add-on. Attach the company's latest reported XBRL financials (revenue, gross profit, operating and net income, assets, liabilities, equity, cash, debt, EPS, shares outstanding, public float) to each filing record. Bills the details event on those rows.", "default": false }, "maxFilings": { "title": "Max Filings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of filing records to collect across all companies. Optional." }, "maxPerCompany": { "title": "Max Filings Per Company", "minimum": 1, "type": "integer", "description": "Optional. Cap the number of filings returned for each company (useful when scraping many companies in one run). Leave empty for no per-company cap." } } }, "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 } } } } } } } } } }