SEC EDGAR Data Scraper API: filings by ticker

SEC EDGAR Data Scraper collects structured SEC filings by stock ticker for investors, analysts, compliance teams, researchers, and data teams that need clean EDGAR filing metadata, document links, and optional submission text without running a browser.

Use it to fetch 10-K, 10-Q, 8-K, DEF 14A, Forms 3, 4, 5, ownership filings, registration statements, and other public company filings from SEC EDGAR.

Main Use Cases

• Monitor public company filings by ticker.
• Build filing datasets for financial research, backtesting, and market monitoring.
• Collect direct SEC links for primary documents, filing detail pages, headers, and attachments.
• Track governance filings, proxy statements, ownership filings, and insider activity.
• Feed structured EDGAR metadata into spreadsheets, BI tools, databases, or AI workflows.

Data Extracted

Each dataset item represents one matched SEC filing and can include:

• Company fields: ticker, company name, CIK.
• Filing fields: form type, filing category, filing date, report date, accepted timestamp, period of report, accession number.
• Source links: filing detail URL, primary document URL, filing header URL.
• Document manifest: attachment names, document types, file sizes, categories, URLs, and primary-document flags.
• Optional full submission text: parsed SEC header fields, filer details, document text, and summary fields when the filing is text-extractable.

Input Configuration

Start with ticker symbols and keep the date range narrow when you want the lowest cost.

• tickers - Required list of stock tickers, such as AAPL, MSFT, or NVDA. Duplicates are removed.
• filingFocus - A simple preset: investor, investor_plus_governance, company_filings, ownership, or all.
• dateFrom and dateTo - Filing date range in YYYY-MM-DD format.
• enrichmentMode - Use filing-detail for normal metadata and document links at the 256 MB default. Use full only when you need parsed submission text and run with at least 512 MB memory.
• maxFilingsPerTicker - Recommended for predictable cost, especially with broad date ranges.
• formTypes - Optional exact SEC forms, such as 10-K, 10-Q, 8-K, DEF 14A, 4, or S-1.
• filingCategories - Optional category filter: financial_reports, company_updates, governance, capital_markets, ownership, or other.

Example Input

{
  "tickers": ["AAPL", "MSFT", "NVDA"],
  "formTypes": ["10-K", "10-Q", "8-K"],
  "dateFrom": "2025-01-01",
  "dateTo": "2025-12-31",
  "enrichmentMode": "filing-detail",
  "maxFilingsPerTicker": 10
}

For parsed complete submission text:

{
  "tickers": ["AAPL"],
  "formTypes": ["10-K"],
  "dateFrom": "2025-01-01",
  "dateTo": "2025-12-31",
  "enrichmentMode": "full",
  "maxFilingsPerTicker": 1
}

Example Output

{
  "ticker": "AAPL",
  "companyName": "Apple Inc.",
  "cik": "0000320193",
  "formType": "8-K",
  "filingCategory": "company_updates",
  "filingDate": "2025-12-05",
  "reportDate": "2025-12-04",
  "acceptedAt": "2025-12-05 16:31:42",
  "periodOfReport": "2025-12-04",
  "accessionNumber": "0001140361-25-044561",
  "filingDetailUrl": "https://www.sec.gov/Archives/edgar/data/320193/000114036125044561/0001140361-25-044561-index.html",
  "primaryDocumentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000114036125044561/ef20060722_8k.htm",
  "filingHeaderUrl": "https://www.sec.gov/Archives/edgar/data/320193/000114036125044561/0001140361-25-044561.hdr.sgml",
  "documentCount": 2,
  "dataFileCount": 5,
  "submissionTextStatus": "not_requested",
  "submissionTextTextTruncated": false
}

Running On Apify

1. Open the Actor on Apify.
2. Add one or more ticker symbols.
3. Choose a filing focus or exact form types.
4. Set a date range and maxFilingsPerTicker when you want predictable cost.
5. Run the Actor and open the Dataset tab when it finishes.

Results can be exported from Apify as JSON, JSONL, CSV, Excel, XML, and other supported formats.

Python API Example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "tickers": ["AAPL", "MSFT"],
    "formTypes": ["10-K", "10-Q", "8-K"],
    "dateFrom": "2025-01-01",
    "dateTo": "2025-12-31",
    "enrichmentMode": "filing-detail",
    "maxFilingsPerTicker": 5,
}

run = client.actor("thescrapelab/Apify-SEC-EDGAR-data").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["ticker"], item["formType"], item["filingDate"], item["filingDetailUrl"])

Pricing And Cost Control

This Actor is designed for low compute cost. Recent benchmarks showed normal capped filing-detail runs completing reliably at 256 MB memory after optimization. Full submission text parsing should use at least 512 MB memory.

Recommended pricing model:

• Pay per event.
• Keep a very small Actor start event.
• Charge per dataset result with apify-default-dataset-item.
• Keep ticker-search and ticker-search-premium low enough that small test runs remain affordable.

Cost-control tips:

• Use filing-detail unless you need parsed submission text.
• Use at least 512 MB memory when enrichmentMode is full.
• Set maxFilingsPerTicker for broad date ranges.
• Filter by formTypes when you only need specific SEC forms.
• Keep very large historical crawls split by ticker group or date range.

Limits And Caveats

• This Actor uses SEC public web resources and direct EDGAR endpoints. It does not use a paid third-party data API.
• full mode is slower and creates larger dataset items because it fetches and parses complete submission text.
• Some filings, especially PDF-first annual reports such as ARS, may return submissionTextStatus: "not_extractable". Metadata and source links are still returned.
• Extremely broad uncapped runs can produce large datasets. Use filters and caps for predictable cost.
• SEC data can contain amendments, missing fields, or filing-specific document structures.

Troubleshooting

No results:

• Check that the ticker is public and listed in SEC company ticker data.
• Expand the date range.
• Remove strict formTypes filters or try filingFocus: "all".

Unexpectedly high result count:

• Set maxFilingsPerTicker.
• Narrow dateFrom and dateTo.
• Use exact formTypes.

Submission text is missing:

• Set enrichmentMode to full.
• Check submissionTextStatus and submissionTextError.
• PDF-first filings may need separate PDF extraction.

Run is slower than expected:

• Use filing-detail mode.
• Reduce ticker count or split the run into smaller batches.
• Avoid broad historical ranges unless you need them.

FAQ

Can I scrape SEC EDGAR filings by ticker?

Yes. Provide stock tickers and the Actor resolves them to SEC CIK identifiers before collecting matching filings.

Does this support 10-K, 10-Q, and 8-K filings?

Yes. Use formTypes to request exact forms such as 10-K, 10-Q, and 8-K.

Can I get Form 4 insider trading filings?

Yes. Use filingFocus: "ownership" or set formTypes to include 4, 3, or 5.

Does it return direct SEC document URLs?

Yes. Results include filing detail URLs, primary document URLs, filing header URLs, and attachment manifests when available.

Does it parse full filing text?

Use enrichmentMode: "full" for parsed complete submission text when the SEC filing is text-extractable.

Is this a browser scraper?

No. It uses direct SEC web resources and EDGAR JSON/archive pages, which keeps memory and runtime lower than browser automation.

Can I export SEC filings to CSV or Excel?

Yes. Use Apify Dataset export options after the run finishes.

Keywords

SEC EDGAR API, SEC filings API, SEC filings scraper, EDGAR company filings, ticker to CIK lookup, 10-K scraper, 10-Q scraper, 8-K scraper, Form 4 scraper, insider trading filings, proxy statement scraper, public company filings dataset, financial documents API.