🏦 SEC EDGAR Filings Scraper: 10-K, 10-Q, 8-K to JSON

Overview

SEC EDGAR Filings Scraper pulls filings from EDGAR (10-K, 10-Q, 8-K, S-1, Form 4, DEF 14A, and every other form type) as clean structured JSON that drops straight into an AI or RAG pipeline, a vector database, or a fintech data model. Resolve any stock ticker to its SEC CIK automatically, filter by form and date, and optionally attach XBRL financial facts and RAG-ready filing text. You pay only for filings actually delivered; empty runs and unknown tickers are never charged.

The SEC publishes everything through EDGAR, but the raw endpoints are awkward: zero-padded CIKs, parallel-array JSON, hand-built document URLs, and fair-access rules on the User-Agent. This actor handles all of that and returns one tidy record per filing.

✅ No API key | ✅ Ticker to CIK auto-resolve | ✅ Optional XBRL financials & RAG text | ✅ First 10 filings free | ✅ MCP-ready for AI agents

Features

Ticker to CIK resolution built in: pass AAPL and get Apple's filings, with no lookup step. Form and date filtering server-side, so you get only the 10-Ks (or 8-Ks, or Form 4s) you asked for. Reconstructed, click-ready URLs for both the primary document and the filing index. Optional XBRL financial facts (revenue, net income, total assets, liabilities, equity, cash) from the SEC's structured company-facts API. Optional RAG-ready text: the primary document fetched and cleaned to plain text, ready for chunking and embedding.

How it works

The actor calls the SEC's data endpoints (data.sec.gov, www.sec.gov/Archives) with a fair-access User-Agent that includes your contact email and paced request timing. Tickers are resolved to zero-padded CIKs via the SEC's company_tickers.json mapping. For each company it fetches the submissions feed and normalizes the parallel-array JSON into one record per filing, then applies your form and date filters.

When includeFinancials is on, it pulls the company-facts API and attaches a summary of key XBRL facts. When includeDocumentText is on, it fetches the primary document, strips scripts and markup, and attaches cleaned plain text for LLM ingestion.

🧾 Input configuration

{
  "tickers": ["AAPL", "MSFT", "NVDA"],
  "formTypes": ["10-K", "10-Q"],
  "maxFilingsPerCompany": 4,
  "includeFinancials": true,
  "contactEmail": "you@yourcompany.com"
}

📤 Output format

{
  "ticker": "AAPL",
  "cik": "0000320193",
  "company_name": "Apple Inc.",
  "sic": "Electronic Computers",
  "form": "10-K",
  "filing_date": "2025-10-31",
  "report_date": "2025-09-27",
  "accession_number": "0000320193-25-000079",
  "primary_document": "aapl-20250927.htm",
  "primary_doc_description": "10-K",
  "is_xbrl": true,
  "size_bytes": 9392337,
  "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
  "index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "financial_facts": {
    "revenue": { "value": 111184000000, "unit": "USD", "period_end": "2026-03-28", "form": "10-Q", "fy": 2026 },
    "net_income": { "value": 29578000000, "unit": "USD", "period_end": "2026-03-28", "form": "10-Q", "fy": 2026 },
    "total_assets": { "value": 371082000000, "unit": "USD", "period_end": "2026-03-28", "form": "10-Q", "fy": 2026 }
  },
  "scraped_at": "2026-07-15T04:17:32.066Z"
}

This record was captured from a live run against AAPL with includeFinancials on. Note financial_facts reflects the most recent XBRL facts available from SEC's company-facts API at scrape time (here a 10-Q period), not necessarily the 10-K's own fiscal year, since SEC's structured facts feed is updated independently of the filing being returned.

Every filing record contains these fields:

Field	Description
🎯 ticker	Input ticker (or null if you passed CIKs directly)
🆔 cik	Zero-padded SEC CIK
🏢 company_name	Company name
🏭 sic	SIC industry classification
📄 form	Filing form type (10-K, 10-Q, 8-K)
📅 filing_date	Filing date
🗓️ report_date	Report period end date
🔢 accession_number	SEC accession number
📎 primary_document	Primary document filename
📝 primary_doc_description	Document description
✅ is_xbrl	True if the filing includes XBRL data
🔗 filing_url	Direct URL to the primary document
🗂️ index_url	URL to the accession index page
💵 financial_facts	XBRL summary (when includeFinancials is on)
✍️ document_text	Cleaned plain-text filing (when includeDocumentText is on)
🕒 scraped_at	ISO timestamp of capture

💼 Common use cases

AI and RAG knowledge bases Ingest a company's full 10-K and 10-Q history as clean text, chunk it, embed it, and ground an LLM in real filings. Batch across a watchlist to build a working-capital RAG pipeline.

Fintech dashboards Track new 8-Ks (material events), insider Form 4 transactions, or quarterly financials across a portfolio. Feed the flat records into your BI or trading dashboard.

Quant and research pipelines Pull standardized XBRL financial facts across hundreds of tickers for screening and modelling. Run monthly against a universe to keep fundamental data current.

Compliance and monitoring Schedule a daily run over a client or counterparty list and capture every new filing the moment it hits EDGAR. Alert on specific form types (e.g. 8-K item 2.05 for restructuring) via downstream tooling.

🚀 Getting started

1. Open the actor and enter Stock tickers (e.g. AAPL, MSFT) or paste direct CIKs.
2. Optionally set Form types (10-K, 10-Q, 8-K); leave empty for every form.
3. Set Max filings per company (default 10) and optional date range.
4. Toggle Include financial facts and Include filing text if you need XBRL or RAG-ready content.
5. Add your Contact email for SEC fair-access, then click Save & Start.

FAQ

Do I need an SEC API key? No. EDGAR open data requires no key, only a contact email in the User-Agent for fair-access compliance.

Which companies are covered? Every company with an EDGAR CIK: 10,000+ public tickers plus funds, trusts, and Form 4 filers.

Can I get the actual financial numbers? Yes. Turn on includeFinancials for structured XBRL facts (revenue, net income, assets, liabilities, equity, cash).

Is the filing text good enough for RAG? Yes. includeDocumentText strips scripts, styles, and markup and returns clean plain text ready to chunk and embed.

How am I charged? Pay per filing at $0.004 per filing. The first 10 filings are free for life on every Apify account. Unknown tickers, no matching filings, and fetch failures cost you nothing.

Use in Claude, ChatGPT & any MCP agent

https://mcp.apify.com/?tools=themineworks/sec-edgar-filings

Or call it programmatically with the Apify client:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('themineworks/sec-edgar-filings').call({
  tickers: ['AAPL'],
  formTypes: ['10-K', '10-Q'],
  maxFilingsPerCompany: 4,
  includeFinancials: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

🛠️ Complete your fintech pipeline

Filings are one lens. Add cross-company search, entity IDs, and macro context:

• SEC EDGAR Full Text Search: find any phrase across every filer since 2001.
• GLEIF LEI Lookup: resolve counterparty and issuer LEI codes for compliance and reference data.
• World Bank Indicators: macro context for a filer's home market.

Typical flow: pull filings for a watchlist, cross-check theme exposure with full-text search, and enrich with LEI and macro data.

Found a bug or have a feature request? Open an issue on the actor's Apify Console page or reach out through the Apify profile.