# SEC EDGAR Filings Scraper (`dami_studio/sec-edgar-scraper`) Actor Scrape SEC EDGAR filings via the official public APIs. Full-text search across all filings, or pull a company's filing history by ticker/CIK. Returns normalized rows with form, company, dates, accession number and a direct document URL. No API key. - **URL**: https://apify.com/dami\_studio/sec-edgar-scraper.md - **Developed by:** [Dami's Studio](https://apify.com/dami_studio) (community) - **Categories:** Integrations, Lead generation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $2.00 / 1,000 item returneds 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 Pull filings from the U.S. SEC's EDGAR system through its **official public APIs** — no API key, no login, no anti-bot to fight. Two modes: - **Full-text search** — search the text of every filing for a phrase (e.g. `artificial intelligence`), optionally narrowed to specific form types and a date window. - **Company filings** — give one or more tickers or CIKs (e.g. `AAPL`, `TSLA`) and get that company's recent filing history. Both modes return the **same normalized shape**, including a direct link to the primary filing document. ### What you get per filing `form`, `companyName`, `cik`, `ticker`, `filingDate`, `reportDate`, `accessionNumber`, `primaryDocument`, `description`, and `filingUrl` (a direct link to the document in `https://www.sec.gov/Archives/...`). **Which fields can be null.** SEC's full-text search index does not return every field for every hit, so `search`-mode rows are sparser than `company`-mode rows. In particular, `ticker`, `reportDate`, and `description` are often `null` in `search` mode (EDGAR's full-text engine doesn't index a ticker for many filers, and report/period dates and document descriptions are inconsistently present). `company` mode (driven by the submissions API) is more complete, but `reportDate`, `description`, and `ticker` can still be `null` for some filings. `filingUrl` is `null` only when SEC didn't supply enough identifiers (cik + accession + primary document) to build a canonical Archives link. Treat these fields as best-effort, not guaranteed. ### Input | Field | Notes | |---|---| | `mode` | `search` (full-text) or `company` (by ticker/CIK). Default `search`. | | `query` | Phrase for `search` mode, e.g. `"artificial intelligence"`. Required in `search` mode. | | `forms` | Comma-separated form types, e.g. `10-K,8-K`. Optional; applies to both modes. | | `tickers` | Array of tickers or CIKs for `company` mode, e.g. `["AAPL","TSLA"]`. | | `startDate` / `endDate` | Optional `YYYY-MM-DD` filing-date window. | | `maxItems` | Cap on **total** rows across the whole run (a shared budget, not per-company). In `company` mode, earlier tickers can use up the budget before later ones. Full-text search itself caps at 10000 results. | | `proxyConfiguration` | Optional. SEC's public API has no anti-bot, so a proxy gives no scraping benefit and this actor does no IP rotation. Off by default; enable only for anonymity, geolocation, or your own network's rate limits. | ### Output One dataset row per filing, deduplicated by `accessionNumber` + `primaryDocument`. Empty results return a single diagnostic row and **are not charged**. ### Examples Full-text search: ```json { "mode": "search", "query": "artificial intelligence", "forms": "10-K", "maxItems": 50 } ```` Company filings: ```json { "mode": "company", "tickers": ["AAPL", "TSLA"], "forms": "10-K,8-K", "maxItems": 50 } ``` ### Sample output row ```json { "ok": true, "form": "10-K", "companyName": "Example Corp", "cik": "0000320193", "ticker": "EXMP", "filingDate": "2024-02-01", "reportDate": "2023-12-31", "accessionNumber": "0000320193-24-000006", "primaryDocument": "exmp-20231231.htm", "description": "10-K", "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000006/exmp-20231231.htm" } ``` In `search` mode, `ticker`, `reportDate`, and `description` are frequently `null` (EDGAR's full-text index is sparse). See "Which fields can be null" above. ### Pricing Pay-per-result: you are charged once per filing row returned. **Empty runs, blocked/error runs, and diagnostic rows (`ok:false`) are never charged** — only genuine filing rows (`ok:true`) bill. Bad input (e.g. an empty `query` in search mode, or no tickers in company mode) returns a single uncharged `BAD_INPUT` diagnostic row rather than failing the run. ### Troubleshooting - **Sparse rows / null ticker or dates** — expected in `search` mode; SEC's full-text index omits these for many filers. Use `company` mode for richer records. - **Some tickers returned nothing in company mode** — the run pushes a `NOT_FOUND` diagnostic row listing exactly which ticker(s)/CIK(s) failed to resolve or had no matching filings. - **A `BLOCKED` / `RATE_LIMITED` diagnostic** — SEC has no anti-bot, so this almost always means your own network or a misconfigured proxy is being throttled; the actor already backs off and retries. Try again, or turn the proxy off if you enabled one. ### Notes This actor follows SEC's fair-access policy: every request carries a descriptive contact-style `User-Agent` (required — SEC returns 403 without one), uses gzip, and keeps a polite gap between requests. Full-text search covers filings indexed by EDGAR's full-text engine and is limited to 10000 results per query — split large jobs by form type or date window. Company mode returns the most recent ~1000 filings per company from the submissions API. # Actor input Schema ## `mode` (type: `string`): How to find filings. "search" runs an EDGAR full-text search across all filings using your query. "company" pulls a company's recent filing history by ticker or CIK. ## `query` (type: `string`): Full-text query for "search" mode (e.g. "artificial intelligence"). Matched as a phrase across filing documents. Required when mode is "search"; ignored in "company" mode. Note: SEC's full-text index is sparse — "search" rows often have null ticker, reportDate, and description (see README). Use "company" mode for more complete records. ## `forms` (type: `string`): Comma-separated SEC form types to filter by, e.g. "10-K,8-K". Leave empty for all forms. Applies to both modes. ## `tickers` (type: `array`): For "company" mode: one or more stock tickers (e.g. AAPL, TSLA) or numeric CIKs. Each company's filing history is fetched. Ignored in "search" mode. ## `startDate` (type: `string`): Only include filings filed on or after this date (YYYY-MM-DD). Optional. ## `endDate` (type: `string`): Only include filings filed on or before this date (YYYY-MM-DD). Optional. ## `maxItems` (type: `integer`): Maximum number of filings to return across the WHOLE run (a total budget shared by all companies/queries, not a per-company cap). In "company" mode the run stops once this total is hit, so earlier tickers in the list can consume the budget before later ones. Full-text search itself caps at 10000 results. ## `notionConnector` (type: `string`): Optional. Write each item as a page into your Notion when the run finishes. Authorize a Notion connector once in Settings → API & Integrations → MCP connectors, then pick it here. Leave empty to skip (default) — results are always saved to the dataset regardless. ## `notionParentId` (type: `string`): Optional. The Notion data source ID of the database to write into (only used if a Notion connector is set). Leave empty to create the pages privately in your workspace instead. ## `proxyConfiguration` (type: `object`): Optional proxy for SEC requests. SEC's public APIs have no anti-bot protection, so a proxy gives no scraping benefit here — this actor does no IP rotation. Leave it off (default). Only enable a proxy if you specifically want anonymity, a particular geolocation, or you hit IP-level rate limits from your own network. ## Actor input object example ```json { "mode": "search", "query": "artificial intelligence", "forms": "", "tickers": [], "startDate": "", "endDate": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): Scraped rows are stored in the default dataset (one row per result). Blocked/empty/error runs return a single uncharged diagnostic row instead. # 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 = { "query": "artificial intelligence" }; // Run the Actor and wait for it to finish const run = await client.actor("dami_studio/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 = { "query": "artificial intelligence" } # Run the Actor and wait for it to finish run = client.actor("dami_studio/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 '{ "query": "artificial intelligence" }' | apify call dami_studio/sec-edgar-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dami_studio/sec-edgar-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Scraper", "description": "Scrape SEC EDGAR filings via the official public APIs. Full-text search across all filings, or pull a company's filing history by ticker/CIK. Returns normalized rows with form, company, dates, accession number and a direct document URL. No API key.", "version": "0.1", "x-build-id": "x4PgThjwDHrxt0Ncs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~sec-edgar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~sec-edgar-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~sec-edgar-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": { "mode": { "title": "Mode", "enum": [ "search", "company" ], "type": "string", "description": "How to find filings. \"search\" runs an EDGAR full-text search across all filings using your query. \"company\" pulls a company's recent filing history by ticker or CIK.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Full-text query for \"search\" mode (e.g. \"artificial intelligence\"). Matched as a phrase across filing documents. Required when mode is \"search\"; ignored in \"company\" mode. Note: SEC's full-text index is sparse — \"search\" rows often have null ticker, reportDate, and description (see README). Use \"company\" mode for more complete records." }, "forms": { "title": "Form types", "type": "string", "description": "Comma-separated SEC form types to filter by, e.g. \"10-K,8-K\". Leave empty for all forms. Applies to both modes.", "default": "" }, "tickers": { "title": "Tickers or CIKs", "type": "array", "description": "For \"company\" mode: one or more stock tickers (e.g. AAPL, TSLA) or numeric CIKs. Each company's filing history is fetched. Ignored in \"search\" mode.", "default": [], "items": { "type": "string" } }, "startDate": { "title": "Start date", "type": "string", "description": "Only include filings filed on or after this date (YYYY-MM-DD). Optional.", "default": "" }, "endDate": { "title": "End date", "type": "string", "description": "Only include filings filed on or before this date (YYYY-MM-DD). Optional.", "default": "" }, "maxItems": { "title": "Max filings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of filings to return across the WHOLE run (a total budget shared by all companies/queries, not a per-company cap). In \"company\" mode the run stops once this total is hit, so earlier tickers in the list can consume the budget before later ones. Full-text search itself caps at 10000 results.", "default": 100 }, "notionConnector": { "title": "Notion connector (optional)", "type": "string", "description": "Optional. Write each item as a page into your Notion when the run finishes. Authorize a Notion connector once in Settings → API & Integrations → MCP connectors, then pick it here. Leave empty to skip (default) — results are always saved to the dataset regardless." }, "notionParentId": { "title": "Notion target data source ID", "type": "string", "description": "Optional. The Notion data source ID of the database to write into (only used if a Notion connector is set). Leave empty to create the pages privately in your workspace instead." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional proxy for SEC requests. SEC's public APIs have no anti-bot protection, so a proxy gives no scraping benefit here — this actor does no IP rotation. Leave it off (default). Only enable a proxy if you specifically want anonymity, a particular geolocation, or you hit IP-level rate limits from your own network.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```