# SEC EDGAR Filings Scraper (`crawlerbros/sec-edgar-scraper`) Actor Scrape SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4 insider trades, 13F holdings) for any US public company. HTTP-only via the SEC's public API. No login, no proxy, no auth. - **URL**: https://apify.com/crawlerbros/sec-edgar-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 20 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Scrape SEC EDGAR — the US Securities and Exchange Commission's public database of every filing every public US company makes. Annual reports (10-K), quarterly reports (10-Q), material event disclosures (8-K), insider transactions (Form 4), hedge-fund holdings (13F), proxy statements, IPO prospectuses, and more. HTTP-only via the SEC's official JSON API. No login, no proxy. ### What this actor does - Resolves tickers (e.g. `AAPL`) or CIKs to company records via SEC's master ticker map - Fetches recent filings for each company from `https://data.sec.gov/submissions/CIK.json` - Filters by filing type (32 supported types), date range, and free-text keyword - Optionally fetches the primary document HTML and emits cleaned text (for keyword search across filing text) - Builds direct URLs to the filing index page, primary document, and EDGAR detail page - Honors SEC's 10-requests-per-second rate limit + required User-Agent header ### Output per filing - `cik` (10-digit padded), `cikInt`, `companyName`, `ticker`, `tickers[]`, `exchange`, `sic`, `sicDescription` - `filingType` — e.g. `10-K`, `10-Q`, `8-K`, `4` - `accessionNumber` — SEC's unique filing ID - `filedAt` — date filed - `reportingPeriod` — fiscal period the filing covers - `acceptedAt` — exact timestamp of acceptance - `primaryDocFilename`, `primaryDocDescription` - `primaryDocUrl` — direct link to the actual filing document - `filingIndexUrl` — search results page on EDGAR - `filingDetailUrl` — filing's detail page on EDGAR - `sizeBytes`, `isXbrl`, `isInlineXbrl` - `primaryDocText` (only when `fetchPrimaryDocText=true`) — plain-text content of the filing, capped at 100k chars - `primaryDocTextLength` - `recordType: "filing"`, `scrapedAt` Empty fields are omitted (no nulls). ### Input | Field | Type | Default | Description | |---|---|---|---| | `companies` | array | `["AAPL","MSFT"]` | Tickers (resolves automatically) or 10-digit CIKs | | `filingTypes` | array | `["10-K","10-Q","8-K"]` | 32 supported types: 10-K, 10-Q, 8-K, DEF 14A, S-1, 13F-HR, 4, 3, 5, etc. | | `dateRangeFrom` | string | – | Drop filings filed before this ISO date | | `dateRangeTo` | string | – | Drop filings filed after this ISO date | | `maxItemsPerCompany` | int | `50` | Hard cap per company (1–1000) | | `maxItems` | int | `500` | Global hard cap (1–10000) | | `fetchPrimaryDocText` | bool | `false` | Fetch + extract the filing document's plain text | | `containsKeyword` | string | – | Only emit filings whose text contains this substring (implies `fetchPrimaryDocText`) | | `userAgentEmail` | string | `apify-actor@noreply.apify.com` | Contact email for SEC's required User-Agent header | #### Example: latest annual reports for tech giants ```json { "companies": ["AAPL", "MSFT", "GOOGL", "META", "AMZN", "NVDA"], "filingTypes": ["10-K"], "maxItemsPerCompany": 5 } ```` #### Example: insider trades for a single company ```json { "companies": ["TSLA"], "filingTypes": ["4"], "maxItemsPerCompany": 100 } ``` #### Example: 8-K events with keyword search ```json { "companies": ["AAPL"], "filingTypes": ["8-K"], "fetchPrimaryDocText": true, "containsKeyword": "acquisition", "dateRangeFrom": "2024-01-01" } ``` #### Example: hedge-fund holdings (13F) ```json { "companies": ["0001067983"], "filingTypes": ["13F-HR"], "maxItemsPerCompany": 20 } ``` ### Use cases - **Equity research** — pull every 10-K and 10-Q for a portfolio - **Insider trade alerts** — daily run on `Form 4` filings for executives at watched companies - **M\&A monitoring** — `S-4` registrations + `8-K` event disclosures filtered for "acquisition" keyword - **IPO tracking** — `S-1` and `S-3` filings to spot upcoming listings - **Hedge fund replication** — `13F-HR` filings to mirror prominent fund managers' positions - **Compliance audits** — verify filings for portfolio companies - **Financial journalism** — programmatic access to public filings without paying Bloomberg - **XBRL data extraction** — `isXbrl` flag identifies machine-readable filings for downstream parsers ### FAQ **Does it require a login or cookies?** No. SEC EDGAR is fully public. **Is a proxy needed?** No. SEC accepts requests from any IP, with a soft 10 req/sec rate limit. **Why does SEC require a User-Agent email?** SEC's fair-access policy requires every API request to include a contact email so they can reach the operator if there's an issue. The actor uses a generic Apify-actor email by default; for production high-volume scraping, override with your own. **How fresh is the data?** Real-time. SEC processes filings within minutes of submission. **What's the difference between `cik` and `accessionNumber`?** `cik` identifies the company; `accessionNumber` identifies a specific filing. Each filing has a unique accession (e.g. `0000320193-24-000123`). **Can I get the full filing text?** Yes — set `fetchPrimaryDocText: true` to also fetch the primary document and emit cleaned plain text (capped at 100k chars per record). Combine with `containsKeyword` to filter to filings mentioning a specific term. **What's the difference between 10-K and 20-F?** 10-K is for US-domiciled companies; 20-F is for foreign-domiciled companies (e.g. ADRs). Same purpose: annual report. **Can I scrape a private company?** No — only US public companies and foreign companies that file with the SEC. Private companies don't file. **How is `13F-HR` different from `SC 13G`?** `13F-HR` is a hedge fund's quarterly position list (all holdings >$100M AUM). `SC 13G` is a 5%+ ownership disclosure for any single security. Both useful for tracking institutional money flows. **What's an XBRL filing?** Machine-readable structured filing format. The actor's `isXbrl` and `isInlineXbrl` flags tell you which filings have parseable structured data — useful for downstream financial-data extraction. # Actor input Schema ## `companies` (type: `array`): Tickers (e.g. `AAPL`, `MSFT`, `GOOGL`) or 10-digit CIKs (e.g. `0000320193`). The actor resolves tickers to CIKs automatically. ## `filingTypes` (type: `array`): Which filing forms to include. Empty = all types. ## `dateRangeFrom` (type: `string`): Drop filings filed before this date. ## `dateRangeTo` (type: `string`): Drop filings filed after this date. ## `maxItemsPerCompany` (type: `integer`): Hard cap per company. ## `maxItems` (type: `integer`): Global hard cap across all companies. ## `fetchPrimaryDocText` (type: `boolean`): When true, also fetch the filing's primary document (HTML/TXT) and emit a `primaryDocText` field. Adds ~1 extra HTTP request per filing. Useful for keyword searching across filing text. ## `containsKeyword` (type: `string`): Only emit filings whose primary-document text contains this substring (case-insensitive). Implies `fetchPrimaryDocText=true`. ## `userAgentEmail` (type: `string`): SEC requires a contact email in every API request's User-Agent. Defaults to a generic Apify-actor address; override with your own email if scraping at high volume. ## Actor input object example ```json { "companies": [ "AAPL", "MSFT" ], "filingTypes": [ "10-K", "10-Q", "8-K" ], "maxItemsPerCompany": 50, "maxItems": 500, "fetchPrimaryDocText": false, "userAgentEmail": "apify-actor@noreply.apify.com" } ``` # Actor output Schema ## `filings` (type: `string`): Dataset containing all scraped SEC filings. # 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 = { "companies": [ "AAPL", "MSFT" ], "filingTypes": [ "10-K", "10-Q", "8-K" ], "maxItemsPerCompany": 50, "maxItems": 500, "fetchPrimaryDocText": false, "userAgentEmail": "apify-actor@noreply.apify.com" }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/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 = { "companies": [ "AAPL", "MSFT", ], "filingTypes": [ "10-K", "10-Q", "8-K", ], "maxItemsPerCompany": 50, "maxItems": 500, "fetchPrimaryDocText": False, "userAgentEmail": "apify-actor@noreply.apify.com", } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/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 '{ "companies": [ "AAPL", "MSFT" ], "filingTypes": [ "10-K", "10-Q", "8-K" ], "maxItemsPerCompany": 50, "maxItems": 500, "fetchPrimaryDocText": false, "userAgentEmail": "apify-actor@noreply.apify.com" }' | apify call crawlerbros/sec-edgar-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/sec-edgar-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Scraper", "description": "Scrape SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4 insider trades, 13F holdings) for any US public company. HTTP-only via the SEC's public API. No login, no proxy, no auth.", "version": "1.0", "x-build-id": "UHae4JuxXphTYp0ke" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~sec-edgar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-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/crawlerbros~sec-edgar-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-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/crawlerbros~sec-edgar-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-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", "required": [ "companies" ], "properties": { "companies": { "title": "Companies (tickers or CIKs)", "type": "array", "description": "Tickers (e.g. `AAPL`, `MSFT`, `GOOGL`) or 10-digit CIKs (e.g. `0000320193`). The actor resolves tickers to CIKs automatically.", "default": [ "AAPL", "MSFT" ], "items": { "type": "string" } }, "filingTypes": { "title": "Filing types", "type": "array", "description": "Which filing forms to include. Empty = all types.", "items": { "type": "string", "enum": [ "10-K", "10-Q", "8-K", "20-F", "40-F", "DEF 14A", "DEFA14A", "PRE 14A", "S-1", "S-3", "S-4", "S-8", "F-1", "F-3", "13F-HR", "13F-NT", "SC 13G", "SC 13D", "SC 13D/A", "SC 13G/A", "4", "4/A", "3", "5", "424B1", "424B2", "424B3", "424B4", "424B5", "11-K", "NT 10-K", "NT 10-Q", "6-K" ], "enumTitles": [ "10-K (Annual report)", "10-Q (Quarterly report)", "8-K (Current report)", "20-F (Foreign annual report)", "40-F (Canadian annual report)", "DEF 14A (Definitive proxy)", "DEFA14A (Additional proxy materials)", "PRE 14A (Preliminary proxy)", "S-1 (IPO registration)", "S-3 (Shelf registration)", "S-4 (M&A registration)", "S-8 (Employee benefit plan)", "F-1 (Foreign IPO)", "F-3 (Foreign shelf)", "13F-HR (Hedge fund holdings)", "13F-NT (Hedge fund notice)", "SC 13G (Passive 5%+ ownership)", "SC 13D (Active 5%+ ownership)", "SC 13D/A (Active ownership amendment)", "SC 13G/A (Passive ownership amendment)", "Form 4 (Insider transaction)", "Form 4/A (Insider amendment)", "Form 3 (Initial insider ownership)", "Form 5 (Annual insider statement)", "424B1 (Prospectus type 1)", "424B2 (Prospectus type 2)", "424B3 (Prospectus type 3)", "424B4 (Prospectus type 4)", "424B5 (Prospectus type 5)", "11-K (Employee stock plan annual)", "NT 10-K (Notification of late 10-K)", "NT 10-Q (Notification of late 10-Q)", "6-K (Foreign current report)" ] }, "default": [ "10-K", "10-Q", "8-K" ] }, "dateRangeFrom": { "title": "Filed since (YYYY-MM-DD)", "type": "string", "description": "Drop filings filed before this date." }, "dateRangeTo": { "title": "Filed until (YYYY-MM-DD)", "type": "string", "description": "Drop filings filed after this date." }, "maxItemsPerCompany": { "title": "Max filings per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap per company.", "default": 50 }, "maxItems": { "title": "Max items total", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global hard cap across all companies.", "default": 500 }, "fetchPrimaryDocText": { "title": "Fetch primary doc as plain text", "type": "boolean", "description": "When true, also fetch the filing's primary document (HTML/TXT) and emit a `primaryDocText` field. Adds ~1 extra HTTP request per filing. Useful for keyword searching across filing text.", "default": false }, "containsKeyword": { "title": "Filing text contains", "type": "string", "description": "Only emit filings whose primary-document text contains this substring (case-insensitive). Implies `fetchPrimaryDocText=true`." }, "userAgentEmail": { "title": "Contact email (required by SEC)", "type": "string", "description": "SEC requires a contact email in every API request's User-Agent. Defaults to a generic Apify-actor address; override with your own email if scraping at high volume.", "default": "apify-actor@noreply.apify.com" } } }, "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 } } } } } } } } } } ```