SEC Edgar Filings Scraper avatar

SEC Edgar Filings Scraper

Pricing

Pay per usage

Go to Apify Store
SEC Edgar Filings Scraper

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

CQ

Maintained by Community

Actor stats

4

Bookmarked

121

Total users

17

Monthly active users

21 days ago

Last modified

Features

Limited permissions

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 ALL to return every form a company has filed.
  • Optional XBRL financial metrics — when a filing has XBRL data, the actor queries SEC's XBRL companyfacts API 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):

FieldDescription
accessionNumberUnique SEC filing identifier
cikCompany Central Index Key (10-digit)
companyName, tickerCompany name and primary ticker
formTypeSEC form type (10-K, 10-Q, 8-K, 4, …)
filedDate, reportDate, acceptanceDateTimeFiling / period / acceptance dates
fiscalYear, fiscalQuarter, fiscalYearEndDerived fiscal period info
sic, sicDescription, stateOfIncorporation, exchangesCompany classification info
primaryDocument, documentUrl, filingUrl, indexUrl, secViewerUrlDocument and filing links
size, isXBRL, isInlineXBRL, fileNumber, filmNumber, actTechnical metadata
itemsParsed 8-K item codes with descriptions (8-K only)
descriptionHuman-readable, templated description
extractedAtExtraction timestamp (ISO 8601)

Conditional fields:

FieldCondition
aiSummaryincludeAISummary=true — structured, template-based summary (not an LLM)
financialsincludeFinancials=true and form is 10-K/10-Q — XBRL flags, fiscal info, and xbrlMetrics when the SEC XBRL API returns data
insiderTradingincludeInsiderTrades=true and form is 4/4A — parsed Form 4 transactions and summary (falls back to basic metadata if the XML can't be parsed)
documentContentincludeDocumentContent=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

  1. Open the actor on Apify.
  2. Choose a Search Type — ticker, cik, companyName, or formType.
  3. Enter your search values (ticker symbols, CIKs, or a company name).
  4. Pick the Form Types you want (or ALL).
  5. Optionally set a date range and the include* toggles.
  6. 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

ParameterTypeDefaultDescription
searchTypestring"ticker"Search method: ticker, cik, companyName, or formType
tickersarray[] (prefills ["AAPL"])Stock ticker symbols (used when searchType=ticker)
ciksarray[]SEC Central Index Keys (used when searchType=cik)
companyNamestring""Company-name lookup (used when searchType=companyName)
formTypesarray["10-K", "10-Q", "8-K"]Form types to retrieve; include ALL to return every form
dateFromstring""Start date, YYYY-MM-DD
dateTostring""End date, YYYY-MM-DD (empty = up to today)
includeDocumentContentbooleanfalseFetch and attach the primary document's plain text (slower)
includeAISummarybooleantrueAdd a structured, template-based summary (not an LLM)
includeFinancialsbooleantrueAdd XBRL availability flags, fiscal info, and best-effort XBRL metrics
includeInsiderTradesbooleantrueParse Form 4 XML for insider transactions
maxFilingsinteger100Max filings per company (0 = unlimited)
incrementalModebooleanfalseOnly return filings newer than the last run (tracked in Key-Value Store)
alertWebhookUrlstring""POST a JSON alert here when incremental mode finds new filings
alertFormTypesarray[]Only alert for these form types (empty = alert on all new filings)
sinceAccessionNumberstring""Only return filings newer than this accession number (manual incremental)
outputFormatstring"json"Preferred dataset format: json, csv, or xlsx
proxyConfigurationobject—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 ApifyClient
client = 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.

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-Agent with 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

FormDescription
10-KAnnual report with audited financial statements
10-QQuarterly report with unaudited financials
8-KCurrent report for material events
4Insider trading — statement of changes in beneficial ownership
DEF 14ADefinitive proxy statement
S-1Registration statement (IPO)
13F-HRInstitutional investment manager holdings
SC 13G / SC 13DBeneficial ownership reports
6-K / 20-FForeign private issuer reports
424B4Prospectus 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, lower maxFilings, split large jobs, or retry later.
  • Proxy support. A proxyConfiguration input 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-Agent header 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 the User-Agent.
  • aiSummary is 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.xbrlMetrics is populated only when a filing is tagged XBRL and SEC's companyfacts API 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 }).
  • companyName search. 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.

Resources