# B2B Lead List Builder — ICP to Company List (AI) (`noniner/b2b-lead-list-builder`) Actor

Describe your ICP in plain English and get a ranked company list. Give it an ICP description; get back matching companies with domains, firmographics and fit scores.

- **URL**: https://apify.com/noniner/b2b-lead-list-builder.md
- **Developed by:** [Fredrik Hansson](https://apify.com/noniner) (community)
- **Categories:** Lead generation, AI, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $44.00 / 1,000 company founds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## B2B Lead List Builder — ICP to Company List (AI)

> **⚑ Beta — rounding off the last nine.** This Actor is live and fully usable today; a polished v1 is due **October 28, 2026**. Current rough edge: company discovery can still surface the occasional industry directory alongside real companies — the relevance filter is being tightened.

**Describe your ideal customer in plain English; get back a ranked list of real companies that match — with their domains.** You don't write search queries, scrape SERPs, or clean URLs. The AI reads your ICP, runs the right searches, finds real company websites, throws out the aggregators and directories, dedupes what's left, and (optionally) enriches and fit-scores every company so your best prospects are at the top.

Prospecting list building on autopilot.

***

### The flow

```
   Your ICP            AI search             Google SERP           Clean &            Enrich &            Ranked
  (plain text)   →     queries         →     (organic)       →     dedupe        →    fit-score     →     lead list
  industry, size,      6-10 diverse          real company          drop socials/      name, industry,     best fit
  geo, keywords        queries               sites                 directories        ICP score           on top
```

1. **You describe your ideal customer** — industry, company size, geography, keywords.
2. **The AI writes 6–10 diverse Google searches** designed to surface *company websites* (a mix of "<niche> companies in <geo>", "<industry> vendors", "best <category> software", and directory/listicle queries).
3. **It runs those searches** through the public [`apify/google-search-scraper`](https://apify.com/apify/google-search-scraper) and collects the organic result URLs.
4. **It cleans the results** — reduces URLs to registrable domains, drops Google / YouTube / Wikipedia / LinkedIn / Facebook / Crunchbase / G2 / Capterra / Clutch / Trustpilot / Yelp / directories / gov / edu, and dedupes.
5. **Optionally enriches + fit-scores** each company via [`noniner/ai-company-enrichment`](https://apify.com/noniner/ai-company-enrichment), then ranks the list by ICP fit.

***

### What you get

For every company in the final list:

1. **`domain`** — the clean, registrable company domain (e.g. `glossier.com`), deduped and filtered so you never get a Wikipedia page or a LinkedIn profile.
2. **`website`** — the `https://` URL, ready to click or feed into the next tool.
3. **`name`, `industry`, `description`** — firmographics, when enrichment is on.
4. **`icpFitScore` (0–100) + `icpReason`** — how good a prospect this company is for *what you sell*, with a one-sentence reason, when you provide an offering.
5. **`sourceQuery`** — the search the company was first found via, so you can see *why* it's on the list.
6. **`rank`** — its position in the final ranked list (best fit first when scored).

***

### Three ways people use it

- **Prospecting list building** — type your ICP, get a ready-to-work list of target companies with domains. No more hand-building spreadsheets from Google. "Find companies that match my ICP" in one run.
- **ABM target lists** — build an account-based-marketing target account list for a specific segment (industry + size + geography), fit-scored against your offer so sales attacks the best accounts first.
- **TAM / market mapping** — map the companies in a niche or category for market research, competitive landscaping, or sizing a total addressable market — a fast, cheap first pass at who's out there.

Great for **lead generation**, **sales prospecting**, **outbound list building** and **demand generation** teams who want targeted company lists without a seat on an expensive database.

***

### Input

| Field | Type | Notes |
|---|---|---|
| `icp` | string | **Required.** Your ideal customer in plain English: industry, size, geography, keywords. The more specific, the better the matches. |
| `offering` | string | Optional. What you sell — turns on the ICP fit score (0–100) + reason, and ranks the list by fit. |
| `maxCompanies` | integer | Cap the final list size. Default `50`, max `500`. One charge per company returned. |
| `country` | string | SERP country code (lowercase 2-letter). Default `us`. |
| `languageCode` | string | SERP language code. Default `en`. |
| `enrich` | boolean | Default `true`. Enrich + fit-score each company. Turn off for a faster, cheaper domains-only list. |
| `model` | string | Override the OpenAI model used to turn your ICP into searches. Default `gpt-4o-mini`. |

#### Minimal input example

```json
{
  "icp": "Mid-sized Shopify ecommerce brands in the US selling skincare or cosmetics",
  "offering": "We sell a subscription-billing and retention app for Shopify stores",
  "maxCompanies": 25
}
```

***

### Output example

```json
{
  "domain": "glossier.com",
  "website": "https://glossier.com",
  "name": "Glossier",
  "industry": "Beauty & Cosmetics (DTC ecommerce)",
  "description": "A direct-to-consumer skincare and makeup brand selling online and in a few retail stores.",
  "icpFitScore": 88,
  "icpReason": "A US DTC skincare/cosmetics brand on a modern ecommerce stack — a strong fit for a Shopify retention and subscription-billing app.",
  "sourceQuery": "best skincare ecommerce brands in the US",
  "rank": 1
}
```

When `enrich` is off (or a company couldn't be enriched), `name` / `industry` / `description` / `icpFitScore` / `icpReason` come back `null` and the list keeps the order it was discovered in.

***

### How it works

Under the hood this Actor orchestrates two proven building blocks so you don't have to:

- **Search** — [`apify/google-search-scraper`](https://apify.com/apify/google-search-scraper) runs the AI-generated queries and returns organic Google results.
- **Enrichment + fit** — [`noniner/ai-company-enrichment`](https://apify.com/noniner/ai-company-enrichment) turns each surviving domain into a firmographic profile and scores it against your offering.

The ICP-to-queries step and the final ranking are powered by OpenAI (`gpt-4o-mini` by default, with `json_schema` strict output). The Actor logs the queries it generated, how many raw results came back, how many survived filtering, how many enriched, and its estimated OpenAI cost at the end of every run.

***

### Pay-per-event pricing

| Event | Price | Charged when |
|---|---|---|
| `company-found` | $0.10 | Once per matching company added to the final lead list (found from your ICP, and optionally enriched + fit-scored). |

You're only charged for companies that actually make the final list — not for raw search results or discarded aggregator URLs.

***

### Setup

The AI steps call the OpenAI API. Set the environment variable / secret **`OPENAI_API_KEY`** on the Actor. Without it the Actor can't turn your ICP into searches and won't run.

***

### Use it from an AI agent (Apify MCP server)

This Actor is available through the [Apify MCP server](https://mcp.apify.com), so AI agents (Claude, ChatGPT, or anything that speaks MCP) can call it as a tool — hand it an `icp` (and optionally what you sell), and read back a ranked list of matching companies — with no custom integration code.

***

### Run it locally

```bash
npm install
## put your input in storage/key_value_stores/default/INPUT.json
export OPENAI_API_KEY=sk-...   # required
apify run -p
```

***

### A note on data (be honest)

This Actor **discovers public company websites** — it is not a private lead database. Discovery quality depends on Google's SERP coverage for your ICP: the clearer and more specific your ICP, the better the list. It finds real, publicly reachable company sites and filters out aggregators, directories and social profiles, but it won't surface stealth companies or anything Google doesn't rank for your searches. Use it as a fast, targeted first pass at *who's out there* for a segment.

### Chain it

**This Actor is a building block in the No Niner B2B suite.** Wire it to the next step with no code in the **Integrations** tab (trigger: *Run succeeded* → start the next Actor), or run them in sequence. This is the start of the outbound funnel:

- ⬇️ Then [B2B CRM Enricher](https://apify.com/noniner/b2b-crm-enricher) — dedupe + enrich the list (wire via `datasetId` in the Integrations tab).
- ⬇️ Then [B2B Intent Radar](https://apify.com/noniner/b2b-intent-radar) — prioritize who's in-market.
- ⬇️ Then [B2B Account Brief](https://apify.com/noniner/b2b-account-brief) → [B2B Cold Email Sequence Writer](https://apify.com/noniner/b2b-cold-outreach-sequencer) — brief and write the outreach.

***

### Related actors

- [AI Company Enrichment](https://apify.com/noniner/ai-company-enrichment) — Turn a list of domains into structured company profiles — firmographics, contacts, socials and ICP fit.
- [B2B Intent Radar](https://apify.com/noniner/b2b-intent-radar) — Surface companies showing buying signals so you reach out at the right moment.
- [B2B Account Brief](https://apify.com/noniner/b2b-account-brief) — Give target company domains + what you sell; get a polished one-page AI pre-call sales brief per company.
- [Google Maps Lead Enricher (AI)](https://apify.com/noniner/gmaps-lead-enricher) — Turn a Google Maps scrape into sales-ready leads: emails, socials, web signals, score and a personalised opener.

***

Built by the No Niner team.

# Actor input Schema

## `icp` (type: `string`):

Describe your ideal customer: industry, company size, geography and keywords. The more specific, the better the matches. Example: "Mid-sized Shopify ecommerce brands in the US selling skincare or cosmetics".

## `offering` (type: `string`):

Describe what your company sells. If set, each company gets an ICP fit score (0-100) and a reason, and the list is ranked by fit.

## `maxCompanies` (type: `integer`):

Maximum companies in the final list. One pay-per-event charge per company returned. Start small; increase for larger lists.

## `country` (type: `string`):

Country code for the Google search (lowercase 2-letter, e.g. "us", "gb", "de").

## `languageCode` (type: `string`):

Language code for the Google search (e.g. "en", "de", "sv").

## `enrich` (type: `boolean`):

Enrich each company (name, industry, description) and score ICP fit via noniner/ai-company-enrichment, then rank by fit. Turn off for a faster, cheaper domains-only list.

## `model` (type: `string`):

Override the model used to turn your ICP into searches (default gpt-4o-mini).

## Actor input object example

```json
{
  "icp": "Mid-sized Shopify ecommerce brands in the US selling skincare or cosmetics",
  "maxCompanies": 5,
  "country": "us",
  "languageCode": "en",
  "enrich": true
}
```

# Actor output Schema

## `companies` (type: `string`):

The ranked lead list in the default dataset.

# 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 = {
    "icp": "Mid-sized Shopify ecommerce brands in the US selling skincare or cosmetics",
    "maxCompanies": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("noniner/b2b-lead-list-builder").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 = {
    "icp": "Mid-sized Shopify ecommerce brands in the US selling skincare or cosmetics",
    "maxCompanies": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("noniner/b2b-lead-list-builder").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "icp": "Mid-sized Shopify ecommerce brands in the US selling skincare or cosmetics",
  "maxCompanies": 5
}' |
apify call noniner/b2b-lead-list-builder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,noniner/b2b-lead-list-builder"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/niidmEJybpeE14Bjo/builds/ZfIHKzaMOV5LhQPjN/openapi.json
