# SEC EDGAR Filings Scraper (`foo121/sec-edgar-scraper`) Actor Export SEC filings (10-K, 8-K, 10-Q and more) for any US public company by ticker or CIK: form type, dates, accession, document links, plus XBRL financial facts. For fintech, research and compliance. Pay per result. - **URL**: https://apify.com/foo121/sec-edgar-scraper.md - **Developed by:** [ziv shay](https://apify.com/foo121) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 result items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEC EDGAR Filings Scraper **The SEC EDGAR scraper that pulls 10-K, 8-K, 10-Q and all other SEC filings by ticker — straight from the official SEC EDGAR API, with optional XBRL financials bundled in.** Built for fintech, equity research, compliance, and data teams who need clean SEC filings data keyed by ticker instead of wrangling CIK numbers and raw index files. Give it a list of tickers and form types and get back structured filing rows — optionally append one financials row per company with revenue, net income, EPS, and balance-sheet figures. Data comes from the **official SEC EDGAR API** — **no API key required**. This SEC filings scraper resolves each **ticker to its CIK** automatically via the official SEC ticker map, so you query by the symbol you already know. ### What you get This scraper emits two row types, distinguished by `rowType`. #### `rowType: "filing"` — one row per filing | Field | Description | |-------|-------------| | `form` | Filing form type (e.g. "10-K", "8-K", "10-Q") | | `cik` | SEC Central Index Key for the company | | `company` | Company name | | `ticker` | Ticker symbol the filing was matched to | | `filingDate` | Date the filing was filed with the SEC | | `reportDate` | Period-of-report date | | `acceptanceDateTime` | Timestamp the SEC accepted the filing | | `primaryDocDescription` | Description of the primary document | | `fileNumber` | SEC file number | | `items` | 8-K item codes (where applicable) | | `size` | Filing size in bytes | | `isXBRL` | Whether the filing includes XBRL data | | `filingUrl` | Link to the primary filing document | | `filingIndexUrl` | Link to the filing index page | #### `rowType: "companyFacts"` — one row per company (only if `includeCompanyFacts: true`) | Field | Description | |-------|-------------| | `company` | Company name | | `cik` | SEC Central Index Key | | `ticker` | Ticker symbol | | `sic` | Standard Industrial Classification code | | `fiscalYearEnd` | Fiscal year-end (MMDD) | | `revenue` | Most recent reported revenue (USD) | | `revenueFiscalYear` | Fiscal year of the revenue figure | | `revenuePeriodEnd` | Period-end date for the revenue figure | | `netIncome` | Most recent net income (USD) | | `totalAssets` | Total assets (USD) | | `totalLiabilities` | Total liabilities (USD) | | `stockholdersEquity` | Total stockholders' equity (USD) | | `cashAndEquivalents` | Cash and cash equivalents (USD) | | `earningsPerShareDiluted` | Diluted EPS | | `factsUrl` | Link to the company facts (XBRL) endpoint | ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `tickers` | array | `[]` | Ticker symbols to fetch, e.g. `["AAPL","MSFT"]` | | `ciks` | array | _(optional)_ | CIKs to fetch directly, if you prefer | | `formTypes` | array | `[]` | Form types to keep, e.g. `["10-K","8-K","10-Q"]` (empty = all) | | `maxFilingsPerCompany` | integer | `50` | Cap on filings returned per company | | `includeCompanyFacts` | boolean | `false` | Append one `companyFacts` row per company with XBRL financials | #### Example input ```json { "tickers": ["AAPL", "MSFT"], "formTypes": ["10-K", "8-K", "10-Q"], "maxFilingsPerCompany": 50, "includeCompanyFacts": true } ```` ### Example run output A `filing` row: ```json { "rowType": "filing", "form": "10-K", "cik": "0000320193", "company": "Apple Inc.", "ticker": "AAPL", "filingDate": "2024-11-01", "reportDate": "2024-09-28", "acceptanceDateTime": "2024-11-01T18:01:14.000Z", "primaryDocDescription": "10-K", "fileNumber": "001-36743", "items": "", "size": 8123456, "isXBRL": true, "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm", "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm" } ``` A `companyFacts` row (only when `includeCompanyFacts: true`): ```json { "rowType": "companyFacts", "company": "Apple Inc.", "cik": "0000320193", "ticker": "AAPL", "sic": "3571", "fiscalYearEnd": "0928", "revenue": 391035000000, "revenueFiscalYear": 2024, "revenuePeriodEnd": "2024-09-28", "netIncome": 93736000000, "totalAssets": 364980000000, "totalLiabilities": 308030000000, "stockholdersEquity": 56950000000, "cashAndEquivalents": 29943000000, "earningsPerShareDiluted": 6.08, "factsUrl": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json" } ``` ### Use cases - **Fintech & data teams** — ingest SEC filings data keyed by ticker into your product without managing CIK lookups. - **Equity research** — pull 10-K, 10-Q, and 8-K filings plus bundled XBRL fundamentals for a coverage list in one run. - **Compliance teams** — monitor a watchlist of issuers for new filings by form type. - **Quant & analytics teams** — build a clean financials dataset (revenue, net income, EPS, balance sheet) straight from official XBRL. ### Why this SEC EDGAR scraper - **Official source, no key** — pulls directly from the official SEC EDGAR API; no key, no scraping HTML. - **Ticker-keyed** — resolves ticker → CIK via the official SEC ticker map, so you query by symbol. - **XBRL financials bundled** — flip `includeCompanyFacts` and get fundamentals alongside the filing index in one dataset, instead of paying a separate fundamentals API. - **Pay-per-result** — no seat license; pay only for filings and facts rows returned. ### Pricing Pay per result — you are billed only for the filing and company-facts rows returned to your dataset. ### Keywords SEC EDGAR scraper, SEC filings scraper, 10-K 8-K data by ticker, SEC EDGAR API, 10-Q scraper, XBRL financials, company facts API, SEC filings by ticker, equity research data, fundamentals scraper # Actor input Schema ## `tickers` (type: `array`): Stock ticker symbols to fetch filings for, e.g. \["AAPL", "MSFT"]. Resolved to CIK via the official SEC ticker map. Provide tickers and/or CIKs. ## `ciks` (type: `array`): SEC Central Index Keys (CIK) to fetch, e.g. \["320193"] or \["0000320193"]. Zero-padding is handled automatically. Use instead of, or alongside, tickers. ## `formTypes` (type: `array`): Optional filter of SEC form types to include, e.g. \["10-K", "8-K", "10-Q"]. Leave empty to include every form. ## `maxFilingsPerCompany` (type: `integer`): Maximum number of filings to return for each company (most recent first). ## `includeCompanyFacts` (type: `boolean`): If enabled, append one extra row per company summarizing key XBRL financials (revenue, net income, total assets, equity, EPS, etc.) from the latest annual report. ## Actor input object example ```json { "tickers": [ "AAPL", "MSFT" ], "formTypes": [ "10-K", "8-K", "10-Q" ], "maxFilingsPerCompany": 50, "includeCompanyFacts": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "tickers": [ "AAPL", "MSFT" ], "formTypes": [ "10-K", "8-K", "10-Q" ] }; // Run the Actor and wait for it to finish const run = await client.actor("foo121/sec-edgar-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "tickers": [ "AAPL", "MSFT", ], "formTypes": [ "10-K", "8-K", "10-Q", ], } # Run the Actor and wait for it to finish run = client.actor("foo121/sec-edgar-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "tickers": [ "AAPL", "MSFT" ], "formTypes": [ "10-K", "8-K", "10-Q" ] }' | apify call foo121/sec-edgar-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=foo121/sec-edgar-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Scraper", "description": "Export SEC filings (10-K, 8-K, 10-Q and more) for any US public company by ticker or CIK: form type, dates, accession, document links, plus XBRL financial facts. For fintech, research and compliance. Pay per result.", "version": "1.0", "x-build-id": "KrHSyx8k7SD9hHR4b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foo121~sec-edgar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foo121-sec-edgar-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/foo121~sec-edgar-scraper/runs": { "post": { "operationId": "runs-sync-foo121-sec-edgar-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/foo121~sec-edgar-scraper/run-sync": { "post": { "operationId": "run-sync-foo121-sec-edgar-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 fetch filings for, e.g. [\"AAPL\", \"MSFT\"]. Resolved to CIK via the official SEC ticker map. Provide tickers and/or CIKs.", "items": { "type": "string" } }, "ciks": { "title": "CIKs", "type": "array", "description": "SEC Central Index Keys (CIK) to fetch, e.g. [\"320193\"] or [\"0000320193\"]. Zero-padding is handled automatically. Use instead of, or alongside, tickers.", "items": { "type": "string" } }, "formTypes": { "title": "Form types", "type": "array", "description": "Optional filter of SEC form types to include, e.g. [\"10-K\", \"8-K\", \"10-Q\"]. Leave empty to include every form.", "items": { "type": "string" } }, "maxFilingsPerCompany": { "title": "Max filings per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of filings to return for each company (most recent first).", "default": 50 }, "includeCompanyFacts": { "title": "Include XBRL company facts", "type": "boolean", "description": "If enabled, append one extra row per company summarizing key XBRL financials (revenue, net income, total assets, equity, EPS, etc.) from the latest annual report.", "default": false } } }, "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 } } } } } } } } } } ```