SEC EDGAR Financial Data Scraper

Extract official SEC filings, financial data, and company information from the SEC EDGAR database — the U.S. Securities and Exchange Commission's electronic filing system. Every public company in the United States files here.

Why use this Actor?

• Official government data — direct from SEC EDGAR, not scraped from third-party sites
• No API key required — SEC EDGAR is a free public API, no authentication needed
• No proxy needed — accessible worldwide with no geographic restrictions
• 3 modes in one Actor — filings search, XBRL financial data extraction, and company information
• 500+ financial metrics — revenue, net income, assets, liabilities, cash flow, and more via XBRL
• 20+ years of data — historical filings dating back to the 1990s

How much does it cost?

This Actor uses pay-per-event pricing. You are charged per result item returned.

No proxy costs. No API key costs. SEC EDGAR is freely accessible from any location.

Three modes

1. Filings Search

Search SEC filings by keyword, company name, or ticker. Filter by form type and date range.

Use cases: Find 10-K annual reports, 10-Q quarterly reports, 8-K material events, S-1 IPO filings, insider trading (Form 4), proxy statements (DEF 14A).

2. Financial Data (XBRL)

Extract structured financial metrics from XBRL filings. Get revenue, profit, assets, equity, and 500+ other metrics with historical values across all filing periods.

Use cases: Build financial models, compare companies, track metrics over time, screen stocks by fundamentals.

3. Company Info

Get company details (SIC code, ticker, state, fiscal year end) and complete filing history.

Use cases: Company research, due diligence, regulatory compliance monitoring.

Input parameters

Parameter	Required	Default	Description
mode	Yes	filings	filings, financials, or company
query	For filings	-	Search term (company name, keyword)
ticker	For financials/company	-	Stock ticker (AAPL) or CIK number. Comma-separated for multiple.
formTypes	No	10-K,10-Q	Comma-separated form types to filter
startDate	No	-	Start date (YYYY-MM-DD) for filings search
endDate	No	-	End date (YYYY-MM-DD) for filings search
metrics	No	all	Specific XBRL metrics to extract (comma-separated)
maxResults	No	100	Maximum results to return

Example: Filings search output

{
    "entityName": "Apple Inc.",
    "ticker": "AAPL",
    "cik": "0000320193",
    "form": "10-K",
    "filingDate": "2025-11-01",
    "period": "2025-09-27",
    "accessionNumber": "0000320193-25-000106",
    "businessLocation": "Cupertino, CA"
}

Example: Financial data output

{
    "entityName": "Apple Inc.",
    "cik": "320193",
    "metric": "Revenues",
    "label": "Revenues",
    "value": 391035000000,
    "unit": "USD",
    "startDate": "2024-09-29",
    "endDate": "2025-09-27",
    "form": "10-K",
    "fiscalYear": 2025,
    "fiscalPeriod": "FY"
}

Common XBRL metrics

Metric	Description
Revenues	Total revenue
NetIncomeLoss	Net income/loss
Assets	Total assets
Liabilities	Total liabilities
StockholdersEquity	Shareholders' equity
OperatingIncomeLoss	Operating income
EarningsPerShareBasic	Basic EPS
CashAndCashEquivalentsAtCarryingValue	Cash on hand
LongTermDebt	Long-term debt
CommonStockSharesOutstanding	Shares outstanding

SEC form types

Form	Description
10-K	Annual report
10-Q	Quarterly report
8-K	Current report (material events)
S-1	IPO registration
DEF 14A	Proxy statement
4	Insider trading
SC 13D	Beneficial ownership (>5%)
20-F	Annual report (foreign private issuer)

Use cases

• Investment research — analyze company fundamentals with 500+ XBRL metrics
• Financial screening — filter companies by revenue, profit, assets, debt ratios
• Regulatory monitoring — track new filings from specific companies or industries
• Academic research — study corporate disclosures, governance, financial trends
• Due diligence — comprehensive company background checks using official data
• Competitive analysis — compare financial metrics across competitors

FAQ

Q: How current is the data? A: SEC EDGAR data is real-time. Filings appear within minutes of being submitted to the SEC. XBRL financial data is available after the SEC processes the filing (usually within 24 hours).

Q: Can I get data for multiple companies at once? A: Yes. In financials and company modes, pass comma-separated tickers (e.g., AAPL,MSFT,GOOGL). In filings mode, search for an industry term to find filings across companies.

Q: What's the difference between filings and financials modes? A: Filings mode searches filing documents (10-K, 10-Q, etc.) by keyword. Financials mode extracts structured numerical data (revenue, profit, assets) from XBRL-tagged filings — ready for analysis without PDF parsing.

Q: How far back does the data go? A: EDGAR contains filings from the mid-1990s. XBRL financial data is available from ~2009 when the SEC mandated XBRL tagging for large accelerated filers.

Q: Can I track a specific company's new filings? A: Yes. Set up a scheduled run with the company ticker and a date range filter. Apify's scheduling lets you run daily or weekly to catch new filings.

Q: What if I only need specific metrics (e.g., just revenue and net income)? A: Use the metrics parameter with comma-separated metric names: Revenues,NetIncomeLoss. This returns only those metrics, reducing result count and cost.

Integration with Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

# Get Apple's financial data
run = client.actor("aligned_kettledrum/sec-edgar-financial").call(
    run_input={
        "mode": "financials",
        "ticker": "AAPL",
        "metrics": "Revenues,NetIncomeLoss,Assets",
        "maxResults": 50,
    }
)

# Load results into pandas
import pandas as pd
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
df = pd.DataFrame(items)

# Pivot: one row per year, columns = metrics
pivot = df.pivot_table(index="fiscalYear", columns="metric", values="value")
print(pivot)

Technical details

This Actor uses three official SEC EDGAR APIs:

• EFTS (full-text search) for filing discovery
• XBRL Company Facts for structured financial data
• Submissions for company details and filing history

All APIs are rate-limited to 10 requests/second per SEC guidelines. The Actor automatically handles this.

Data is sourced directly from SEC.gov — no intermediaries, no scraping, no authentication required.

MCP Server

Need SEC EDGAR data inside your AI agent? Use the SEC EDGAR MCP Server — same data, native MCP integration for Claude, ChatGPT, and other LLM frameworks.