# Funding Leads Report — Scored SEC Form D Raises (`nexgenwatch/funding-leads-report`) Actor

- **URL**: https://apify.com/nexgenwatch/funding-leads-report.md
- **Developed by:** [NexGen Watch](https://apify.com/nexgenwatch) (community)
- **Categories:** Business, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10,050.00 / 1,000 scored funding-leads reports

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

## Funding Leads Report — Scored SEC Form D Raises

**One report call surfaces the newly-funded companies in your sector, geography
and deal-size window — scored and ranked — for less than the price of a coffee.**
A VC associate or SDR building a prospecting list of freshly-raised companies
otherwise reads the raw EDGAR Form D feed by hand, or pays **$100–500+/month**
for a funding-intelligence subscription. This actor delivers the same weekly
answer as a single, self-contained report: **$15.00 per report (FREE tier)** —
run it once a week and a whole sector desk is covered for ~$60/month.

It reads the official SEC EDGAR daily indexes, parses public **D / D/A** Form D
XML as filed, filters to your window, and returns a **deterministically scored
and ranked lead list** plus one rendered markdown brief you can paste straight
into a prospecting doc.

### What you get

- **`funding_lead` records** — one per qualifying raise, each with a 0–100
  `lead_score`, a `HOT` / `WARM` / `COOL` grade, the score breakdown, and the
  buyer-relevant filing fields (issuer, state, sector, offering amount, amount
  sold, first-sale date, exemptions, source URL).
- **One `leads_report` record** — the ranked digest: window, filters, lead and
  grade counts, score summary, the top leads, and a full **rendered markdown
  brief** (also written to the key-value store under `report_kv_key`).
- **`source_receipt` records** — a per-filing-date run receipt (terminal state,
  canary, request counters). Always emitted, never billed.

### How leads are scored (transparent, no AI)

Scoring is a fixed, deterministic rubric — `ngd-fundscore-v1`. Identical inputs
always produce identical scores. No LLM, no external model, no "AI-powered"
anything.

- **Size (0–40)** — banded by total offering amount (bigger raise, bigger account).
- **Recency (0–35)** — linear decay over a 90-day horizon from the filing date.
- **Closure (0–25)** — traction signals: capital already sold, the
  sold-vs-offering ratio, and a very recent first sale (money just started
  moving) or a brand-new open raise.

Leads are ranked by score, with deterministic tie-breaks (larger offering, then
fresher filing, then accession number).

### Input (three caps keep every run bounded)

- `lookbackDays` — how many days back to scan (cap 1).
- `states`, `industryGroups`, `sectorKeywords`, `minRaiseUsd`, `maxRaiseUsd`,
  `includeYetToSell`, `filingTypes` — your sector / geography / deal-size window.
- `maxFilingDates` (cap 2), `maxFilings`, `maxLeads` (cap 3).
- `secUserAgent` — a descriptive User-Agent with a real contact (required by SEC
  fair-access).

### Billing

Pay-per-event, listed price = charged price:

- `apify-actor-start` — reserved system event, auto-charged by the platform.
- **`leads_report`** — charged **exactly once**, only after the report is
  successfully built and pushed. An **empty window over a valid search** is a
  delivered report and **is** charged. A **source failure** (EDGAR blocked,
  shape drift, missing User-Agent) **fails loud and charges nothing**.

### Honest limits

A Form D is an **issuer-filed notice** of an exempt offering — not proof the
raise closed, of company quality, or of investor intent. Issuers sometimes omit
amounts (`Indefinite` amounts become `null` and score 0 on size). The score is a
prospecting heuristic, not investment advice. Public, logged-out EDGAR only; the
actor self-throttles below SEC's rate ceiling and fails loud on EDGAR outages or
fair-access controls — never a silent empty success.

# Actor input Schema

## `lookbackDays` (type: `integer`):

How many days back from today to scan EDGAR daily indexes for new Form D raises. Cap 1: bounds how far back the report reaches.
## `states` (type: `array`):

Uppercase two-letter US state or SEC country codes (e.g. CA, NY, DE). Empty keeps all geographies.
## `industryGroups` (type: `array`):

Exact Form D industry-group labels to keep (e.g. 'Technology', 'Pharmaceuticals', 'Commercial'). Empty keeps all sectors. Combine with sectorKeywords for looser matching.
## `sectorKeywords` (type: `array`):

Case-insensitive substrings matched against the issuer-reported industry fields. Empty keeps all sectors.
## `minRaiseUsd` (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.
## `maxRaiseUsd` (type: `integer`):

Upper bound on total offering amount. Null disables.
## `filingTypes` (type: `array`):

Form D filing types to include.
## `includeYetToSell` (type: `boolean`):

Whether filings that have not yet reported a first sale qualify as leads.
## `maxFilingDates` (type: `integer`):

Cap 2: maximum daily filing dates to process this run (most-recent first, within the lookback window).
## `maxFilings` (type: `integer`):

Cap on matching D / D/A filings fetched from EDGAR this run.
## `maxLeads` (type: `integer`):

Cap 3: maximum scored leads returned in the report (highest score first).
## `secUserAgent` (type: `string`):

Descriptive User-Agent with a real contact, e.g. 'YourCo FundingLeads/1.0 you@example.org'. Required by SEC fair-access. Falls back to the SEC_USER_AGENT env var.

## Actor input object example

```json
{
  "lookbackDays": 3,
  "states": [],
  "industryGroups": [],
  "sectorKeywords": [],
  "filingTypes": [
    "D",
    "D/A"
  ],
  "includeYetToSell": true,
  "maxFilingDates": 3,
  "maxFilings": 120,
  "maxLeads": 30
}
````

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "lookbackDays": 3,
    "maxFilingDates": 3,
    "maxFilings": 120,
    "maxLeads": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgenwatch/funding-leads-report").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 = {
    "lookbackDays": 3,
    "maxFilingDates": 3,
    "maxFilings": 120,
    "maxLeads": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("nexgenwatch/funding-leads-report").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 '{
  "lookbackDays": 3,
  "maxFilingDates": 3,
  "maxFilings": 120,
  "maxLeads": 30
}' |
apify call nexgenwatch/funding-leads-report --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgenwatch/funding-leads-report",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Funding Leads Report — Scored SEC Form D Raises",
        "version": "0.1",
        "x-build-id": "pOrf3Rr7VUaMWWd2c"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nexgenwatch~funding-leads-report/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nexgenwatch-funding-leads-report",
                "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~funding-leads-report/runs": {
            "post": {
                "operationId": "runs-sync-nexgenwatch-funding-leads-report",
                "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~funding-leads-report/run-sync": {
            "post": {
                "operationId": "run-sync-nexgenwatch-funding-leads-report",
                "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": {
                    "lookbackDays": {
                        "title": "Lookback window (days)",
                        "minimum": 1,
                        "maximum": 90,
                        "type": "integer",
                        "description": "How many days back from today to scan EDGAR daily indexes for new Form D raises. Cap 1: bounds how far back the report reaches.",
                        "default": 7
                    },
                    "states": {
                        "title": "Issuer states / countries",
                        "type": "array",
                        "description": "Uppercase two-letter US state or SEC country codes (e.g. CA, NY, DE). Empty keeps all geographies.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "industryGroups": {
                        "title": "Sectors (exact Form D industry groups)",
                        "type": "array",
                        "description": "Exact Form D industry-group labels to keep (e.g. 'Technology', 'Pharmaceuticals', 'Commercial'). Empty keeps all sectors. Combine with sectorKeywords for looser matching.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "sectorKeywords": {
                        "title": "Sector keywords (match-any)",
                        "type": "array",
                        "description": "Case-insensitive substrings matched against the issuer-reported industry fields. Empty keeps all sectors.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "minRaiseUsd": {
                        "title": "Min raise size (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."
                    },
                    "maxRaiseUsd": {
                        "title": "Max raise size (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Upper bound on total offering amount. Null disables."
                    },
                    "filingTypes": {
                        "title": "Filing types",
                        "type": "array",
                        "description": "Form D filing types to include.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "D",
                                "D/A"
                            ]
                        },
                        "default": [
                            "D",
                            "D/A"
                        ]
                    },
                    "includeYetToSell": {
                        "title": "Include yet-to-sell offerings",
                        "type": "boolean",
                        "description": "Whether filings that have not yet reported a first sale qualify as leads.",
                        "default": true
                    },
                    "maxFilingDates": {
                        "title": "Max filing dates",
                        "minimum": 1,
                        "maximum": 14,
                        "type": "integer",
                        "description": "Cap 2: maximum daily filing dates to process this run (most-recent first, within the lookback window).",
                        "default": 7
                    },
                    "maxFilings": {
                        "title": "Max filings fetched",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Cap on matching D / D/A filings fetched from EDGAR this run.",
                        "default": 500
                    },
                    "maxLeads": {
                        "title": "Max leads delivered",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Cap 3: maximum scored leads returned in the report (highest score first).",
                        "default": 100
                    },
                    "secUserAgent": {
                        "title": "SEC User-Agent (contact)",
                        "type": "string",
                        "description": "Descriptive User-Agent with a real contact, e.g. 'YourCo FundingLeads/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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
