# SEC Event Router — Unified SEC Filings & Events Timeline (`nexgendata/sec-event-router`) Actor ONE QUERY → all SEC events (8-K, Form 4, Form D, 13F-HR, Litigation) for a ticker, company name, or CIK in a unified, chronological timeline. - **URL**: https://apify.com/nexgendata/sec-event-router.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $100.00 / 1,000 events 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 ## SEC Event Router — Unified SEC Filings & Events Timeline **ONE QUERY → all SEC events for a company.** Stop running four different SEC actors and stitching the results together. Send one ticker, company name, or CIK and get a unified, chronologically sorted timeline of every material SEC event — 8-K filings, Form 4 insider transactions, Form D private placements, 13F-HR institutional holdings, and SEC litigation releases — in a single dataset. ### 📊 Sample Output [![SEC Event Router — unified gateway for SEC events (8-K + Litigation + Form 4 + Form D + 13F) by ticker. Hedge fund event timeline, M&A advisor company monitoring, compliance team multi-form research.](https://api.apify.com/v2/key-value-stores/8gLgXMBveEI1tTz1z/records/sec-event-router-output.png)](https://apify.com/nexgendata/sec-event-router) ### What it does - Resolves any **ticker, company name, or CIK** to a canonical SEC CIK via EDGAR full-text search - Fans out to SEC EDGAR (`efts.sec.gov`) for every requested form type in parallel - Scrapes SEC litigation releases for civil/admin actions naming the company - Normalizes everything into one event row schema with a `form_type` discriminator - Sorts the merged result by `filing_date DESC` so the freshest event is row 0 - Per-row `source_url` points back to the exact SEC filing index page ### Buyer use cases - **Hedge fund event-driven research** — surface every catalyst (8-K, insider buying, litigation) for a watchlist ticker in one call - **M&A diligence timelines** — build a complete SEC event history for the target before signing the LOI - **Investigative journalism** — track a company's material disclosures, insider activity, and regulatory actions across years - **Compliance & monitoring** — daily portfolio sweep across all SEC event types for every holding ### Input | Field | Type | Description | |---|---|---| | `query` | string (required) | Ticker (`AAPL`), company name (`Apple Inc.`), or 10-digit CIK | | `formTypes` | string[] | Subset of `["8-K", "4", "D", "13F-HR", "Litigation"]` (default: all) | | `dateFrom` | string | Earliest event date `YYYY-MM-DD` | | `dateTo` | string | Latest event date `YYYY-MM-DD` (empty = today) | | `maxEventsPerType` | integer | Cap per form type (1–100). Hard total cap = `maxEventsPerType × formTypes.length` | ### Output schema ```json { "form_type": "8-K | 4 | D | 13F-HR | Litigation Release", "filing_date": "2026-05-28", "accession_number": "0001234567-26-000123", "company_name": "Apple Inc.", "ticker": "AAPL", "cik": "320193", "event_title": "Item 8.01 Other Events: Subsidiary Reorganization", "event_summary": "First 500 chars of headline + key items/event type", "form_specific_data": {}, "source_url": "https://www.sec.gov/...", "scraped_at": "2026-05-29T20:00:00Z" } ```` `form_specific_data` shape varies by `form_type`: - **8-K**: `{"items": ["1.01", "8.01"]}` - **4**: `{"insider_name": "Jane Doe", "insider_role": "CEO", "transaction_type": "Sale", "shares": 10000, "price_per_share": 175.50}` - **D**: `{"offering_amount": 5000000, "amount_sold": 2500000, "investors_count": 18}` - **13F-HR**: `{"total_value_usd": 45000000000, "holdings_count": 850}` - **Litigation Release**: `{"defendants": ["John Smith"], "action_type": "civil_action", "release_number": "LR-25888"}` ### Sample Output ```json [ { "form_type": "8-K", "filing_date": "2026-05-28", "accession_number": "0000320193-26-000098", "company_name": "Apple Inc.", "ticker": "AAPL", "cik": "320193", "event_title": "Item 8.01 Other Events", "event_summary": "Apple Inc. — Form 8-K filed 2026-05-28. Items: 8.01.", "form_specific_data": {"items": ["8.01"]}, "source_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193&type=8-K", "scraped_at": "2026-05-29T20:00:00Z" }, { "form_type": "4", "filing_date": "2026-05-22", "accession_number": "0000320193-26-000091", "company_name": "Apple Inc.", "ticker": "AAPL", "cik": "320193", "event_title": "Form 4 — Insider transaction", "event_summary": "Form 4 insider transaction filed for Apple Inc.", "form_specific_data": {"insider_name": null, "insider_role": null, "transaction_type": null, "shares": null, "price_per_share": null}, "source_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193&type=4", "scraped_at": "2026-05-29T20:00:00Z" }, { "form_type": "D", "filing_date": "2026-04-19", "accession_number": "0000320193-26-000077", "company_name": "Apple Inc.", "ticker": "AAPL", "cik": "320193", "event_title": "Form D — Notice of Exempt Offering", "event_summary": "Form D filed for Apple Inc.", "form_specific_data": {"offering_amount": null, "amount_sold": null, "investors_count": null}, "source_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193&type=D", "scraped_at": "2026-05-29T20:00:00Z" } ] ``` ### When to use the dedicated actors instead This is a **convenience router** optimized for breadth across form types for a single ticker. If you need volume on one form type — entire market 8-K firehose, every insider transaction in the S\&P 500, all Form D offerings in a quarter — use the dedicated actors: - **sec-edgar-8k-filings** — high-throughput 8-K firehose - **sec-litigation-releases** — every SEC enforcement action - **sec-form-d-tracker** — Reg D private placement firehose - **sec-form4-insider-tracker** — insider transaction firehose - **sec-form-13f-tracker-pro** — institutional holdings snapshots ### Compliance - Issues `User-Agent: NexGenData hello@nexgendata.com` on every SEC request (SEC mandates a contact UA) - Rate-limited to ≤5 req/s (SEC ceiling is 10 req/s; we stay conservative) - All data sourced directly from `efts.sec.gov`, `www.sec.gov/litigation/litreleases.htm`, and EDGAR filing index pages — public legal record only - Per-row `source_url` for verification - Officer names, insider names, and defendants from SEC filings are public legal record; no extra PII (no emails, phones, addresses) ### Keywords SEC event timeline API, SEC filings aggregator, 8-K Form 4 Form D 13F unified, SEC company events API, EDGAR filings unified, insider trading timeline, SEC litigation timeline, company event-driven research ### Related Actors — Regulatory & IP Intelligence Cluster **Securities & Markets Enforcement:** - [SEC Litigation Releases](https://apify.com/nexgendata/sec-litigation-releases) - [CFTC Enforcement Actions](https://apify.com/nexgendata/cftc-enforcement-actions) - [FTC Consumer Protection Cases](https://apify.com/nexgendata/ftc-consumer-protection-cases) - [FINRA BrokerCheck Search](https://apify.com/nexgendata/finra-brokercheck-search) - [Australia ASIC Enforcement](https://apify.com/nexgendata/australia-asic-enforcement) - [UK FCA Enforcement Tracker](https://apify.com/nexgendata/uk-fca-enforcement-tracker) **Corporate Disclosure & Announcements:** - [SEC EDGAR 8-K Filings](https://apify.com/nexgendata/sec-edgar-8k-filings) - [SEC Form D Funding](https://apify.com/nexgendata/sec-form-d-tracker) - [SEC Event Router](https://apify.com/nexgendata/sec-event-router) ← **you are here** - [ASX Company Announcements](https://apify.com/nexgendata/asx-company-announcements) - [SGX Company Announcements](https://apify.com/nexgendata/sgx-company-announcements) - [HKEX News Announcements](https://apify.com/nexgendata/hkex-news-announcements) - [Korea KIND Disclosures](https://apify.com/nexgendata/korea-kind-disclosures) - [PSE Edge Disclosures](https://apify.com/nexgendata/pse-edge-disclosures) - [Investegate RNS Aggregator](https://apify.com/nexgendata/investegate-rns-aggregator) - [PR Newswire](https://apify.com/nexgendata/pr-newswire-press-releases-scraper) - [AP News](https://apify.com/nexgendata/ap-news-scraper) **IP Intelligence:** - [USPTO Patent Grants Tracker](https://apify.com/nexgendata/uspto-patent-grants-tracker) - [WIPO PATENTSCOPE](https://apify.com/nexgendata/wipo-patentscope-search) - [EUIPO Trademarks](https://apify.com/nexgendata/euipo-esearch-trademarks) # Actor input Schema ## `query` (type: `string`): Ticker, company name, or CIK number. ## `formTypes` (type: `array`): Which SEC forms to include. Options: '8-K', '4', 'D', '13F-HR', 'Litigation'. Default = all. ## `dateFrom` (type: `string`): Earliest event date (YYYY-MM-DD). ## `dateTo` (type: `string`): Latest event date (YYYY-MM-DD). Empty = today. ## `maxEventsPerType` (type: `integer`): Cap per form type. Hard total cap = maxEventsPerType \* formTypes count. ## Actor input object example ```json { "query": "AAPL", "formTypes": [ "8-K", "4", "D", "13F-HR", "Litigation" ], "dateFrom": "2026-04-01", "maxEventsPerType": 10 } ``` # 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 = { "query": "AAPL", "formTypes": [ "8-K", "4", "D", "13F-HR", "Litigation" ], "dateFrom": "2026-04-01", "dateTo": "", "maxEventsPerType": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/sec-event-router").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 = { "query": "AAPL", "formTypes": [ "8-K", "4", "D", "13F-HR", "Litigation", ], "dateFrom": "2026-04-01", "dateTo": "", "maxEventsPerType": 10, } # Run the Actor and wait for it to finish run = client.actor("nexgendata/sec-event-router").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 '{ "query": "AAPL", "formTypes": [ "8-K", "4", "D", "13F-HR", "Litigation" ], "dateFrom": "2026-04-01", "dateTo": "", "maxEventsPerType": 10 }' | apify call nexgendata/sec-event-router --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/sec-event-router", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC Event Router — Unified SEC Filings & Events Timeline", "description": "ONE QUERY → all SEC events (8-K, Form 4, Form D, 13F-HR, Litigation) for a ticker, company name, or CIK in a unified, chronological timeline.", "version": "0.0", "x-build-id": "VHVphtzh3MmFteBA3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~sec-event-router/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-sec-event-router", "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/nexgendata~sec-event-router/runs": { "post": { "operationId": "runs-sync-nexgendata-sec-event-router", "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/nexgendata~sec-event-router/run-sync": { "post": { "operationId": "run-sync-nexgendata-sec-event-router", "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": [ "query" ], "properties": { "query": { "title": "Company Query", "type": "string", "description": "Ticker, company name, or CIK number." }, "formTypes": { "title": "Form Types", "type": "array", "description": "Which SEC forms to include. Options: '8-K', '4', 'D', '13F-HR', 'Litigation'. Default = all.", "items": { "type": "string" } }, "dateFrom": { "title": "Date From", "type": "string", "description": "Earliest event date (YYYY-MM-DD)." }, "dateTo": { "title": "Date To", "type": "string", "description": "Latest event date (YYYY-MM-DD). Empty = today." }, "maxEventsPerType": { "title": "Max Events Per Form Type", "minimum": 1, "maximum": 100, "type": "integer", "description": "Cap per form type. Hard total cap = maxEventsPerType * formTypes count." } } }, "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 } } } } } } } } } } ```