# SEC EDGAR Scraper – Company Filings & Financial Statements (`lahcen_ai/sec-edgar-filings-financials-scraper`) Actor

Get SEC EDGAR filings (10-K, 10-Q, 8-K, S-1, 13F) with direct document links, or clean annual/quarterly financials (revenue, net income, EPS, cash flow, margins) for any US-listed company by ticker or CIK.

- **URL**: https://apify.com/lahcen_ai/sec-edgar-filings-financials-scraper.md
- **Developed by:** [Lahcen El-Hadi](https://apify.com/lahcen_ai) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 filing or financial periods

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 – Company Filings & Financial Statements

Get SEC EDGAR filings (10-K, 10-Q, 8-K, S-1, 13F...) with direct document links, or clean annual/quarterly financials (revenue, net income, EPS, assets, cash flow, margins) for any US-listed company by ticker or CIK.

### What does it do?

Get data straight from the **SEC EDGAR** official APIs for any US-listed company by **ticker, CIK or name**. **Filings mode**: every filing (10-K, 10-Q, 8-K, S-1, DEF 14A, 13F, Form 4…) with filing & report dates, items, **direct links to the document and filing index**, plus company info (exchange, SIC industry, fiscal year end). **Financials mode**: clean **annual or quarterly financial statements** from XBRL – revenue, cost of revenue, gross profit, operating income, net income, EPS, R\&D, assets, liabilities, equity, cash, long-term debt, operating cash flow, capex, free cash flow and margins – one row per period.

### Why use it?

- Investors & analysts: build financial datasets and screeners without manual copy-paste.
- Fintech & AI apps: feed LLMs with official filings and numbers.
- Event monitoring: schedule daily to catch new 8-K or Form 4 filings.
- Academic research and due diligence.

### Quick start

1. Click **Try for free** / **Start**.
2. Paste your list (the example input already works – just press Start).
3. Download results as JSON, CSV, Excel or HTML, or use the API, schedules and integrations (Make, Zapier, n8n, Slack, Google Sheets…).

### Input example

```json
{
  "companies": ["AAPL", "MSFT"],
  "mode": "financials",
  "periodType": "annual",
  "maxPeriods": 5
}
```

### Output example

```json
{
  "ticker": "EXMP",
  "companyName": "Example Corp (illustrative values)",
  "periodEnd": "2025-12-31",
  "fiscalYear": 2025,
  "revenue": 1250000000,
  "netIncome": 180000000,
  "epsDiluted": 2.15,
  "grossMargin": 0.4123,
  "freeCashFlow": 210000000
}
```

### Pricing

Pay only for results: **$1.50 per 1,000 results** (pay-per-event). No subscription. Platform usage is included in the price. You can set a maximum cost per run and the Actor stops before exceeding it.

### FAQ

**Is this data official?**

Yes. It comes from data.sec.gov and sec.gov – public US government data. Always verify critical numbers in the original filing (links included).

**Rate limits?**

The Actor follows the SEC fair-access policy (well under 10 requests/second).

**Investment advice?**

No. This tool only extracts public data and is not financial advice.

### Legal & responsible use

This Actor only accesses publicly available data and official public APIs, respects robots.txt where applicable and paces its requests. You are responsible for using the results in line with applicable laws (e.g. GDPR/CCPA) and the terms of the data sources.

### Support

Found a bug or need a feature? Open an issue on the Actor’s **Issues** tab – we usually reply within 24 hours. Check our other tools: Website SEO & Broken Link Auditor, B2B Lead & Tech Stack Intelligence, Shopify Product Scraper and ATS Jobs Scraper.

# Actor input Schema

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

e.g. AAPL, MSFT, 0000320193

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

What to extract.

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

Optional filter, e.g. 10-K, 10-Q, 8-K. Empty = all forms.

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

Optional.

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

Optional.

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

Limit in filings mode.

## `periodType` (type: `string`):

Annual (10-K) or quarterly (10-Q) figures.

## `maxPeriods` (type: `integer`):

Number of fiscal years (quarterly = years × 4 quarters).

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

The SEC asks automated tools to identify themselves; adding your email to the request header is recommended for heavy use.

## Actor input object example

```json
{
  "companies": [
    "AAPL",
    "MSFT"
  ],
  "mode": "filings",
  "maxFilingsPerCompany": 10,
  "periodType": "annual",
  "maxPeriods": 5
}
```

# 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 = {
    "companies": [
        "AAPL",
        "MSFT"
    ],
    "maxFilingsPerCompany": 10
};

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

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lahcen_ai/sec-edgar-filings-financials-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/RHuhMwOaGtrsuSSOo/builds/mRfERRbWqF7utA5mI/openapi.json