# SEC EDGAR Filings Scraper — 10-K, 10-Q, 8-K & More (`hipersoft/sec-edgar-scraper`) Actor

Scrape SEC EDGAR company filings by ticker or CIK: company profile (name, SIC, exchange, state) plus every filing (form type, filing/report date, accession number, primary document URL). Filter by form type and date. Fast clean HTTP via the official SEC API, no key.

- **URL**: https://apify.com/hipersoft/sec-edgar-scraper.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0016 / filing scraped

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/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 EDGAR Filings Scraper — 10-K, 10-Q, 8-K & More by Ticker or CIK

Scrape SEC EDGAR company filings by stock ticker or CIK and get back clean, structured JSON: a full company profile (name, SIC, exchanges, state of incorporation) merged with every filing — form type, filing and report dates, accession number, and a ready-to-open primary document URL. It uses the official SEC data API — **no account, no API key.** Built for financial analysts, compliance teams and researchers who need dependable filings data with filters for form type and date.

### Features

- 🎯 **Ticker or CIK input** — resolves tickers (AAPL, MSFT) to CIKs automatically, or accept raw CIK numbers.
- 🗂️ **Every filing** — form type, `filingDate`, `reportDate`, `acceptanceDateTime`, `accessionNumber` and 8-K `items`.
- 🔎 **Form filters** — narrow to specific forms like 10-K, 10-Q, 8-K, 4, S-1 or DEF 14A, or fetch all.
- 📅 **Date filter** — `dateFrom` returns only filings on or after a given date, most recent first.
- 🏢 **Company profile** — SIC code and description, exchanges, EIN, fiscal year end and state of incorporation on every row.
- 🔗 **Direct links** — `documentUrl` to the primary document and `filingIndexUrl` to the filing index.
- ⚙️ **Polite & reliable** — descriptive User-Agent, retries on 429/403 and pacing to respect SEC limits.

### What you get

Each filing becomes one clean JSON record (company profile fields merged in):

```json
{
  "cik": "0000320193",
  "companyName": "Apple Inc.",
  "ticker": "AAPL",
  "tickers": ["AAPL"],
  "exchanges": ["Nasdaq"],
  "sic": "3571",
  "sicDescription": "Electronic Computers",
  "ein": "942404110",
  "category": "Large accelerated filer",
  "fiscalYearEnd": "0928",
  "stateOfIncorporation": "CA",
  "website": null,
  "form": "10-K",
  "filingDate": "2023-11-03",
  "reportDate": "2023-09-30",
  "acceptanceDateTime": "2023-11-02T18:08:27.000Z",
  "accessionNumber": "0000320193-23-000106",
  "primaryDocument": "aapl-20230930.htm",
  "primaryDocDescription": "10-K",
  "items": null,
  "size": 12345678,
  "isXBRL": true,
  "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",
  "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/0000320193-23-000106-index.htm"
}
```

### Input

```json
{
  "tickers": ["AAPL", "MSFT"],
  "ciks": [],
  "formTypes": ["10-K", "10-Q", "8-K"],
  "maxFilingsPerCompany": 100,
  "dateFrom": "2020-01-01"
}
```

| Field | Description |
|-------|-------------|
| `tickers` | Stock tickers to fetch filings for (e.g. AAPL, MSFT, NVDA), one per line. |
| `ciks` | SEC Central Index Keys, as an alternative or addition to tickers. |
| `formTypes` | Filter to specific forms (10-K, 10-Q, 8-K, 4, S-1, DEF 14A). Empty = all forms. |
| `maxFilingsPerCompany` | Cap filings returned per company, most recent first (1–5000). |
| `dateFrom` | Only filings on or after this date (YYYY-MM-DD). |

### Use cases

- Pull every 10-K and 10-Q for a portfolio of tickers for fundamental analysis.
- Monitor recent 8-K filings since a given date for event-driven research.
- Build a compliance archive of a company's filings with direct document links.
- Extract company profile data (SIC, exchange, state) for market segmentation.

### Pricing

Pay-per-event: you're billed a small amount per run and per item scraped — you only pay for what you get. See the **Pricing** tab for current rates.

### FAQ

**Do I need an API key or account?**
No. The Actor uses the official [SEC EDGAR](https://www.sec.gov/edgar) data API (data.sec.gov), which is free and open — no login and no key. It sends a descriptive User-Agent and paces requests to respect SEC limits.

**How many filings can I get per run?**
Set `maxFilingsPerCompany` from 1 to 5,000 per company, most recent first, across as many tickers or CIKs as you pass in.

**How fresh is the data?**
Filings are read live from SEC EDGAR, so new submissions appear as soon as the SEC publishes them. Use `dateFrom` to return only filings on or after a given date.

**Is the data official?**
Yes — it comes directly from the SEC's own EDGAR data API and reads only publicly available filings. This Actor is an independent tool and is not affiliated with or endorsed by the U.S. Securities and Exchange Commission.

**What's the output format?**
Flat JSON, one record per filing with the company profile merged in — form type, filing/report dates, accession number, plus a `documentUrl` and `filingIndexUrl`. Export as JSON, CSV or Excel.

### Related Actors

More finance and regulatory data scrapers from the same publisher:

- [Yahoo Finance Scraper](https://apify.com/hipersoft/yahoo-finance-scraper) — live quotes and OHLCV price history for stocks, ETFs, crypto and forex.
- [USASpending.gov Scraper](https://apify.com/hipersoft/usaspending-scraper) — federal contracts, grants, loans and awards.
- [CoinGecko Scraper](https://apify.com/hipersoft/coingecko-scraper) — live crypto prices, market cap, volume and ATH/ATL.

### Notes

This actor uses the official SEC EDGAR data API (`data.sec.gov`) and reads only publicly available filing data. It is an independent tool and is not affiliated with, endorsed by, or sponsored by the U.S. Securities and Exchange Commission.

# Actor input Schema

## `tickers` (type: `array`):

Stock tickers to fetch filings for (e.g. AAPL, MSFT, NVDA). One per line.

## `ciks` (type: `array`):

SEC Central Index Keys (numbers), as an alternative/addition to tickers.

## `formTypes` (type: `array`):

Filter to specific forms (e.g. 10-K, 10-Q, 8-K, 4, S-1, DEF 14A). Empty = all forms.

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

Cap filings returned per company (most recent first).

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

Only filings on/after this date (YYYY-MM-DD).

## `proxyConfiguration` (type: `object`):

Optional. The SEC API works without a proxy.

## Actor input object example

```json
{
  "tickers": [
    "AAPL",
    "MSFT"
  ],
  "ciks": [],
  "formTypes": [
    "10-K",
    "10-Q",
    "8-K"
  ],
  "maxFilingsPerCompany": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 = {
    "tickers": [
        "AAPL",
        "MSFT"
    ],
    "ciks": [],
    "formTypes": [
        "10-K",
        "10-Q",
        "8-K"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/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 = {
    "tickers": [
        "AAPL",
        "MSFT",
    ],
    "ciks": [],
    "formTypes": [
        "10-K",
        "10-Q",
        "8-K",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/sec-edgar-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "tickers": [
    "AAPL",
    "MSFT"
  ],
  "ciks": [],
  "formTypes": [
    "10-K",
    "10-Q",
    "8-K"
  ]
}' |
apify call hipersoft/sec-edgar-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=hipersoft/sec-edgar-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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