# SEC EDGAR Filings Scraper & XBRL Financial Facts (`fleet261114/sec-edgar-filings`) Actor

Get SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4 and all others) or flattened XBRL financial facts (revenue, net income, assets...) for any ticker or CIK from the official data.sec.gov JSON APIs. Fair-access compliant, no HTML scraping.

- **URL**: https://apify.com/fleet261114/sec-edgar-filings.md
- **Developed by:** [Fleet](https://apify.com/fleet261114) (community)
- **Categories:** News, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.21 / 1,000 filings

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 & XBRL Financial Facts

Two things from the US Securities and Exchange Commission's official **EDGAR JSON APIs**, for any list of **tickers or CIK numbers**:

1. **Filings.** Every filing of the company (10-K, 10-Q, 8-K, Form 4, S-1, DEF 14A, 13F and all others) as one record per filing: form, filing date, period of report, 8-K item numbers, accession number, size, and direct links to the main document and the filing index.
2. **Financial facts.** The company's **XBRL facts** flattened into one row per value: concept (`Revenues`, `NetIncomeLoss`, `Assets`, ...), value, unit, period start and end, fiscal year and period, the form and filing it came from. Pick the concepts you need, or take everything the company reports.

It talks only to `data.sec.gov` (plus the SEC's ticker list), obeys the SEC's fair-access limit and declares its identity in the User-Agent. No HTML scraping, no browser, no proxy.

### Use it for

- **Fundamentals pipelines:** revenue, net income, assets, EPS per fiscal year for a watchlist, ready for a spreadsheet or a model.
- **Filing alerts:** schedule it daily with "Filed on or after" to catch new 8-Ks, 10-Ks and Form 4s.
- **Research and screening:** compare reported values across companies and years.
- **LLM and agent workflows:** clean, structured filings metadata and financial facts through the API or MCP.

### Input

| Field | What it does |
|---|---|
| **Companies** (required) | Tickers (`AAPL`) or CIK numbers (`320193`). Company-name search is not supported. |
| What to return | `filings` (default) or `facts`. |
| Filings: form types | Keep only these forms, e.g. `10-K`, `8-K`. Empty = all. |
| Filings: include amendments | Also keep `10-K/A` etc. for the forms you listed. |
| Filed on or after / before | Date window (`2025-01-31`). |
| Filings: include the full history | The SEC's main list holds the latest ~1,000 filings; this also reads the older archive files. |
| Facts: concepts | XBRL concept names. Empty = every concept (large: tens of thousands of rows per big company). |
| Facts: taxonomy | `us-gaap` (default), `ifrs-full`, `dei`, `srt`. |
| Facts: annual report values only | Full-year values from 10-K, 20-F, 40-F. |
| Facts: period ends in year or later | e.g. `2022`. |
| Facts: keep every reported version | By default each period appears once, from the latest filing reporting it. |
| Max records per company | Cap after filters. |

### Output

A filing record (real run on 2026-11-17 with the default input: AAPL, MSFT and NVIDIA's CIK; long values shortened):

```json
{
  "cik": "0000320193",
  "ticker": "AAPL",
  "companyName": "Apple Inc.",
  "accessionNumber": "0000320193-26-000026",
  "form": "10-K",
  "filingDate": "2026-11-03",
  "reportDate": "2026-09-26",
  "acceptedAt": "2026-11-03T13:05:15.000Z",
  "items": [],
  "primaryDocument": "aapl-20260926.htm",
  "description": "10-K",
  "isXbrl": true,
  "sizeBytes": 10902198,
  "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/aapl-20260926.htm",
  "indexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-26-000026-index.htm",
  "type": "filing",
  "scrapedAt": "2026-11-17T00:55:58.931Z"
}
```

A financial fact record (real run on 2026-11-17 with `mode` "facts", concept RevenueFromContractWithCustomerExcludingAssessedTax, annual values only, company AAPL):

```json
{
  "cik": "0000320193",
  "ticker": "AAPL",
  "companyName": "Apple Inc.",
  "taxonomy": "us-gaap",
  "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
  "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
  "unit": "USD",
  "value": 229234000000,
  "periodStart": "2016-09-25",
  "periodEnd": "2017-09-30",
  "fiscalYear": 2019,
  "fiscalPeriod": "FY",
  "form": "10-K",
  "filedDate": "2019-10-31",
  "accessionNumber": "0000320193-19-000119",
  "frame": "CY2017",
  "type": "fact",
  "scrapedAt": "2026-11-17T00:58:22.999Z"
}
```

A `RUN_SUMMARY` record in the key-value store lists per company how many records matched and were returned, and every entry that failed (for example a ticker the SEC does not list).

### Source terms (checked 2026-11-16)

- SEC "Accessing EDGAR Data" (`sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data`): "Current max request rate: 10 requests/second." and "Please declare your user agent in request headers". This Actor keeps below 8 requests a second across the whole run and sends the User-Agent `Webmaster Bench contact@webmasterbench.com`.
- The SEC page also says it does not allow botnets or automated tools to *crawl the site*. This Actor does not crawl: it requests documented JSON endpoints for the companies you name, only what you ask for.
- EDGAR filings are public records. The Actor outputs company filings metadata and reported financial values only, and no personal profiling.
- `www.sec.gov/robots.txt` disallows only site-search and CMS paths. The Actor reads `data.sec.gov` APIs and the file `www.sec.gov/files/company_tickers.json`.
- If many Apify users share one IP address at the same moment, the SEC may throttle requests (HTTP 403/429). The Actor waits and retries, and reports companies it could not read.

### Limits and honest notes

- XBRL facts exist only for filings with structured financial data (mostly 2009 onward for large companies). Small companies may have fewer concepts.
- `fiscalYear` and `fiscalPeriod` are the SEC's values for the filing that reported the number, so a prior-year comparison reported in a later filing carries that filing's fiscal year. Date a value by `periodStart` / `periodEnd`.
- Values are as reported, in the filing's units (for example USD, shares). Nothing is adjusted or restated by this Actor.
- Not investment advice; no guarantee of completeness. Check the filing itself for anything that matters.

### Pricing

Pay per result: **$0.0003 per filing** ($0.30 per 1,000) and **$0.0001 per financial fact** ($0.10 per 1,000), with lower prices on Apify's Bronze, Silver and Gold plans, plus Apify's small run-start fee. Companies that cannot be read are not charged. You can set a maximum cost per run; the Actor stops cleanly when it is reached.

### Use it from the API, a schedule or an AI agent

```bash
curl -X POST "https://api.apify.com/v2/acts/fleet261114~sec-edgar-filings/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companies": ["AAPL", "MSFT"], "mode": "facts", "concepts": ["Revenues", "NetIncomeLoss"], "annualOnly": true}'
```

Attach a daily schedule with "Filed on or after" set by your integration to monitor new filings, or add the Actor to any MCP client: `https://mcp.apify.com?tools=fleet261114/sec-edgar-filings`.

### FAQ

**Which companies are covered?** Every company with an EDGAR CIK. Tickers must be in the SEC's ticker list; otherwise use the CIK.

**Why are there two prices?** Filings and financial facts are different products: a filing record points to a document, a fact is a single number. Facts are cheaper per row because there are many.

**Does it return the filing text?** No: links to the main document and the filing index, not the full text.

### Questions and problems

Open an issue on the Actor's **Issues** tab with the run link.

# Actor input Schema

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

Stock tickers (AAPL, MSFT) or SEC CIK numbers (320193). One entry per company.

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

Filings: one record per filing (form, dates, document links). Facts: one record per XBRL financial fact (value, period, unit, filing it came from).

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

Keep only these forms, e.g. 10-K, 10-Q, 8-K, 4, S-1, DEF 14A. Empty = all forms.

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

When you list forms, also keep their amendments (10-K/A for 10-K).

## `filedAfter` (type: `string`):

Date YYYY-MM-DD. Filings: filing date. Facts: date the fact was filed.

## `filedBefore` (type: `string`):

Date YYYY-MM-DD.

## `includeOlderFilings` (type: `boolean`):

The SEC's main list holds a company's latest ~1,000 filings. Switch on to also read the older archive files (extra requests). Done automatically when 'Filed on or after' reaches back past the main list.

## `concepts` (type: `array`):

XBRL concept names such as Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted. Empty = every concept the company reports (large).

## `taxonomy` (type: `string`):

us-gaap (default), ifrs-full, dei or srt.

## `annualOnly` (type: `boolean`):

Keep only full-year values reported in 10-K, 20-F or 40-F filings.

## `fiscalYearFrom` (type: `integer`):

Keep facts whose period ends in this calendar year or later (e.g. 2022).

## `allRestatements` (type: `boolean`):

By default each period appears once, from the most recent filing that reports it. Switch on to get every filing's value (restatements and repeats).

## `maxRecordsPerCompany` (type: `integer`):

Cap per company after filters (newest filings first). 0 = no cap.

## Actor input object example

```json
{
  "companies": [
    "AAPL",
    "MSFT",
    "0001045810"
  ],
  "mode": "filings",
  "forms": [],
  "includeAmendments": false,
  "includeOlderFilings": false,
  "concepts": [],
  "taxonomy": "us-gaap",
  "annualOnly": false,
  "allRestatements": false,
  "maxRecordsPerCompany": 0
}
```

# Actor output Schema

## `records` (type: `string`):

No description

## `summary` (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",
        "0001045810"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("fleet261114/sec-edgar-filings").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",
        "0001045810",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("fleet261114/sec-edgar-filings").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",
    "0001045810"
  ]
}' |
apify call fleet261114/sec-edgar-filings --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fleet261114/sec-edgar-filings"
        }
    }
}
```

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/K0PDukba72tGAHfDY/builds/53HxN6X3INo10GEfk/openapi.json
