# SEC Filing Watcher (`zinin/sec-edgar-watcher`) Actor

Watch stock tickers for new SEC filings — 10-K, 10-Q, 8-K, S-1 and more. Official SEC EDGAR data, free, no API key or login. Filter by form type and lookback window; get form, filing date and a direct document URL for every match.

- **URL**: https://apify.com/zinin/sec-edgar-watcher.md
- **Developed by:** [Tim Zinin](https://apify.com/zinin) (community)
- **Categories:** News, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.55 / 1,000 filing founds

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/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 Filing Watcher — New Filings by Ticker

Point this Actor at a list of tickers and get back every SEC filing that landed in your lookback window — form type, filing date, accession number and a direct document URL. Straight from official SEC EDGAR data: no API key, no browser, no login.

### What you get

- **One row per ticker**: company name, how many filings matched your window, and the list of those filings — each with `form`, `filedAt`, `accessionNumber`, `primaryDocument` and a ready-to-open `url`.
- **Filter by form type** (`10-K`, `10-Q`, `8-K`, `S-1`, …) or leave empty to include every form type.
- **Lookback window** up to 10 years (`sinceDays`, max 3650).
- Up to 100 tickers per run, concurrency up to 10 — SEC EDGAR's own documented rate limit.
- Runs on Apify: schedule it, monitor it, call it from the API or the MCP server, export to JSON, CSV or Excel, or push results straight into your own pipeline.

### Who uses it

- **Investors & analysts** — an alert-ready feed of 10-K/10-Q/8-K filings for a watchlist, without babysitting the EDGAR full-text search UI.
- **Journalists & researchers** — track S-1s (new IPO filings), 8-Ks (material events) or insider Form 4s for a set of companies.
- **Fintech builders** — a clean, structured filings feed to wire into a bot, dashboard or n8n workflow.
- **Compliance/IR teams** — monitor competitors' or portfolio companies' disclosure activity.

### Why it matters

SEC EDGAR's own search UI has no ticker-list mode and no API key/quota system to build on top of — you either poll the website by hand or write your own ticker-to-CIK resolver and pagination logic. This Actor does that resolution once per run and hands back one row per ticker, ready to filter, alert on, or pipe into a dataset.

### How to run it

1. Click **Try for free** — no card needed on the free plan.
2. Paste tickers into **Tickers**, one per line. Optionally narrow by **Form types** and **Since (days)**.
3. Press **Start**. Results appear in the dataset — read them in the UI, pull them from the API, or have a webhook push them onward.

### Pricing

Pay-per-event: **$0.005 per run start + $0.003 per result found**. No monthly seat, no minimum. 100 tickers that resolve cost about **$0.31**; 1,000 about **$3.01**.

An unknown ticker, or a lookup that fails, is still returned — with `found: false` and an `error` explaining why — and it is **not** charged for.

### 简体中文说明

输入一批股票代码（ticker），此 Actor 会直接读取官方 SEC EDGAR 的公开数据，返回你设定的回溯窗口内每家公司提交的全部新备案：表格类型、提交日期、`accessionNumber`，以及可直接打开的文档链接。数据来自 SEC 官方接口，无需 API 密钥、无需登录，也不做网页抓取。

可以用 `formTypes` 只筛选特定表格（如 `10-K`、`10-Q`、`8-K`、`S-1`），留空则返回全部类型；回溯窗口 `sinceDays` 最长可设 10 年（3650 天）。SEC EDGAR 官网的检索界面本身不支持按一批股票代码批量查询，也没有配额化的 API——本 Actor 一次性完成代码到 `CIK` 的解析，按代码逐行返回结果，方便直接过滤、告警或接入自己的数据管道。

计费为按事件付费：每次运行 $0.005，每条查到的备案结果 $0.003（`result-found`）。查不到的代码或解析失败的记录仍会以 `found: false` 返回并说明原因，**不计费**。100 个可解析代码约 $0.31，1000 个约 $3.01。

**这不是什么。** 本 Actor 不读取备案文件的具体内容，不总结 8-K 或 10-K 里发生了什么变化，也不计算任何交易信号——它只回答"这个时间窗口内、这个代码有哪些备案"这一个问题，数据直接来自 SEC 官方索引。本 Actor 呈现的是用于研究和监控的公开 SEC 备案元数据，**不构成投资建议**：一份备案清单不等于买入、卖出或持有的建议。

### Input

| Field | Required | What it does |
|---|---|---|
| `tickers` | yes | Stock tickers to watch, e.g. `AAPL`, `TSLA`, `NVDA`. Up to 100 per run. |
| `formTypes` | no | Only these SEC form types (e.g. `10-K`, `8-K`). Empty = every form type. |
| `sinceDays` | no | Only filings from the last N days (default 90, max 3650 — 10 years). |
| `maxConcurrency` | no | Parallelism (1–10, default 5). SEC EDGAR's documented rate limit is 10 req/s. |

```json
{
    "tickers": ["AAPL", "TSLA", "NVDA"],
    "formTypes": []
}
```

### Output (one item per ticker)

This is a real row from a real run, trimmed only where the filing list repeats:

```json
{
    "ticker": "NVDA",
    "cik": "0001045810",
    "company": "NVIDIA CORP",
    "found": true,
    "filingsCount": 79,
    "recentFilings": [
        {
            "form": "SCHEDULE 13G",
            "filedAt": "2026-07-20",
            "accessionNumber": "0001045810-26-000062",
            "primaryDocument": "xslSCHEDULE_13G_X01/primary_doc.xml",
            "url": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000062/xslSCHEDULE_13G_X01/primary_doc.xml"
        },
        {
            "form": "3",
            "filedAt": "2026-07-15",
            "accessionNumber": "0001310264-26-000002",
            "primaryDocument": "xslF345X06/wk-form3_1784149389.xml",
            "url": "https://www.sec.gov/Archives/edgar/data/1045810/000131026426000002/xslF345X06/wk-form3_1784149389.xml"
        },
        {
            "form": "4",
            "filedAt": "2026-07-06",
            "accessionNumber": "0001197647-26-000005",
            "primaryDocument": "xslF345X06/wk-form4_1783371701.xml",
            "url": "https://www.sec.gov/Archives/edgar/data/1045810/000119764726000005/xslF345X06/wk-form4_1783371701.xml"
        },
        "…"
    ],
    "summary": "NVIDIA CORP (NVDA) — 79 filings in the last 180 day(s), most recent SCHEDULE 13G on 2026-07-20.",
    "checkedAt": "2026-07-26T13:27:57.243Z"
}
```

The real row above lists all 79 filings; only the first three are shown here. Nothing in the shown entries was altered.

| Field | What it means |
|---|---|
| `filingsCount` | Total filings matched in the lookback window |
| `recentFilings[].form` | SEC form code, e.g. `10-K`, `8-K`, `4`, `SCHEDULE 13G` |
| `recentFilings[].primaryDocument` | Filename of the main document; some old/paper filings have none, and `url` then points at the filing's index folder |
| `found` | `false` means the ticker wasn't resolved or the lookup failed — check `error` |

An unknown ticker returns `found: false` with an `error` explaining why — never a partial or ragged row.

### API

Start a run with a bearer token and explicit JSON input:

```bash
curl -sS -X POST 'https://api.apify.com/v2/acts/zinin~sec-edgar-watcher/runs?waitForFinish=60' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"tickers":["AAPL","TSLA","NVDA"],"formTypes":[]}'
```

Read Dataset rows using the returned `defaultDatasetId`:

```bash
curl -sS "https://api.apify.com/v2/datasets/$DEFAULT_DATASET_ID/items?clean=true&format=json" \
  -H "Authorization: Bearer $APIFY_TOKEN"
```

### MCP

For an Apify MCP client exposing the standard `call-actor` tool, send this exact payload:

```json
{
  "name": "call-actor",
  "arguments": {
    "actor": "zinin/sec-edgar-watcher",
    "input": {
      "tickers": [
        "AAPL",
        "TSLA",
        "NVDA"
      ],
      "formTypes": []
    }
  }
}
```

#### Related tools

Related tools for adjacent workflows in financial signals and markets.

| Actor | What it does |
|---|---|
| [Funding Round Tracker](https://apify.com/zinin/funding-round-tracker) | Pair it in the financial signals and markets workflow: Track recent SEC Form D filings by company name or sector keyword — the notice a company files when it... |
| [Insider Trading Tracker](https://apify.com/zinin/insider-trading-tracker) | Pair it in the financial signals and markets workflow: Track insider stock trades — SEC Form 3/4/5 filings — for any list of tickers |
| [Clinical Trials Monitor](https://apify.com/zinin/clinical-trials-monitor) | Pair it in the financial signals and markets workflow: Watch conditions, drugs or sponsors for new and updated clinical trials |
| [13F Portfolio Tracker](https://apify.com/zinin/thirteen-f-tracker) | Pair it in the financial signals and markets workflow: Track institutional managers (hedge funds, family offices) by SEC CIK or name and get their recent 13F-HR... |
| [Patent Filing Monitor](https://apify.com/zinin/patent-monitor) | Pair it in the financial signals and markets workflow: Watch keywords or technologies for newly granted US patents |

### FAQ

**Does it need an API key or login?** No — `company_tickers.json` and `submissions/CIK*.json` are public SEC EDGAR endpoints.

**How fresh is the data?** As fresh as EDGAR itself — filings usually appear within minutes of acceptance.

**Does it cover filings older than what `sinceDays` reaches?** It reads each company's `filings.recent` list (SEC's own most-recent-filings feed, up to ~1000 entries). For tickers with very high filing volume, a multi-year `sinceDays` window may not reach as far back as 10 years if the 1000-entry cap is hit first — SEC's own archived/paginated filing files are out of scope for this Actor.

**Can I filter by form type?** Yes — set `formTypes` to any SEC form codes, e.g. `["10-K", "10-Q", "8-K"]`.

**Can I call it from an AI agent?** Yes — it's a standard Apify Actor, callable via the Apify API or the Apify MCP server.

**What this is NOT.** It does not read the contents of a filing, does not summarize what changed inside an 8-K or 10-K, and does not compute alerts or trading signals. It answers one question — which filings landed in this window for this ticker — from SEC's own structured index.

This Actor surfaces public SEC filing metadata for research and monitoring. It is not investment advice — a filing list is not a recommendation to buy, sell or hold anything.

Found a wrong result, or need a check we don't run? Open an issue on this Actor's page.

### Machine use

The Actor is callable through the Apify API, SDK, and Apify MCP server. The input and Dataset row are the machine-facing contract; a `found:false` row means the ticker never resolved to a CIK or the lookup failed — an agent scanning a watchlist should read `error` on those rows rather than treat a missing ticker as "zero filings."

***

Built by [zinin](https://apify.com/zinin). Questions? Telegram [@timzinin](https://t.me/timzinin).

# Actor input Schema

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

Stock tickers to watch for new SEC filings (e.g. `AAPL`, `TSLA`, `NVDA`). One row per ticker.

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

Only include these SEC form types (e.g. `10-K`, `8-K`, `S-1`). Leave empty to include every form type.

## `sinceDays` (type: `integer`):

Only include filings from the last N days.

## `maxConcurrency` (type: `integer`):

How many tickers to process in parallel. SEC EDGAR's documented rate limit is 10 requests/second — keep this at or below 10.

## Actor input object example

```json
{
  "tickers": [
    "AAPL",
    "TSLA",
    "NVDA"
  ],
  "formTypes": [],
  "sinceDays": 90,
  "maxConcurrency": 5
}
```

# Actor output Schema

## `results` (type: `string`):

API URL for the default dataset items produced by this run.

# 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",
        "TSLA",
        "NVDA"
    ],
    "formTypes": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("zinin/sec-edgar-watcher").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",
        "TSLA",
        "NVDA",
    ],
    "formTypes": [],
}

# Run the Actor and wait for it to finish
run = client.actor("zinin/sec-edgar-watcher").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",
    "TSLA",
    "NVDA"
  ],
  "formTypes": []
}' |
apify call zinin/sec-edgar-watcher --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/dz3He3ZnYc6hgJYvf/builds/Q51Un61JoS2KHCoqJ/openapi.json