SEC Edgar Filings Scraper
Pricing
Pay per usage
SEC Edgar Filings Scraper
Extract SEC EDGAR filings data: 10-K, 10-Q, 8-K, Form 4, and more. Get 100+ fields per filing including company info, financial metadata, insider trades, and AI summaries. Direct access to official SEC data for investors, analysts, researchers, and compliance teams.
Pricing
Pay per usage
Rating
0.0
(0)
Developer
CQ
Maintained by CommunityActor stats
4
Bookmarked
121
Total users
17
Monthly active users
21 days ago
Last modified
Categories
Features
Share
What is SEC EDGAR Filings Scraper?
SEC EDGAR Filings Scraper retrieves official corporate filings from the U.S. Securities and Exchange Commission's EDGAR system. It fetches 10-K annual reports, 10-Q quarterly reports, 8-K current reports, Form 4 insider-trading filings, and many other SEC form types, and returns a structured record per filing with metadata, document links, optional XBRL financial metrics, parsed Form 4 transactions, and a structured summary.
It reads directly from SEC EDGAR's public JSON APIs (data.sec.gov and www.sec.gov), so there are no third-party data sources — just the official filings.
What can it do?
- Search by ticker, CIK, company name, or form type — use stock symbols (AAPL, MSFT), 10-digit SEC Central Index Keys, a company-name lookup, or a form-type-only search.
- Cover many SEC form types — 10-K, 10-Q, 8-K, Form 4, DEF 14A, S-1, 13F-HR, SC 13G/D, 6-K, 20-F, 424B4, plus amendments; choose
ALLto return every form a company has filed. - Optional XBRL financial metrics — when a filing has XBRL data, the actor queries SEC's XBRL
companyfactsAPI and attaches available metrics (e.g. revenue, net income, EPS, total assets, cash flow) on a best-effort basis. - Parse Form 4 insider transactions — reads the Form 4 XML and extracts reporting owners, transaction codes, shares, price, acquired/disposed indicators, and a buy/sell summary.
- Structured filing summaries — a deterministic, template/keyword-based summary per filing (this is pattern extraction, not an LLM).
- Filter by date range — restrict results by filing date.
- Incremental mode + webhook alerts — track state between runs and only return new filings; optionally POST a JSON alert to a webhook (Slack/Discord/Zapier/any HTTP endpoint) when new filings appear.
- Export — download the dataset as JSON, CSV, or Excel from the Apify platform.
Output fields
Each dataset item corresponds to one filing. Core fields (always present where SEC provides them):
| Field | Description |
|---|---|
accessionNumber | Unique SEC filing identifier |
cik | Company Central Index Key (10-digit) |
companyName, ticker | Company name and primary ticker |
formType | SEC form type (10-K, 10-Q, 8-K, 4, …) |
filedDate, reportDate, acceptanceDateTime | Filing / period / acceptance dates |
fiscalYear, fiscalQuarter, fiscalYearEnd | Derived fiscal period info |
sic, sicDescription, stateOfIncorporation, exchanges | Company classification info |
primaryDocument, documentUrl, filingUrl, indexUrl, secViewerUrl | Document and filing links |
size, isXBRL, isInlineXBRL, fileNumber, filmNumber, act | Technical metadata |
items | Parsed 8-K item codes with descriptions (8-K only) |
description | Human-readable, templated description |
extractedAt | Extraction timestamp (ISO 8601) |
Conditional fields:
| Field | Condition |
|---|---|
aiSummary | includeAISummary=true — structured, template-based summary (not an LLM) |
financials | includeFinancials=true and form is 10-K/10-Q — XBRL flags, fiscal info, and xbrlMetrics when the SEC XBRL API returns data |
insiderTrading | includeInsiderTrades=true and form is 4/4A — parsed Form 4 transactions and summary (falls back to basic metadata if the XML can't be parsed) |
documentContent | includeDocumentContent=true — plain text of the primary document, truncated to ~50K characters |
The full item shape is defined in .actor/dataset_schema.json.
How to use it
- Open the actor on Apify.
- Choose a Search Type —
ticker,cik,companyName, orformType. - Enter your search values (ticker symbols, CIKs, or a company name).
- Pick the Form Types you want (or
ALL). - Optionally set a date range and the
include*toggles. - Run the actor and download results as JSON, CSV, or Excel.
Input example
{"searchType": "ticker","tickers": ["AAPL", "MSFT", "GOOGL"],"formTypes": ["10-K", "10-Q", "8-K"],"dateFrom": "2024-01-01","dateTo": "2024-12-31","includeAISummary": true,"includeFinancials": true,"includeInsiderTrades": true,"maxFilings": 100}
Input parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
searchType | string | "ticker" | Search method: ticker, cik, companyName, or formType |
tickers | array | [] (prefills ["AAPL"]) | Stock ticker symbols (used when searchType=ticker) |
ciks | array | [] | SEC Central Index Keys (used when searchType=cik) |
companyName | string | "" | Company-name lookup (used when searchType=companyName) |
formTypes | array | ["10-K", "10-Q", "8-K"] | Form types to retrieve; include ALL to return every form |
dateFrom | string | "" | Start date, YYYY-MM-DD |
dateTo | string | "" | End date, YYYY-MM-DD (empty = up to today) |
includeDocumentContent | boolean | false | Fetch and attach the primary document's plain text (slower) |
includeAISummary | boolean | true | Add a structured, template-based summary (not an LLM) |
includeFinancials | boolean | true | Add XBRL availability flags, fiscal info, and best-effort XBRL metrics |
includeInsiderTrades | boolean | true | Parse Form 4 XML for insider transactions |
maxFilings | integer | 100 | Max filings per company (0 = unlimited) |
incrementalMode | boolean | false | Only return filings newer than the last run (tracked in Key-Value Store) |
alertWebhookUrl | string | "" | POST a JSON alert here when incremental mode finds new filings |
alertFormTypes | array | [] | Only alert for these form types (empty = alert on all new filings) |
sinceAccessionNumber | string | "" | Only return filings newer than this accession number (manual incremental) |
outputFormat | string | "json" | Preferred dataset format: json, csv, or xlsx |
proxyConfiguration | object | — | Apify proxy settings (see Limitations regarding datacenter IPs) |
Output example
{"accessionNumber": "0000320193-24-000123","cik": "0000320193","companyName": "Apple Inc.","ticker": "AAPL","formType": "10-K","filedDate": "2024-11-01","reportDate": "2024-09-28","acceptanceDateTime": "2024-11-01T18:01:14.000Z","fiscalYear": 2024,"fiscalQuarter": 4,"sic": "3571","sicDescription": "Electronic Computers","stateOfIncorporation": "CA","exchanges": ["Nasdaq"],"documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/.../aapl-20240928.htm","isXBRL": true,"isInlineXBRL": true,"description": "10-K filing for Apple Inc. (AAPL) filed on 2024-11-01 - Annual Report","aiSummary": "**10-K Summary for Apple Inc.** ...","financials": {"formType": "10-K","reportPeriod": "2024-09-28","hasXBRL": true,"hasInlineXBRL": true,"fiscalYear": 2024,"xbrlMetrics": {"revenue": { "value": 391035000000, "period": "2024-09-28", "form": "10-K", "filed": "2024-11-01", "unit": "USD" }}},"extractedAt": "2024-11-05T12:00:00.000Z"}
Exact fields depend on the form type and the include* options; unavailable fields are null.
Pricing
This actor runs on Apify and is billed under Apify's standard pay-per-usage model (platform compute units, plus any proxy or data transfer you enable). Cost scales with the number of filings you extract and which options you turn on — full-document extraction, XBRL metrics, and Form 4 parsing each add extra SEC requests and processing time. See the actor's pricing on its Apify Store page and your Apify plan for current rates. The Apify free tier includes monthly platform credits you can use to try it out.
Integrations
Apify API
curl "https://api.apify.com/v2/acts/YOUR_USERNAME~sec-edgar-filings-scraper/runs" \-H "Authorization: Bearer YOUR_API_TOKEN" \-H "Content-Type: application/json" \-d '{"searchType": "ticker","tickers": ["NVDA"],"formTypes": ["10-K", "8-K"],"maxFilings": 10}'
Python
from apify_client import ApifyClientclient = ApifyClient("YOUR_API_TOKEN")run = client.actor("YOUR_USERNAME/sec-edgar-filings-scraper").call(run_input={"searchType": "ticker","tickers": ["NVDA", "AMD"],"formTypes": ["10-K", "10-Q"],"maxFilings": 50})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(f"{item['companyName']} - {item['formType']} - {item['filedDate']}")
JavaScript
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });const run = await client.actor('YOUR_USERNAME/sec-edgar-filings-scraper').call({searchType: 'ticker',tickers: ['TSLA'],formTypes: ['8-K'],maxFilings: 20});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items);
MCP server
This actor also ships a Model Context Protocol server (src/mcp-server.js) exposing SEC-search tools (search_sec_filings, get_company_info, get_filing_summary, get_insider_trades, get_8k_events) for use by AI agents. See .actor/mcp.json.
Is it legal to scrape SEC EDGAR?
Yes. SEC EDGAR is a public system operated by the U.S. Securities and Exchange Commission to provide free public access to corporate filings, and the SEC publishes documented APIs for programmatic access. This actor:
- Sends a descriptive
User-Agentwith contact info, as SEC's access policy requires. - Rate-limits its requests to stay within SEC's published guidance.
- Retrieves only publicly available filing data.
Supported SEC form types
| Form | Description |
|---|---|
| 10-K | Annual report with audited financial statements |
| 10-Q | Quarterly report with unaudited financials |
| 8-K | Current report for material events |
| 4 | Insider trading — statement of changes in beneficial ownership |
| DEF 14A | Definitive proxy statement |
| S-1 | Registration statement (IPO) |
| 13F-HR | Institutional investment manager holdings |
| SC 13G / SC 13D | Beneficial ownership reports |
| 6-K / 20-F | Foreign private issuer reports |
| 424B4 | Prospectus filed pursuant to Rule 424 |
Amendments (10-K/A, 10-Q/A, 8-K/A) and, via ALL, any other form the company has filed are also returned.
Limitations
- SEC EDGAR rate limits & IP blocking. SEC EDGAR enforces a request-rate limit (guidance is up to ~10 requests/second) and frequently throttles or blocks datacenter IP addresses with HTTP
403/429. Apify runs from datacenter IPs, so on busy runs some or all requests may be blocked. When that happens the run still finishes successfully with an empty or partial dataset and logs a clear explanation — it does not crash. To reduce blocking, lowermaxFilings, split large jobs, or retry later. - Proxy support. A
proxyConfigurationinput is exposed, but the current build does not yet route SEC requests through it — requests use the run's default egress IP. Do not rely on residential-proxy routing to bypass SEC blocks until this is wired up. - Descriptive User-Agent required. SEC requires a
User-Agentheader identifying the requester with contact info. This actor sends one on every SEC request. If you fork/self-host, keep a valid contact address in theUser-Agent. aiSummaryis not an LLM. Summaries are generated by deterministic templates and keyword matching, not a language model. Treat them as structured highlights, not analysis.- XBRL metrics are best-effort.
financials.xbrlMetricsis populated only when a filing is tagged XBRL and SEC'scompanyfactsAPI returns matching US-GAAP tags. Some metrics (e.g. free cash flow, book value per share) rely on non-standard tags and are often absent. Values come straight from SEC XBRL data and are not audited, normalized, or restated by this actor. - Insider-trade parsing coverage. Form 4 parsing handles standard ownership-document XML. Unusual layouts or missing XML fall back to basic metadata (
{ issuer, secLink, note }). companyNamesearch. Name lookup resolves to CIKs via EDGAR's company-search endpoint and returns up to ~10 matches; broad or ambiguous names may miss the entity you want — prefer a ticker or CIK for precision.- Historical coverage. Results reflect what SEC EDGAR's submissions API exposes for each company (recent filings plus older archive files). Availability of very old filings varies by company.
- Not financial advice. All output is raw public disclosure data for informational purposes only. It is not investment, legal, tax, or financial advice, and may contain errors or omissions from the underlying SEC data. Verify against the official filing before relying on it.
Technical details
- Data source: Official SEC EDGAR APIs (
data.sec.gov,www.sec.gov). - Rate limiting: Client-side spacing between requests to respect SEC guidance.
- User-Agent: Descriptive header with contact info on every SEC request.