# SEC EDGAR Scraper: 10-K, 10-Q, 8-K Filings & XBRL Financials (`sysco32/sec-edgar-scraper`) Actor

Get SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4, S-1 and more) by ticker or CIK, EDGAR full-text search, the live latest-filings feed with new-filing alerts, and XBRL financials (revenue, net income, EPS, assets, cash flow). Official SEC APIs. $0.40 per 1,000 filings.

- **URL**: https://apify.com/sysco32/sec-edgar-scraper.md
- **Developed by:** [Gabor Sziladi](https://apify.com/sysco32) (community)
- **Categories:** News, Developer tools, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.40 / 1,000 filing results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEC EDGAR Scraper: 10-K, 10-Q, 8-K Filings, Full-Text Search & Financials

Get **SEC EDGAR** data through the SEC's official public APIs: **filings by ticker or CIK** (10-K, 10-Q, 8-K, Form 4, S-1, DEF 14A, 13F and every other form), **full-text search** across all EDGAR filings since 2001, the **live latest-filings feed** to monitor new filings, and **annual or quarterly financials** from XBRL (revenue, gross profit, operating income, net income, EPS, assets, liabilities, equity, cash, operating cash flow, capex, R\&D, debt). No login and no API key needed.

- ✅ **Filings mode**: company filing history by ticker or CIK with form, date and item filters, plus direct document and index links
- ✅ **8-K items** (such as `5.02` executive change or `1.05` cybersecurity incident) on every 8-K
- ✅ **Full-text search** with exact phrases, form filters and a date range
- ✅ **Latest filings** feed for near real-time monitoring of new 8-Ks, Form 4 insider trades and more
- ✅ **Financials mode**: clean annual or quarterly statement rows with `net_margin_pct` and the XBRL concept used for each value
- ✅ **Only new filings** monitoring. You pay only for filings you haven't seen.

### Input examples

Latest 10-K, 10-Q and 8-K filings of Apple, Microsoft and Nvidia (default):

```json
{
  "mode": "filings",
  "companies": [
    "AAPL",
    "MSFT",
    "NVDA"
  ],
  "forms": [
    "10-K",
    "10-Q",
    "8-K"
  ],
  "maxFilingsPerCompany": 10
}
```

Full-text search for cybersecurity incident 8-Ks:

```json
{
  "mode": "search",
  "searchQuery": "\"cybersecurity incident\"",
  "forms": [
    "8-K"
  ],
  "dateFrom": "2026-09-01",
  "maxResults": 100
}
```

Monitor new 8-Ks and insider trades (Form 4), scheduled every 10 minutes:

```json
{
  "mode": "latest",
  "forms": [
    "8-K",
    "4"
  ],
  "maxResults": 100,
  "onlyNewFilings": true
}
```

Five years of annual financials:

```json
{
  "mode": "financials",
  "companies": [
    "AAPL",
    "TSLA"
  ],
  "financialPeriod": "annual",
  "financialYears": 5
}
```

### Output example (real run)

A filing:

```json
{
  "record_type": "filing",
  "cik": 320193,
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "sic": "3571",
  "sic_description": "Electronic Computers",
  "state_of_incorporation": "CA",
  "exchanges": [
    "Nasdaq"
  ],
  "form": "8-K/A",
  "filing_date": "2026-09-01",
  "report_date": "2026-04-17",
  "accepted_at": "2026-09-01T20:30:35Z",
  "accession_number": "0001140361-26-035325",
  "items": [
    "5.02"
  ],
  "description": "8-K/A",
  "primary_document": "ef20081427_8ka.htm",
  "size_bytes": 241262,
  "is_xbrl": true,
  "file_number": "001-36743",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126035325/0001140361-26-035325-index.htm",
  "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126035325/ef20081427_8ka.htm",
  "source": "submissions",
  "scraped_at": "2026-10-25T19:10:43Z"
}
```

A financials row (`record_type: financials`; values in USD):

```json
{
  "record_type": "financials",
  "cik": 320193,
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "period": "annual",
  "period_start": "2024-09-29",
  "period_end": "2025-09-27",
  "period_end_year": 2025,
  "form": "10-K",
  "accession_number": "0000320193-25-000079",
  "filed": "2025-10-31",
  "revenue": 416161000000,
  "gross_profit": 195201000000,
  "operating_income": 133050000000,
  "net_income": 112010000000,
  "eps_basic": 7.49,
  "eps_diluted": 7.46,
  "total_assets": 359241000000,
  "total_liabilities": 285508000000,
  "stockholders_equity": 73733000000,
  "cash_and_equivalents": 35934000000,
  "operating_cash_flow": 111482000000,
  "capex": 12715000000,
  "rnd_expense": 34550000000,
  "long_term_debt": 78328000000,
  "diluted_shares_weighted": 15004697000,
  "net_margin_pct": 26.92,
  "source": "xbrl_companyfacts",
  "scraped_at": "2026-10-25T19:12:23Z"
}
```

Every financials row also has `concepts_used`, which shows the XBRL tag behind each value. Use the **Filings** or **Financials** views, or export to JSON, CSV or Excel.

### Pricing

Pay per event, no subscription:

| Event | Price |
|---|---|
| Filing | **$0.0004** ($0.40 per 1,000) |
| Financials row (one year or quarter) | $0.002 |
| Actor start (per run) | $0.002 |

The default run (30 filings) costs about $0.014. Five years of financials for one company cost about $0.012.

### Use cases

- **Investment research**: filing history, 8-K events and multi-year fundamentals in one dataset.
- **Event-driven alerts**: new 8-Ks (executive changes, M\&A, cybersecurity incidents) and Form 4 insider trades.
- **Compliance and due diligence**: find every filing that mentions a company, person or phrase.
- **Financial datasets and AI**: clean statement data with links to the source documents.
- **Sales intelligence**: newly public companies (S-1), funding (Form D) and leadership changes.

### FAQ

**Which sources are used?** Only official SEC endpoints: `data.sec.gov` submissions and XBRL company facts, EDGAR full-text search (`efts.sec.gov`) and the EDGAR latest-filings feed. Requests identify themselves with a User-Agent and stay well under the SEC's 10 requests per second limit. Add your own `contactEmail` to identify your runs to the SEC.

**How accurate are the financials?** Values come straight from companies' XBRL filings. For each period the Actor picks the standard US-GAAP tag (for example `Revenues` or `RevenueFromContractWithCustomerExcludingAssessedTax`) and uses the latest filed value, so restatements are included. `concepts_used` shows which tag was used. Banks, insurers and IFRS filers can have gaps.

**Can I use CIK numbers?** Yes. `companies` accepts tickers (`AAPL`), CIKs (`320193` or `0000320193`) or exact company names as listed by the SEC (`Apple Inc.`).

**What is in Form 4 latest-filings records?** One record per filing, with the issuer as `company` and the insiders in `reporting_owners`.

### Related actors

More Actors by the same author:

- [MNB, NBP & CNB Exchange Rates (sysco32/cee-central-bank-fx-rates)](https://apify.com/sysco32/cee-central-bank-fx-rates): official daily HUF, PLN and CZK rates from three central banks, including invoice-date lookups.
- [Bulk Domain WHOIS/RDAP, DNS & Email Security Checker (sysco32/domain-rdap-dns-lookup)](https://apify.com/sysco32/domain-rdap-dns-lookup): registrar and expiry dates, DNS records, mail provider and SPF/DMARC checks for many domains.
- [RSS Feed Reader & Monitor (sysco32/rss-feed-reader)](https://apify.com/sysco32/rss-feed-reader): RSS, Atom and JSON Feed items as clean JSON, with only-new-item monitoring.

### Need a custom scraper or data pipeline?

If you need other public filings or financial data, extra fields, or the results delivered to Google Sheets, a database or an n8n workflow on a schedule, I take custom projects on Fiverr: [Python scraping scripts and n8n automation workflows](https://www.fiverr.com/sysco32/build-python-scraping-scripts-and-n8n-automation-workflows). Public data only; message me with the details first and I'll confirm whether it's doable.

# Actor input Schema

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

Choose one mode. Each mode uses the options in its section below.

## `companies` (type: `array`):

For the <b>Company filings</b> and <b>Financials</b> modes, e.g. <code>AAPL</code>, <code>TSLA</code>, <code>BRK-B</code> or a CIK such as <code>320193</code>.

## `forms` (type: `array`):

Keep only these forms, e.g. <code>10-K</code>, <code>10-Q</code>, <code>8-K</code>, <code>4</code> (insider trades), <code>S-1</code>, <code>13F-HR</code>, <code>SC 13D</code>, <code>DEF 14A</code>, <code>D</code> (private placements). Empty = all forms.

## `includeAmendments` (type: `boolean`):

Also keep amended versions of the selected forms, e.g. <code>10-K/A</code>.

## `dateFrom` (type: `string`):

ISO date, e.g. <code>2026-01-01</code>.

## `dateTo` (type: `string`):

ISO date, e.g. <code>2026-10-31</code>.

## `maxFilingsPerCompany` (type: `integer`):

Newest first (from the company's recent filings, up to about 1,000).

## `searchQuery` (type: `string`):

Searches the text of all EDGAR filings since 2001, e.g. <code>"artificial intelligence"</code>, <code>"going concern"</code>, <code>"cybersecurity incident"</code>. Use quotes for exact phrases. Combine with form types and dates above.

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

Maximum filings from full-text search, or per form type from the latest filings feed (up to 100).

## `financialPeriod` (type: `string`):

Fiscal years or quarters, from the company's XBRL data.

## `financialYears` (type: `integer`):

How many most recent fiscal years (or quarters) per company.

## `contactEmail` (type: `string`):

The SEC asks automated tools to declare a contact in the User-Agent. Add yours for heavy use; otherwise the Actor's contact is used.

## `onlyNewFilings` (type: `boolean`):

Remember the accession numbers already delivered in this mode and skip them later. Schedule it for 8-K, Form 4 or keyword alerts and get, and pay for, only new filings.

## `stateStoreName` (type: `string`):

Named key-value store for seen filings. Use a different name for each independent monitor.

## Actor input object example

```json
{
  "mode": "filings",
  "companies": [
    "AAPL",
    "MSFT",
    "NVDA"
  ],
  "forms": [
    "10-K",
    "10-Q",
    "8-K"
  ],
  "includeAmendments": true,
  "maxFilingsPerCompany": 10,
  "maxResults": 50,
  "financialPeriod": "annual",
  "financialYears": 5,
  "onlyNewFilings": false,
  "stateStoreName": "sec-edgar-scraper-seen"
}
```

# Actor output Schema

## `filings` (type: `string`):

Filings

## `financials` (type: `string`):

Financial statements (financials mode)

## `summary` (type: `string`):

Records per task, failed inputs with error messages.

# 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": "filings",
    "companies": [
        "AAPL",
        "MSFT",
        "NVDA"
    ],
    "forms": [
        "10-K",
        "10-Q",
        "8-K"
    ],
    "maxFilingsPerCompany": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("sysco32/sec-edgar-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": "filings",
    "companies": [
        "AAPL",
        "MSFT",
        "NVDA",
    ],
    "forms": [
        "10-K",
        "10-Q",
        "8-K",
    ],
    "maxFilingsPerCompany": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("sysco32/sec-edgar-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": "filings",
  "companies": [
    "AAPL",
    "MSFT",
    "NVDA"
  ],
  "forms": [
    "10-K",
    "10-Q",
    "8-K"
  ],
  "maxFilingsPerCompany": 10
}' |
apify call sysco32/sec-edgar-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sysco32/sec-edgar-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/0HS7WKt6suh9uh8a4/builds/gEGCLMtripxdbqDqn/openapi.json