# 💵 SEC Form D Funding Leads — New Raises Watch (`nexgenwatch/form-d-funding-leads-watch`) Actor SEC EDGAR Form D watch — new private placements and funding leads (issuer, amount, dates) with deltas on new and changed filings. - **URL**: https://apify.com/nexgenwatch/form-d-funding-leads-watch.md - **Developed by:** [NexGen Watch](https://apify.com/nexgenwatch) (community) - **Categories:** Business - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $33.50 / 1,000 funding leads 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 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/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 Form D Funding Leads Change Watch Receive seed-zero, structured records for **new and amended public SEC Form D private-offering filings** that match your geography, industry, exemption and offering-size rules — with filing-level receipts, not another historical Form D dump. The actor checks the official EDGAR daily indexes, parses public **D / D/A** XML as filed, and emits only qualified post-baseline filings and material amendment changes. Each record carries its accession number, source XML URL and a run receipt. SEC describes Form D as a notice of an exempt offering and says accepted filings become public on EDGAR. ### How it works 1. Reads the EDGAR daily-index directory for the requested quarter and selects the in-scope `form.YYYYMMDD.idx` files (bounded, oldest first). 2. Parses the fixed-width form index and keeps only `D` / `D/A` rows. 3. Fetches each matching filing directory and its primary Form D XML, parsing only Form D elements — issuer, offering, exemptions, amounts, dates, participants. 4. Normalizes, applies your local lead filters, and (in watch mode) compares to a private baseline to emit `NEW_OFFERING`, `AMENDMENT`, `OFFERING_INCREASED`, `AMOUNT_SOLD_INCREASED`, `OFFERING_CLOSED` or `FILER_CORRECTION` deltas. The first watch run seeds silently (zero alerts). Later runs emit only new and changed offerings. ### Output Three record types, discriminated by `record_type`: - `form_d_filing` — a normalized snapshot filing (snapshot mode). - `funding_lead_delta` — a post-baseline change, with `before`/`after` and `changed_fields` (watch mode). - `source_receipt` — a per-filing-date run receipt (`terminal_state`, `canary_passed`, request counters). Always emitted, never billed. Every item carries `source_url` and `observed_at`. ### Use cases Venture and funding teams route newly filed offerings; service providers identify issuers with active raises; compliance teams watch amendments; data teams ingest structured private-offering filings. ### Honest limits A Form D is an **issuer-filed notice**, not proof that the target was raised, of company quality, of investor intent, or of complete private financing. Some issuers omit revenue or amount details (`Indefinite` amounts become `null` with a parse warning). Amendments are linked **conservatively** by a deterministic offering key; an amendment we cannot link is emitted with `before=null` and a warning. No contact enrichment, scoring or recommendations. EDGAR delays, outages and fair-access controls fail loud (BLOCKED / PARTIAL), never a silent empty success. ### Compliance Public, logged-out EDGAR only. A descriptive **User-Agent with a real contact** is required by SEC fair-access and must be supplied via `secUserAgent` (or the `SEC_USER_AGENT` env var); a missing or placeholder value fails before any network call. The actor self-throttles to 2 requests/second (below SEC's 10/s ceiling). No login, key, CAPTCHA or paywall defeating; no licensed source; the actor stops on SEC objection. # Actor input Schema ## `watchMode` (type: `boolean`): When true, seed a private baseline and emit only post-baseline qualifying deltas (first run emits zero). When false, emit snapshot form_d_filing rows. ## `baselineKey` (type: `string`): Named watch baseline (1-120 chars, [A-Za-z0-9._:-]). Null derives a SHA-256 of the normalized filters. ## `filingTypes` (type: `array`): Form D filing types to include. ## `issuerNameKeywords` (type: `array`): Keep only filings whose issuer name contains one of these substrings (case-insensitive). Empty keeps all. ## `issuerStates` (type: `array`): Uppercase two-letter US state or SEC country codes. Empty keeps all issuers (including foreign). ## `industryGroups` (type: `array`): Exact Form D industry-group labels. ## `industryKeywords` (type: `array`): Local match against issuer-reported industry fields (case-insensitive). ## `federalExemptions` (type: `array`): Keep filings claiming any of these exemptions. Empty keeps all; filed values are preserved. ## `minTotalOfferingAmount` (type: `integer`): Keep only filings whose total offering amount is at least this. Indeterminate ('Indefinite') amounts are excluded when a minimum is set. Null disables. ## `maxTotalOfferingAmount` (type: `integer`): Upper bound on total offering amount. Null disables. ## `minAmountSold` (type: `integer`): Keep only filings with at least this amount already sold. Null disables. ## `firstSaleWithinDays` (type: `integer`): Keep filings whose first sale is within this many days of the filing date (yet-to-sell handled by includeYetToSell). Null disables. ## `includeYetToSell` (type: `boolean`): Whether filings that have not yet made a first sale qualify. ## `includeRelatedPersons` (type: `boolean`): Include the public related-persons list (no enrichment). ## `includeSalesCompensation` (type: `boolean`): Include public Item 12 sales-compensation recipients. ## `emitDeltaTypes` (type: `array`): Which watch-mode delta types to emit. ## `startDate` (type: `string`): Earliest filing date to process. Null uses the latest available filing date on seed. Must be <= today. ## `maxFilingDates` (type: `integer`): Maximum daily filing dates to process this run. ## `maxFilings` (type: `integer`): Maximum matching D/D/A filings to fetch this run. ## `secUserAgent` (type: `string`): Descriptive User-Agent with a real contact, e.g. 'NexGenData FormDWatch/1.0 you@example.org'. Required by SEC fair-access. Falls back to the SEC_USER_AGENT env var. ## Actor input object example ```json { "watchMode": false, "filingTypes": [ "D", "D/A" ], "issuerNameKeywords": [], "issuerStates": [], "industryGroups": [], "industryKeywords": [], "federalExemptions": [], "minTotalOfferingAmount": 1000000, "firstSaleWithinDays": 30, "includeYetToSell": true, "includeRelatedPersons": false, "includeSalesCompensation": false, "emitDeltaTypes": [ "NEW_OFFERING", "AMENDMENT", "OFFERING_INCREASED", "AMOUNT_SOLD_INCREASED", "OFFERING_CLOSED", "FILER_CORRECTION" ], "maxFilingDates": 1, "maxFilings": 40 } ```` # 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 = { "watchMode": false, "firstSaleWithinDays": 30, "includeRelatedPersons": false, "includeSalesCompensation": false, "maxFilingDates": 1, "maxFilings": 40 }; // Run the Actor and wait for it to finish const run = await client.actor("nexgenwatch/form-d-funding-leads-watch").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 = { "watchMode": False, "firstSaleWithinDays": 30, "includeRelatedPersons": False, "includeSalesCompensation": False, "maxFilingDates": 1, "maxFilings": 40, } # Run the Actor and wait for it to finish run = client.actor("nexgenwatch/form-d-funding-leads-watch").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 '{ "watchMode": false, "firstSaleWithinDays": 30, "includeRelatedPersons": false, "includeSalesCompensation": false, "maxFilingDates": 1, "maxFilings": 40 }' | apify call nexgenwatch/form-d-funding-leads-watch --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgenwatch/form-d-funding-leads-watch", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "💵 SEC Form D Funding Leads — New Raises Watch", "description": "SEC EDGAR Form D watch — new private placements and funding leads (issuer, amount, dates) with deltas on new and changed filings.", "version": "0.1", "x-build-id": "vFwTd8ueeb4PbeiHV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgenwatch~form-d-funding-leads-watch/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgenwatch-form-d-funding-leads-watch", "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/nexgenwatch~form-d-funding-leads-watch/runs": { "post": { "operationId": "runs-sync-nexgenwatch-form-d-funding-leads-watch", "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/nexgenwatch~form-d-funding-leads-watch/run-sync": { "post": { "operationId": "run-sync-nexgenwatch-form-d-funding-leads-watch", "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", "properties": { "watchMode": { "title": "Watch mode (seed-zero delta feed)", "type": "boolean", "description": "When true, seed a private baseline and emit only post-baseline qualifying deltas (first run emits zero). When false, emit snapshot form_d_filing rows.", "default": false }, "baselineKey": { "title": "Baseline key", "type": "string", "description": "Named watch baseline (1-120 chars, [A-Za-z0-9._:-]). Null derives a SHA-256 of the normalized filters." }, "filingTypes": { "title": "Filing types", "type": "array", "description": "Form D filing types to include.", "items": { "type": "string", "enum": [ "D", "D/A" ] }, "default": [ "D", "D/A" ] }, "issuerNameKeywords": { "title": "Issuer name keywords (match-any)", "type": "array", "description": "Keep only filings whose issuer name contains one of these substrings (case-insensitive). Empty keeps all.", "items": { "type": "string" }, "default": [] }, "issuerStates": { "title": "Issuer states / countries", "type": "array", "description": "Uppercase two-letter US state or SEC country codes. Empty keeps all issuers (including foreign).", "items": { "type": "string" }, "default": [] }, "industryGroups": { "title": "Industry groups (exact)", "type": "array", "description": "Exact Form D industry-group labels.", "items": { "type": "string" }, "default": [] }, "industryKeywords": { "title": "Industry keywords", "type": "array", "description": "Local match against issuer-reported industry fields (case-insensitive).", "items": { "type": "string" }, "default": [] }, "federalExemptions": { "title": "Federal exemptions / exclusions", "type": "array", "description": "Keep filings claiming any of these exemptions. Empty keeps all; filed values are preserved.", "items": { "type": "string", "enum": [ "06b", "3C", "3C.1", "3C.7", "3C.9", "Rule504", "Rule506b", "Rule506c", "SecuritiesAct4a5" ] }, "default": [] }, "minTotalOfferingAmount": { "title": "Min total offering amount (USD)", "minimum": 0, "type": "integer", "description": "Keep only filings whose total offering amount is at least this. Indeterminate ('Indefinite') amounts are excluded when a minimum is set. Null disables.", "default": 1000000 }, "maxTotalOfferingAmount": { "title": "Max total offering amount (USD)", "minimum": 0, "type": "integer", "description": "Upper bound on total offering amount. Null disables." }, "minAmountSold": { "title": "Min amount sold (USD)", "minimum": 0, "type": "integer", "description": "Keep only filings with at least this amount already sold. Null disables." }, "firstSaleWithinDays": { "title": "First sale within days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Keep filings whose first sale is within this many days of the filing date (yet-to-sell handled by includeYetToSell). Null disables.", "default": 30 }, "includeYetToSell": { "title": "Include yet-to-sell offerings", "type": "boolean", "description": "Whether filings that have not yet made a first sale qualify.", "default": true }, "includeRelatedPersons": { "title": "Include related persons", "type": "boolean", "description": "Include the public related-persons list (no enrichment).", "default": false }, "includeSalesCompensation": { "title": "Include sales compensation", "type": "boolean", "description": "Include public Item 12 sales-compensation recipients.", "default": false }, "emitDeltaTypes": { "title": "Emit delta types", "type": "array", "description": "Which watch-mode delta types to emit.", "items": { "type": "string", "enum": [ "NEW_OFFERING", "AMENDMENT", "OFFERING_INCREASED", "AMOUNT_SOLD_INCREASED", "OFFERING_CLOSED", "FILER_CORRECTION" ] }, "default": [ "NEW_OFFERING", "AMENDMENT", "OFFERING_INCREASED", "AMOUNT_SOLD_INCREASED", "OFFERING_CLOSED", "FILER_CORRECTION" ] }, "startDate": { "title": "Start date (YYYY-MM-DD)", "type": "string", "description": "Earliest filing date to process. Null uses the latest available filing date on seed. Must be <= today." }, "maxFilingDates": { "title": "Max filing dates", "minimum": 1, "maximum": 14, "type": "integer", "description": "Maximum daily filing dates to process this run.", "default": 1 }, "maxFilings": { "title": "Max filings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum matching D/D/A filings to fetch this run.", "default": 40 }, "secUserAgent": { "title": "SEC User-Agent (contact)", "type": "string", "description": "Descriptive User-Agent with a real contact, e.g. 'NexGenData FormDWatch/1.0 you@example.org'. Required by SEC fair-access. Falls back to the SEC_USER_AGENT env var." } } }, "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 } } } } } } } } } } ```