SEC EDGAR Filings

What it does

Fetches SEC filing metadata for companies from the official data.sec.gov submissions API — no proxy, no scraping of rendered pages. Resolve a company by ticker, CIK, or name, get back its recent filings (10-K, 10-Q, 8-K, etc.) with links to the primary document. Optionally fetches the primary document itself and includes its plain text, with automatic Risk Factors (Item 1A) extraction for 10-Ks.

Company-level data only. No officer/insider personal data is collected — Form 4/3/5 filings are returned as metadata rows like any other form, but their per-person transaction fields are never parsed out.

Input

Field	Type	Required	Default	Description
companies	array of strings	yes	—	Ticker (AAPL), CIK (320193), or company name (Nortel Networks Corp) per company.
formTypes	array of strings	no	["10-K","8-K","10-Q"]	SEC form types to include.
maxFilings	integer	no	20	Max matching filings per company, most recent first.
includeText	boolean	no	false	Fetch the primary document text (truncated to 200,000 chars) and, for 10-Ks, its Risk Factors section.

Name resolution uses EDGAR's company-search feed and takes the first CIK match — an exact ticker or CIK is more reliable than a name, since a name search can match a similarly-named subsidiary (e.g. "Nortel Networks" alphabetically matches "Nortel Networks Capital Corp" before the actual parent "Nortel Networks Corp").

Output example

One row per filing in the default dataset:

{
  "company": "NORTEL NETWORKS CORP",
  "cik": "0000072911",
  "ticker": null,
  "formType": "8-K",
  "filedAt": "2012-10-03",
  "reportDate": "2012-10-03",
  "accessionNumber": "0001193125-12-414094",
  "primaryDocUrl": "https://www.sec.gov/Archives/edgar/data/72911/000119312512414094/d420239d8k.htm",
  "description": "8-K"
}

With includeText: true, rows also carry text (plain text, ≤200k chars) and, for 10-K rows, riskFactors (Item 1A section, ≤50k chars).

Pricing

Pay-per-event (PPE). One filing-scraped event is charged per filing row pushed via Actor.charge({ eventName: 'filing-scraped' }) — never charged on an empty result. Console price: $0.0008 per event ($0.80/1,000 filings), no start fee (docs/CANDIDATES.md #14).

Limits

• Free-plan compute only; no residential proxy — SEC is a public API.
• Requests carry a descriptive User-Agent and are throttled to stay under SEC's 10 req/s limit.
• includeText adds one extra fetch (and more compute) per filing; leave it off unless you need document text.
• Name search takes the first EDGAR match — verify the resolved cik in the output if the company name is ambiguous.