# SEC Form 8-K Material Events Scraper (`scrapers_lat/sec-8k-material-events-scraper`) Actor

Scrape SEC Form 8-K filings as classified material corporate events: company, ticker, item numbers and titles, event category (Earnings, M\&A, Executive Change, Bankruptcy, Delisting), event snippet, exhibits and press release. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/sec-8k-material-events-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $11.34 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![SEC Form 8-K Material Events Scraper](https://scrapers.lat/banners/sec-8k-material-events-scraper.png)](https://console.apify.com/actors/ogxky3t944MPibGCv/input)

## SEC Form 8-K Material Events Scraper

Here is one real result, with every field the actor returns:

```json
{
  "companyName": "Apple Inc.",
  "cik": "320193",
  "ticker": "AAPL",
  "formType": "8-K",
  "isAmendment": false,
  "filedDate": "2026-07-30",
  "eventDate": "2026-07-30",
  "eventCategory": "Earnings",
  "itemCodes": ["2.02", "9.01"],
  "items": [
    {
      "itemNumber": "2.02",
      "itemTitle": "Results of Operations and Financial Condition",
      "snippet": "On July 30, 2026, Apple Inc. (\"Apple\") issued a press release regarding Apple's financial results for its third fiscal quarter ended June 27, 2026. A copy of Apple's press release is attached hereto as Exhibit 99.1."
    },
    {
      "itemNumber": "9.01",
      "itemTitle": "Financial Statements and Exhibits",
      "snippet": "(d) Exhibits. Exhibit Number Exhibit Description 99.1 Press release issued by Apple Inc. on July 30, 2026. 104 Inline XBRL for the cover page of this Current Report on Form 8-K."
    }
  ],
  "exhibits": ["EX-99.1"],
  "exhibitCount": 1,
  "accessionNo": "0000320193-26-000018",
  "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm",
  "indexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/0000320193-26-000018-index.html",
  "pressReleaseUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/a8-kex991q3202606272026.htm",
  "aiHeadline": null,
  "aiWhatHappened": null,
  "aiMarketImplication": null,
  "aiSentiment": null,
  "source": "SEC EDGAR (Form 8-K)",
  "observedAt": "2026-08-20T21:24:53.882Z"
}
```

The most complete Form 8-K event scraper available. It returns every field a public 8-K exposes (company, ticker, CIK, form type, filed and event dates, exhibits, press release), plus derived fields a raw filing list never gives you: the item numbers with their official titles, a short snippet of what each item says, and a friendly event category (Earnings, Executive Change, M\&A, Bankruptcy, Delisting, Material Agreement, and more). Three ways to target exactly the events you need: market-wide recent, by company, or filtered to specific item codes.

**📥 [Input](https://apify.com/scrapers_lat/sec-8k-material-events-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/sec-8k-material-events-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/sec-8k-material-events-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/sec-8k-material-events-scraper/examples)**

[![Platform](https://img.shields.io/badge/platform-Apify-2b3544)](https://apify.com/scrapers_lat/sec-8k-material-events-scraper)
[![Coverage](https://img.shields.io/badge/coverage-SEC%20EDGAR%208--K-1e88e5)](https://apify.com/scrapers_lat/sec-8k-material-events-scraper)
[![Output](https://img.shields.io/badge/output-JSON%20%7C%20CSV%20%7C%20Excel-2e7d32)](https://apify.com/scrapers_lat/sec-8k-material-events-scraper)
[![Billing](https://img.shields.io/badge/billing-Pay%20per%20result-f9a825)](https://apify.com/scrapers_lat/sec-8k-material-events-scraper/pricing)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)
- [More scrapers at scrapers.lat](#more-scrapers-at-scraperslat)

### What it does

Form 8-K is how U.S. public companies disclose material events between quarterly reports: earnings releases, executive departures, acquisitions, bankruptcies, delistings, new material agreements, and more. A generic filing list just tells you an 8-K was filed. This actor reads each 8-K and tells you what actually happened.

For every 8-K it returns:

- **Company identity**: company name, CIK, ticker, form type (8-K or 8-K/A), filed date and event date.
- **Item classification**: the exact item numbers reported (`itemCodes`), each with its official SEC item title and a short snippet of the disclosure text.
- **Event category**: a single friendly label derived from the item mix (Earnings, Executive Change, M\&A, Bankruptcy, Delisting, Material Agreement, Financing, Governance, Shareholder Vote, Cybersecurity, and more) so you can filter or route events at a glance.
- **Exhibits and press release**: the list of exhibits filed and a direct link to the press release (Exhibit 99.1) when one is attached.
- **Optional AI event summary** (paid add-on): a plain-language headline, what-happened description, market implication, and sentiment.

Three modes let you pull the latest events across the whole market, every 8-K for a single company, or only the item types you care about.

### Quickstart

Get the latest earnings 8-Ks across the market:

```json
{
  "mode": "recent",
  "itemCodes": ["2.02"],
  "maxResults": 10
}
```

Get every recent 8-K for a single company:

```json
{
  "mode": "byIssuer",
  "issuerTicker": "AAPL",
  "maxResults": 10
}
```

### Input reference

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `mode` | string | no | `recent` for market-wide latest events, or `byIssuer` for one company. | `recent` |
| `issuerTicker` | string | no | Ticker of the company (byIssuer mode). | `AAPL` |
| `issuerCik` | string | no | SEC CIK of the company, used instead of a ticker. Ticker wins if both set. | `320193` |
| `itemCodes` | array | no | Keep only 8-Ks reporting at least one of these item codes. | `["2.02","5.02"]` |
| `filedSince` | string | no | Only include filings on or after this date (YYYY-MM-DD). | `2026-01-01` |
| `withEventSummary` | boolean | no | Add an AI plain-language event summary. Paid plans only, charged per success. | `false` |
| `maxResults` | integer | no | Maximum records to return. Free plans are capped at 10 per run. | `10` |

### Output reference

| Name | Type | Description |
| --- | --- | --- |
| `companyName` | string | Company (registrant) that filed the 8-K. |
| `cik` | string | SEC CIK of the company. |
| `ticker` | string | Ticker symbol, when available. |
| `formType` | string | Form type (8-K or 8-K/A). |
| `isAmendment` | boolean | True when the form ends in /A. |
| `filedDate` | string | Date the 8-K was filed with the SEC. |
| `eventDate` | string | Date of the event / period of report. |
| `eventCategory` | string | Derived friendly label (Earnings, Executive Change, M\&A, Bankruptcy, Delisting, Material Agreement, Other). |
| `itemCodes` | array | Item numbers reported, for example \["2.02","9.01"]. |
| `items` | array | Per-item detail: itemNumber, official itemTitle, and a short snippet. |
| `exhibits` | array | Exhibit types filed, for example \["EX-99.1"]. |
| `exhibitCount` | number | Number of exhibits filed. |
| `accessionNo` | string | SEC accession number. |
| `filingUrl` | string | URL of the primary 8-K document. |
| `indexUrl` | string | URL of the filing index page. |
| `pressReleaseUrl` | string | URL of the press release exhibit (EX-99.1) when present. |
| `aiHeadline` | string | AI add-on: short headline of the event. |
| `aiWhatHappened` | string | AI add-on: plain-language description. |
| `aiMarketImplication` | string | AI add-on: one-line implication for the stock. |
| `aiSentiment` | string | AI add-on: positive, negative or neutral. |
| `source` | string | Data source. |
| `observedAt` | string | Timestamp the record was collected. |

### Example output record

```json
{
  "companyName": "HOVNANIAN ENTERPRISES INC",
  "cik": "357294",
  "ticker": "HOV",
  "formType": "8-K",
  "isAmendment": false,
  "filedDate": "2026-08-20",
  "eventDate": "2026-08-20",
  "eventCategory": "Earnings",
  "itemCodes": ["2.02", "9.01"],
  "items": [
    { "itemNumber": "2.02", "itemTitle": "Results of Operations and Financial Condition", "snippet": "the Company issued a press release announcing its financial results ..." },
    { "itemNumber": "9.01", "itemTitle": "Financial Statements and Exhibits", "snippet": "(d) Exhibits. 99.1 Press release ..." }
  ],
  "exhibits": ["EX-99.1"],
  "exhibitCount": 1,
  "accessionNo": "0000357294-26-000000",
  "pressReleaseUrl": "https://www.sec.gov/Archives/edgar/data/357294/.../ex99-1.htm",
  "source": "SEC EDGAR (Form 8-K)"
}
```

### Run via API and CLI

Start a run with the Apify API:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~sec-8k-material-events-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"byIssuer","issuerTicker":"AAPL","maxResults":10}'
```

Or with the Apify CLI:

```bash
apify call scrapers_lat/sec-8k-material-events-scraper \
  --input '{"mode":"recent","itemCodes":["2.02"],"maxResults":10}'
```

### Fetch results

Download the dataset items in JSON, CSV or Excel:

```bash
curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_TOKEN&format=csv"
```

The run response includes `defaultDatasetId`. Swap `format=csv` for `json` or `xlsx` as needed.

### Billing and limits

- **Pay per result.** You are charged per classified 8-K event record returned, plus a small fixed start fee per run.
- **Optional AI event summary** is opt-in and charged only when a usable summary is produced. Available on paid Apify plans.
- **No charge on failure.** Empty runs and failed lookups return no billable records.
- **Free plans** are capped at 10 results per run. Set a spend limit and the actor stops emitting once it is reached.
- Data comes from the public SEC EDGAR system. No account, key or login is needed.

### FAQ and troubleshooting

**How is the event category decided?** From the item mix, using the SEC item taxonomy. For example an 8-K with item 2.02 is Earnings, 5.02 is Executive Change, 2.01 is M\&A, 1.03 is Bankruptcy, 3.01 is Delisting, 1.01 is Material Agreement.

**Can I get only earnings, or only executive changes?** Yes. Set `itemCodes` to the codes you want, for example `["2.02"]` for earnings or `["5.02"]` for director and officer changes.

**Do I get the press release?** When a company attaches its press release as Exhibit 99.1, the direct URL is returned in `pressReleaseUrl`.

**What is the difference from a generic EDGAR filing scraper?** This actor classifies each 8-K by item type and extracts what happened, rather than just listing that a filing exists.

**How fresh is the data?** It reads the live SEC EDGAR index, so newly filed 8-Ks appear as soon as EDGAR publishes them.

### More scrapers at scrapers.lat

- SEC Schedule 13D 13G Activist Stakes Scraper
- SEC Form 4 Insider Trades Scraper
- SEC Form D Private Placements Scraper
- SEC 13F Holdings Scraper
- SEC EDGAR Full-Text Search Scraper

Built by [scrapers.lat](https://scrapers.lat). Not affiliated with or endorsed by the U.S. Securities and Exchange Commission.

# Actor input Schema

## `mode` (type: `string`):

How to find 8-K filings. 'recent' = latest material events across the whole market. 'byIssuer' = every 8-K for one company (set issuerTicker or issuerCik).

## `issuerTicker` (type: `string`):

Stock ticker of the company whose 8-K material events you want, for example AAPL, TSLA or NVDA. Used in byIssuer mode.

## `issuerCik` (type: `string`):

Optional. SEC Central Index Key of the company, used instead of a ticker (for example 320193 for Apple). If both are set, ticker wins.

## `itemCodes` (type: `array`):

Optional. Keep only 8-Ks that report at least one of these item codes, for example 2.02 for earnings or 5.02 for executive changes. Leave empty for all item types.

## `filedSince` (type: `string`):

Optional. Only include 8-Ks filed on or after this date. Leave empty for the newest filings regardless of date.

## `withEventSummary` (type: `boolean`):

Opt-in. For each 8-K, add an AI plain-language read of the event: headline, what happened, market implication and sentiment. Charged per successful summary. Paid Apify plans only.

## `maxResults` (type: `integer`):

Maximum number of classified 8-K event records to return. Free Apify plans are capped at 10 per run.

## Actor input object example

```json
{
  "mode": "recent",
  "issuerTicker": "AAPL",
  "itemCodes": [
    "2.02"
  ],
  "withEventSummary": false,
  "maxResults": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "recent",
    "issuerTicker": "AAPL",
    "itemCodes": [
        "2.02"
    ],
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/sec-8k-material-events-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "recent",
    "issuerTicker": "AAPL",
    "itemCodes": ["2.02"],
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/sec-8k-material-events-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "recent",
  "issuerTicker": "AAPL",
  "itemCodes": [
    "2.02"
  ],
  "maxResults": 10
}' |
apify call scrapers_lat/sec-8k-material-events-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/sec-8k-material-events-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ogxky3t944MPibGCv/builds/Rbqg9M1BtDGQbnrW6/openapi.json