# 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 $3.00 / 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. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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. ### 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. #### Need the rest of the picture? These run on the same account, take the same shape of input and bill the same way, so they slot into an existing pipeline without new plumbing. | Actor | What it does | |---|---| | [Insider Trading Tracker](https://apify.com/zinin/insider-trading-tracker) | Track insider stock trades — SEC Form 3/4/5 filings — for any list of tickers | | [AI Crawler Access Checker](https://apify.com/zinin/ai-crawler-access-checker) | Check which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended & more) can access your website | | [B2B Lead Enricher](https://apify.com/zinin/b2b-lead-enricher) | Turn a list of company websites into sales-qualified lead cards: detected tech stack, a rough revenue… | | [Clinical Trials Monitor](https://apify.com/zinin/clinical-trials-monitor) | Watch conditions, drugs or sponsors for new and updated clinical trials | | [Company Hiring Radar](https://apify.com/zinin/company-hiring-radar) | Pull every open role a company is hiring for from its public job board (Greenhouse, Lever, Ashby) and turn… | ### 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. *** 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 } ``` # 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 '' with your token const client = new ApifyClient({ 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 '' with your token. client = ApifyClient("") # 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 " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC Filing Watcher", "description": "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.", "version": "0.1", "x-build-id": "EeJi90gLe1fbLQq0J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zinin~sec-edgar-watcher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zinin-sec-edgar-watcher", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zinin~sec-edgar-watcher/runs": { "post": { "operationId": "runs-sync-zinin-sec-edgar-watcher", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zinin~sec-edgar-watcher/run-sync": { "post": { "operationId": "run-sync-zinin-sec-edgar-watcher", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "tickers" ], "properties": { "tickers": { "title": "Tickers", "maxItems": 100, "type": "array", "description": "Stock tickers to watch for new SEC filings (e.g. `AAPL`, `TSLA`, `NVDA`). One row per ticker.", "items": { "type": "string" } }, "formTypes": { "title": "Form types", "maxItems": 30, "type": "array", "description": "Only include these SEC form types (e.g. `10-K`, `8-K`, `S-1`). Leave empty to include every form type.", "items": { "type": "string" } }, "sinceDays": { "title": "Since (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only include filings from the last N days.", "default": 90 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many tickers to process in parallel. SEC EDGAR's documented rate limit is 10 requests/second — keep this at or below 10.", "default": 5 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```