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

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

## Pricing

from $0.0008 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 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. Built for financial analysts, compliance teams and researchers who need dependable filings data with filters for form type and date.

![SEC EDGAR Scraper input — tickers, form types and date filter in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/sec-edgar-scraper-input.png?v=2)

### 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.
- ⚙️ **Reliable** — dependable, well-paced runs that return complete filings data.

### What you get

![SEC EDGAR Scraper output example — filings with company profile, form type and document URL as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/sec-edgar-scraper-output.png?v=5)

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"
}
```

#### Output schema

| Field | Type | Description |
|---|---|---|
| `cik` | string | SEC Central Index Key for the company. |
| `companyName` | string | Registered company name. |
| `ticker` | string | Primary stock ticker symbol. |
| `tickers` | array | All ticker symbols associated with the company. |
| `exchanges` | array | Exchanges the company is listed on. |
| `sic` | string | Standard Industrial Classification code. |
| `sicDescription` | string | Text description of the SIC code. |
| `ein` | string | Employer Identification Number. |
| `category` | string | SEC filer category (e.g. Large accelerated filer). |
| `fiscalYearEnd` | string | Fiscal year end as MMDD. |
| `stateOfIncorporation` | string | State or jurisdiction of incorporation. |
| `website` | string | Company website, when available. |
| `form` | string | Filing form type (e.g. `10-K`, `8-K`). |
| `filingDate` | string | Date the filing was submitted (YYYY-MM-DD). |
| `reportDate` | string | Period-of-report date (YYYY-MM-DD). |
| `acceptanceDateTime` | string (ISO date) | Timestamp the SEC accepted the filing. |
| `accessionNumber` | string | Unique SEC accession number for the filing. |
| `primaryDocument` | string | Filename of the primary document. |
| `primaryDocDescription` | string | Description of the primary document. |
| `items` | string | 8-K item numbers reported, when applicable. |
| `size` | integer | Size of the filing submission in bytes. |
| `isXBRL` | boolean | Whether the filing includes XBRL structured data. |
| `documentUrl` | string (URL) | Direct link to the primary document. |
| `filingIndexUrl` | string (URL) | Link to the filing index page. |

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

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

**Can I connect it to other tools?**
The SEC EDGAR Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

### 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(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 '{
  "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": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/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/tK1tbNx3droSdMBof/builds/cjpzRcszuZdFvzcra/openapi.json