SEC EDGAR Financial Filings Scraper

Search and download SEC EDGAR filings for any public company. Look up by company name, CIK number, or full-text search. Returns 10-K, 10-Q, 8-K, and other filing types with direct links to documents. Pure HTTP, no browser.

What data does it extract?

Field	Description
companyName	Company legal name as registered with the SEC
cik	Central Index Key (SEC company identifier)
formType	Filing form type (10-K, 10-Q, 8-K, DEF 14A, S-1, etc.)
filingDate	Date the filing was submitted
accessionNumber	Unique SEC filing identifier
primaryDocument	Filename of the main document
fileUrl	Direct URL to the filing document
description	Filing description
reportDate	Period covered by the report
sic	Standard Industrial Classification code
sicDescription	Industry description (e.g. "Electronic Computers")
stateOfIncorporation	State where the company is incorporated
address	Business address on file with the SEC

Use cases

• Financial analysis -- Pull 10-K and 10-Q filings for a company to analyze financials.
• Due diligence -- Retrieve all filings for a target company before an acquisition or investment.
• Regulatory monitoring -- Track 8-K filings (material events) for companies in a portfolio.
• Academic research -- Build datasets of SEC filings across industries for quantitative studies.
• Compliance auditing -- Verify that a company has filed required reports on time.

How to use

Get Apple's annual reports by CIK:

{
    "cikNumbers": ["0000320193"],
    "formTypes": ["10-K"],
    "maxResults": 10,
    "dateFrom": "2020-01-01"
}

Search by company name:

{
    "companyName": "Tesla Inc",
    "formTypes": ["10-K", "10-Q"],
    "maxResults": 20
}

Full-text search across all filings:

{
    "searchQuery": "artificial intelligence risk factors",
    "formTypes": ["10-K"],
    "maxResults": 50,
    "dateFrom": "2023-01-01",
    "dateTo": "2024-12-31"
}

Input parameters

Parameter	Type	Default	Description
companyName	string	(empty)	Search by company name (e.g. "Apple Inc", "Tesla")
cikNumbers	string[]	[]	Direct CIK number lookup (e.g. ["0000320193"])
searchQuery	string	(empty)	Full-text search across all filing contents
formTypes	string[]	[]	Filter by form types (e.g. ["10-K", "10-Q", "8-K"]). Empty = all types.
maxResults	integer	100	Maximum filings to return (1-1000)
dateFrom	string	(none)	Start date filter (YYYY-MM-DD)
dateTo	string	(none)	End date filter (YYYY-MM-DD)

At least one of companyName, cikNumbers, or searchQuery is required.

Output example

{
    "companyName": "Apple Inc.",
    "cik": "0000320193",
    "formType": "10-K",
    "filingDate": "2024-11-01",
    "accessionNumber": "0000320193-24-000081",
    "primaryDocument": "aapl-20240928.htm",
    "fileUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000081/aapl-20240928.htm",
    "description": "Annual Report",
    "reportDate": "2024-09-28",
    "sic": "3571",
    "sicDescription": "Electronic Computers",
    "stateOfIncorporation": "CA",
    "address": "ONE APPLE PARK WAY, CUPERTINO, CA, 95014"
}

Performance & cost

• Throttled to ~5 requests/second to stay within SEC rate limits (max 10 req/sec).
• CIK lookups are fastest -- one API call per company. Full-text search paginates at 100 results per page.
• Auto-enriches company details (SIC code, address) for up to 20 unique companies per run.

FAQ

How do I find a company's CIK number? Search on https://www.sec.gov/cgi-bin/browse-edgar or use the companyName parameter instead. The scraper handles both.

What form types are available? Common ones: 10-K (annual report), 10-Q (quarterly), 8-K (material events), DEF 14A (proxy), S-1 (IPO registration). The SEC has hundreds of form types.

Do I need an API key? No. The SEC EDGAR API is free and public. A proper User-Agent header is sent with every request as required by SEC policy.

Why are some company details missing? Full-text search results may lack SIC descriptions and addresses. The scraper enriches up to 20 unique companies automatically, but skips enrichment beyond that to avoid rate-limiting.