SEC 8-K Material Events — item codes, exhibits, severity

Every 8-K filed on EDGAR in your window, with the SEC's own item codes, a typed list of exhibits with direct links, the event date next to the filed date, a category and a severity — for a fraction of a cent per filing. Plain HTTP against sec.gov at the SEC's rate limit. No browser, no proxy, no paid data, no API key.

What you get that a summary-table scraper doesn't

Field	Why it matters
items — ["5.02","9.01"]	The 8-K item codes, read from the SEC's own filing header (the ITEM INFORMATION lines), not guessed from prose. 2.02 = earnings, 5.02 = officer/director change, 1.05 = cybersecurity incident, 4.02 = restatement, 3.01 = delisting notice, 1.03 = bankruptcy.
exhibits	Every exhibit with type, description and a direct EDGAR URL — EX-99.1 press release, EX-10.x agreements, EX-2.1 merger agreement. XBRL plumbing is filtered out. pressReleaseUrl is the first EX-99 link, ready to fetch.
eventDate vs filedDate, lagDays	The event happened on the period of report; the filing came later. A 4-day lag on a 5.02 is a different story from a same-day one.
category, severity	earnings · leadership · deal · distress · cyber · capital · governance · disclosure · other, with severity 0–5 from the most serious item. Filter on it.
tickers	From the SEC's company_tickers.json, so the CIK-to-ticker mapping is the SEC's, not a third party's.
acceptedAt	EDGAR's acceptance timestamp — after-hours filings are visible as such.

A real record

Produced from live EDGAR data on 2026-09-21. A pharmaceutical company filed a delisting notice the day after the event:

{
  "type": "event",
  "form": "8-K",
  "isAmendment": false,
  "cik": "0001677940",
  "company": "BeyondSpring Inc.",
  "tickers": ["BYSI"],
  "accession": "0001171843-26-006116",
  "filedDate": "2026-09-18",
  "eventDate": "2026-09-17",
  "acceptedAt": "2026-09-18T16:30:17",
  "lagDays": 1,
  "items": ["3.01"],
  "itemTitles": ["Notice of Delisting or Failure to Satisfy a Continued Listing Rule or Standard; Transfer of Listing"],
  "category": "distress",
  "severity": 4,
  "sic": "PHARMACEUTICAL PREPARATIONS",
  "sicCode": "2834",
  "exhibits": [
    {"type": "8-K", "description": "FORM 8-K", "url": "https://www.sec.gov/Archives/edgar/data/1677940/000117184326006116/f8k_091826.htm"}
  ],
  "pressReleaseUrl": null,
  "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/1677940/000117184326006116/0001171843-26-006116-index.htm",
  "scanEndDate": "2026-09-21"
}

In the same 40-filing sample: 9 deals (1.01 / 2.01), 6 leadership changes (5.02), 5 capital events (2.03 / 3.02), 2 distress, 1 earnings — 19 with a press-release link, 34 with a ticker.

How to use it

• Watch a list: tickers: ["NVDA","AAPL"], lookbackDays: 2, run daily. You get every 8-K those companies filed, classified, with the press release linked.
• Screen the whole market for one thing: items: ["1.05"] (cyber incidents) or ["4.02"] (restatements) or minSeverity: 4 across the full window.
• Feed an agent: the dataset is JSON; pressReleaseUrl and each exhibit URL are direct documents your own tool can read.

Inputs

Input	Default	Notes
secContactEmail	(required)	The SEC's fair-access policy requires automated requests to identify their sender; EDGAR returns 403 without it. Sent only to sec.gov in the User-Agent.
lookbackDays	5	Calendar days back from endDate. Weekends and federal holidays have no index and are skipped.
endDate	today
tickers / items / categories / minSeverity	none	Filters. Empty = everything.
includeAmendments	true	8-K/A carried with isAmendment: true.
includeExhibits	true	One extra request per filing for the exhibit inventory.
maxFilings	100	Newest first. Bounds runtime and cost. The default finishes in about a minute on the platform and costs at most $0.20.

Pricing (pay per event)

No start fee. You pay a tenth of a cent per filing parsed and a tenth of a cent per record delivered, so the bill tracks what the run actually did:

Event	Price	Charged when
8-K filing	$0.001	per filing whose header and exhibit index were fetched and parsed. Errors are not charged.
8-K event record delivered	$0.001	per record that passes your filters into the dataset — the output you came for.

Worked examples, in cents.

• Click Start with the defaults (100 newest filings, every one kept): 100 × 0.1¢ + 100 × 0.1¢ = 20¢.
• A full business day (400 filings, every one kept): 400 × 0.1¢ + 400 × 0.1¢ = 80¢. Run it every trading day and a month is about $17.
• A five-ticker watch list over a week (about 1,500 filings scanned, 6 records match): 1,500 × 0.1¢ + 6 × 0.1¢ = $1.51 — the records are almost free; you pay for the scan.
• Severity ≥ 3 only, one day (400 parsed, 40 kept): 40¢ + 4¢ = 44¢.

For comparison, the incumbent 8-K tracker on this Store charges 2.5¢ per row: the full-business-day run above costs $10 there and 80¢ here. Apify platform usage is billed separately and is small: this is a plain Python container with no browser.

Rate limits and compliance

The Actor sends your contact address to the SEC, holds about 7.5 requests per second (the SEC's ceiling is 10), and there is no input that can raise it. It fetches only the daily index, each filing's header (streamed, stopped at the header's end) and each filing's index page. It never fetches exhibit bodies — that's your call, with the URLs it gives you.

Limits, stated

• Items come from the SEC header. A filer that mislabels an item is reported as filed.
• tickers covers issuers in the SEC's ticker file; some small filers and non-issuers have none.
• No full-text of the 8-K body is returned — the point is the structured fields and the links.