SEC EDGAR Filings Scraper

Give it a ticker. Get back every filing that company has made, in one flat table.

What it does

EDGAR holds every document a public US company files, and it is completely open. The awkward parts are finding the company and reading the response, and this handles both.

You can name a company three ways and they all work:

AAPL              a ticker
320193            a CIK number
Apple Inc.        the exact registered name

Anything it cannot resolve is reported by name in the run summary and skipped. It is never guessed at, because the wrong company is worse than no company.

The 1,000 filing edge, which is the thing to know

The SEC returns the newest 1,000 filings in one response and keeps everything older in separate files. A tool that reads the first response and stops gives you a plausible 1,000 rows and quietly loses the rest.

By default this Actor does the same fast thing, and then tells you: the run summary carries shardsSkipped per company, so you always know whether you have the whole history. Turn on Read the whole history and it fetches those files too.

Apple has 1,000 recent filings and 1 older file. Most companies have none.

Filtering

Form type and date are applied before the per company cap, so asking for 20 8-Ks gives you the newest 20 8-Ks rather than however many 8-Ks happen to sit inside the newest 20 filings.

Common forms: 10-K annual report, 10-Q quarterly, 8-K material event, 4 insider trade, D funding round, 13F-HR institutional holdings, S-1 IPO registration.

Watching for new filings

Turn on Only new since the last run and each run returns only filings that were not there before, marked isNew. The first run on a company records a baseline and returns everything with isNew empty, because nothing is new the first time you look.

If a company's request fails, its previous list is kept and nothing is reported for it. A filing that never existed is worse than a filing you get a day late.

Output

One row per filing:

id the accession number, cik, company, ticker, form, filingDate, reportDate, acceptedAt, items, fileNumber, sizeBytes, isXBRL, primaryDocument, title, url, filingIndexUrl.

url points at the document itself and filingIndexUrl at the folder listing every attachment in that filing. Both were checked live.

Access

EDGAR is free and needs no key. It does ask for a User-Agent that identifies who is calling, and it throttles anything that does not send one, so this Actor sends a real contact address on every request.

Pricing

Pay per event. You are charged for filings you actually get, and the small start charge only happens once a company returns something.