Pricing

Rating

Developer

Actor stats

Categories

Share

SEC EDGAR Financial Data Scraper (Apify Actor)

Scrape SEC EDGAR filings and XBRL financial data for public companies. This actor fetches recent filings (10-K, 10-Q, 8-K, etc.), pulls key financial metrics from XBRL, and returns clean JSON datasets.

SEC requirement: You must provide a valid email in the User-Agent header. Set userAgentEmail in the input.

Features

• Search companies by ticker or CIK
• Fetch recent filings with document links
• Extract XBRL financial metrics (Revenue, Net Income, Assets, Liabilities, etc.)
• Retrieve full company facts (optional)
• Compare metrics across companies
• Clean JSON output ready for analytics

Input

Example input:

{
"tickers":["AAPL","MSFT"],
"filingTypes":["10-K","10-Q","8-K"],
"extractFinancials":true,
"financialMetrics":["Revenue","NetIncome","Assets","Liabilities"],
"dateRange":{"from":"2021-01-01","to":"2024-12-31"},
"maxFilingsPerCompany":10,
"compareCompanies":true,
"userAgentEmail":"you@domain.com"
}

Input Fields

• tickers (array): List of ticker symbols.
• ciks (array): List of zero-padded CIKs (10 digits).
• filingTypes (array): Forms to include (default: 10-K, 10-Q, 8-K).
• extractFinancials (boolean): If true, fetch XBRL facts.
• financialMetrics (array): Metrics to extract (maps to US-GAAP tags).
• dateRange (object): from and to dates in YYYY-MM-DD.
• maxFilingsPerCompany (number): Maximum number of filings per company.
• compareCompanies (boolean): If true, adds comparison objects.
• userAgentEmail (string): Contact email required by SEC.

Output

Each dataset item is either:

• type: "company" → full company info, filings, and financials
• type: "comparisons" → comparison of metrics across companies

Example output (simplified):

{
"type":"company",
"cik":"0000320193",
"ticker":"AAPL",
"name":"Apple Inc.",
"filings":[
{
"form":"10-K",
"filingDate":"2023-10-27",
"documentUrl":"https://www.sec.gov/Archives/.../a10k.htm"
}
],
"financials":{
"Revenue":{
"unit":"USD",
"latestValue":383285000000,
"latestPeriod":"2023-09-30"
}
}
}

Local Development

npminstall
npm run dev

Run locally with Apify:

$apify run

Notes

• Rate limiting is enforced (~8 req/s) to comply with SEC policy.
• For custom metrics, pass US-GAAP tag names directly in financialMetrics.
• Company facts can be large. Use extractFinancials: false if you only need filings.

License

MIT