# SEC EDGAR Filing Watchlist Monitor (`orbiscribe/sec-edgar-watchlist-monitor`) Actor Monitor official SEC EDGAR filings by ticker, CIK, form type, and date range. Export clean filing records for alerts. - **URL**: https://apify.com/orbiscribe/sec-edgar-watchlist-monitor.md - **Developed by:** [Orbiscribe Labs](https://apify.com/orbiscribe) (community) - **Categories:** Business, Automation, AI - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $2.00 / 1,000 filing records 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 Monitor SEC EDGAR filings by ticker, CIK, form type, and date range. This Actor uses official SEC JSON endpoints and returns clean filing records for watchlists, alerts, spreadsheets, dashboards, and research workflows. Use it to catch new 10-K, 10-Q, 8-K, S-1, DEF 14A, and ownership filings across portfolio companies, competitors, vendors, customers, or acquisition targets. ### What does this SEC EDGAR monitor do? EDGAR filings are public, but checking every ticker and form type by hand is easy to miss. SEC EDGAR Watchlist Monitor turns a list of tickers or CIKs into a structured dataset of recent filings with filing dates, accession numbers, direct document links, company metadata, and SEC source links. The Actor does not use a browser or proxy. It calls SEC public data endpoints with a configurable `User-Agent`, follows SEC-friendly pacing, and stores one dataset row per filing. The Actor also writes key-value outputs for scheduled workflows: - `RUN_SUMMARY`: counts, watchlist inputs, and errors - `FILING_EXPORT`: all emitted SEC filing records - `BUYER_BRIEF`: a short Markdown brief by form and company - `SLACK_ALERTS`: compact alert objects for webhook or chat workflows ### What data can you extract? | Field | Description | | --- | --- | | `ticker` | Ticker symbol matched to the filing | | `companyName` | SEC registrant name | | `form` | Filing form type, such as `10-K`, `10-Q`, `8-K`, or `S-1` | | `filingDate` | Official filing date | | `acceptedAt` | SEC acceptance timestamp when available | | `reportDate` | Period or report date | | `accessionNumber` | SEC accession number | | `primaryDocument` | Primary filing document filename | | `filingUrl` | Direct URL to the SEC filing document | | `companyUrl` | SEC company browser URL | Results can be exported from Apify as JSON, CSV, Excel, XML, RSS, or HTML. ### Quick start 1. Add ticker symbols or CIKs. 2. Choose the form types you care about. 3. Set `daysBack` to the lookback window. 4. Set `maxResults` to control cost and dataset size. 5. Add a real contact email in `secUserAgent` for production runs. Start with a small watchlist such as `AAPL`, `MSFT`, and `NVDA`, then schedule the Actor for recurring filing alerts. ### Input example ```json { "tickers": ["AAPL", "MSFT", "NVDA"], "formTypes": ["10-K", "10-Q", "8-K", "S-1", "DEF 14A"], "daysBack": 90, "maxResults": 25, "secUserAgent": "sec-edgar-watchlist-apify/0.1 contact: your@email.com" } ```` ### Output example ```json { "cik": "0000320193", "ticker": "AAPL", "companyName": "Apple Inc.", "form": "10-Q", "filingDate": "2026-05-01T00:00:00.000Z", "acceptedAt": "2026-05-01T20:00:00.000Z", "reportDate": "2026-03-28T00:00:00.000Z", "accessionNumber": "0000320193-26-000001", "primaryDocument": "aapl-20260328.htm", "description": "Quarterly report", "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000001/aapl-20260328.htm", "companyUrl": "https://www.sec.gov/edgar/browse/?CIK=0000320193", "source": "SEC EDGAR" } ``` ### Pricing This Actor uses pay-per-event pricing. Dry-run examples are not charged. Apify free-plan users get the first 10 filing records without this Actor's custom event charge; after that, normal pay-per-event pricing and the user's run spending limit apply. | Event | Price | What counts | | --- | --- | --- | | `filing-record` | `$0.002` | One SEC filing written to the dataset | That is `$2 per 1,000` emitted filing records, plus normal Apify platform usage. Use `maxResults`, `formTypes`, and `daysBack` to keep runs predictable. ### Common use cases - Watch new 8-K events for portfolio companies. - Track S-1 filings from private-company competitors entering public markets. - Monitor proxy filings and annual reports across a legal or finance watchlist. - Send new filings into Slack, email, Google Sheets, Airtable, or a dashboard. - Build a daily SEC filing feed for analysts. ### Limits and compliance The Actor uses official public SEC EDGAR endpoints. It does not provide investment advice, scrape private portals, or bypass access controls. The SEC expects automated clients to identify themselves. Use a descriptive `secUserAgent` with your organization or contact email for production runs. # Actor input Schema ## `tickers` (type: `array`): Stock tickers to monitor, such as AAPL, MSFT, NVDA. ## `ciks` (type: `array`): Optional SEC CIK numbers. Use this when a company has no ticker or you already know the CIK. ## `formTypes` (type: `array`): SEC form types to include. Leave empty to include all recent forms. ## `daysBack` (type: `integer`): Only emit filings accepted within this many days. ## `maxResults` (type: `integer`): Maximum filing records to emit. ## `includeOwnershipForms` (type: `boolean`): Include Forms 3, 4, and 5 even if formTypes is empty. ## `secUserAgent` (type: `string`): Required by SEC fair-access guidance. Include app name and contact email. ## `dryRun` (type: `boolean`): Emit sample records without calling SEC APIs. ## Actor input object example ```json { "tickers": [ "AAPL", "MSFT", "NVDA" ], "ciks": [], "formTypes": [ "10-K", "10-Q", "8-K", "S-1", "DEF 14A" ], "daysBack": 30, "maxResults": 100, "includeOwnershipForms": false, "secUserAgent": "sec-edgar-watchlist-apify/0.1 contact: mr@shu.io", "dryRun": false } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "tickers": [ "AAPL", "MSFT", "NVDA" ], "formTypes": [ "10-K", "10-Q", "8-K", "S-1", "DEF 14A" ] }; // Run the Actor and wait for it to finish const run = await client.actor("orbiscribe/sec-edgar-watchlist-monitor").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", "MSFT", "NVDA", ], "formTypes": [ "10-K", "10-Q", "8-K", "S-1", "DEF 14A", ], } # Run the Actor and wait for it to finish run = client.actor("orbiscribe/sec-edgar-watchlist-monitor").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", "MSFT", "NVDA" ], "formTypes": [ "10-K", "10-Q", "8-K", "S-1", "DEF 14A" ] }' | apify call orbiscribe/sec-edgar-watchlist-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=orbiscribe/sec-edgar-watchlist-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filing Watchlist Monitor", "description": "Monitor official SEC EDGAR filings by ticker, CIK, form type, and date range. Export clean filing records for alerts.", "version": "0.1", "x-build-id": "GdtM5MxVrhvCZXkRq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/orbiscribe~sec-edgar-watchlist-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-orbiscribe-sec-edgar-watchlist-monitor", "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/orbiscribe~sec-edgar-watchlist-monitor/runs": { "post": { "operationId": "runs-sync-orbiscribe-sec-edgar-watchlist-monitor", "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/orbiscribe~sec-edgar-watchlist-monitor/run-sync": { "post": { "operationId": "run-sync-orbiscribe-sec-edgar-watchlist-monitor", "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": [ "secUserAgent" ], "properties": { "tickers": { "title": "Tickers", "type": "array", "description": "Stock tickers to monitor, such as AAPL, MSFT, NVDA.", "default": [ "AAPL", "MSFT", "NVDA" ], "items": { "type": "string" } }, "ciks": { "title": "CIKs", "type": "array", "description": "Optional SEC CIK numbers. Use this when a company has no ticker or you already know the CIK.", "default": [], "items": { "type": "string" } }, "formTypes": { "title": "Form types", "type": "array", "description": "SEC form types to include. Leave empty to include all recent forms.", "default": [ "10-K", "10-Q", "8-K", "S-1", "DEF 14A" ], "items": { "type": "string" } }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only emit filings accepted within this many days.", "default": 30 }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum filing records to emit.", "default": 100 }, "includeOwnershipForms": { "title": "Include ownership forms", "type": "boolean", "description": "Include Forms 3, 4, and 5 even if formTypes is empty.", "default": false }, "secUserAgent": { "title": "SEC User-Agent", "type": "string", "description": "Required by SEC fair-access guidance. Include app name and contact email.", "default": "sec-edgar-watchlist-apify/0.1 contact: mr@shu.io" }, "dryRun": { "title": "Dry run demo", "type": "boolean", "description": "Emit sample records without calling SEC APIs.", "default": false } } }, "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 } } } } } } } } } } ```