SEC's free EDGAR APIs vs a filings search API: what each is for
Uses Filings search, Financial statements
The SEC publishes a lot for free, and for some jobs it is all you need. It is worth knowing exactly what is there before paying anyone.
What the SEC gives you
data.sec.gov/submissions/CIK##########.json: every filing for one company, by CIK. No search across companies.data.sec.gov/api/xbrl/companyfacts/: every XBRL value a company has tagged, under its own tag names, with duplicates across filings.efts.sec.gov/LATEST/search-index: full-text search since 2001, 100 hits a page and 10,000 a query.- Nightly bulk files:
submissions.zip(about 1.6 GB) andcompanyfacts.zip, plus quarterly data sets for Form 3/4/5, 13F, Form D and N-PORT.
All of it asks for a User-Agent with your contact details and allows 10 requests a second.
Where it stops
- No query across companies by field: you cannot ask the SEC for every Form 4 purchase over $1 million last month. You download the quarter's Form 4 data set, which arrives after the quarter ends, and filter it yourself.
- No tickers on most of it. Filings are keyed by CIK; mapping to tickers and keeping that map current is your job.
- Raw XBRL tags. Comparing revenue across companies means building the tag mapping that the financials endpoint already applies.
- 13F and insider data sets are quarterly. Nothing between filings.
When the free route is enough
One company's filing list, a one-off pull of a few hundred filings, or a research project that can wait for the quarterly data sets: use the SEC directly. When you need a query across every company that is current to the minute, with tickers and the same field names everywhere, that is what the SEC API is for.