# ICP Fit Score (`david15999/company-icp-fit`) Actor

Describe your ideal customer once and get a 1-10 fit score for every company domain, with the action (work it, maybe, skip) and the reason, judged from the company's own description. Ready for Clay.

- **URL**: https://apify.com/david15999/company-icp-fit.md
- **Developed by:** [David Emanuel Moreira](https://apify.com/david15999) (community)
- **Categories:** Lead generation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.00 / 1,000 company scoreds

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

## ICP Fit Score

Describe your ideal customer once, in plain words. Send a list of company domains. Every company
comes back with a **1-10 fit score**, an **action** (work it, maybe, skip) and **the reason** in one
sentence, so you know which rows of your Clay table deserve a sequence and which to drop.

### How it judges

Each company is judged ONLY from its own description (our company profile, or its homepage when we
have none) plus the facts we hold: industry, headcount, revenue range, headquarters, technologies.
It never guesses from what a model "remembers" about a company. A company we cannot judge comes
back as `Unknown` and is not charged.

| Score | Action |
| --- | --- |
| 7-10 | Work it |
| 4-6 | Maybe |
| 1-3 | Skip |

Write the ICP the way you would brief a new SDR: "Mid-size and large companies (500+ employees) in
financial services or healthcare that run workloads in AWS or Azure. Not consulting firms."
Exclusions are applied literally.

### Output

One row per domain: `fit_score`, `action`, `reason`, `evidence` (a quote or fact the score rests
on), `source` (profile or homepage).

### Pricing

| Event | Price | When |
| --- | --- | --- |
| `company-scored` | USD 0.01 (USD 10 per 1,000) | Per company that got a score |

`Unknown` domains and domains that failed are free. The run never scores more domains than your
maximum charge allows. Example: 1,000 domains, 950 scored = USD 9.50.

### Input

| Field | Notes |
| --- | --- |
| `icp` | Your ideal customer, in a sentence or two |
| `domains` | Domains, website URLs or work emails |

### Related

**In-Market Timing Score** tells you which of your fitting accounts to contact now, and
**B2B Company Firmographics by Domain** returns the company data itself.

### Data and privacy

Company-level data only. No personal data is returned. Your ICP text is used for the run and not
stored.

### FAQ

**How do I describe my ICP?**
In a sentence or two: industry, size, region, technology, situation, and who to exclude. Plain language works best.

**How much does it cost?**
USD 10 per 1,000 companies scored. Unknown domains and failed lookups are free.

**Is my ICP stored?**
No. The ICP text is used for the run and not stored.

### More Compass actors

- [B2B Company Firmographics by Domain](https://apify.com/david15999/b2b-company-firmographics): industry, size, revenue, NAICS, tech stack and funding for a list of domains
- [Security and AI Buying Signals](https://apify.com/david15999/b2b-company-signals): dated breach, hiring, 10-K/8-K and AI adoption signals per company
- [Company News Research](https://apify.com/david15999/company-news-research): live search for funding, leadership, M\&A and expansion news on any domain
- [In-Market Timing Score](https://apify.com/david15999/company-timing-score): contact now, nurture or wait, with the dated trigger behind it
- [Competitor Post Engagers](https://apify.com/david15999/competitor-engagers): people engaging with your competitors on LinkedIn, with verified work emails
- [Competitor Install Base](https://apify.com/david15999/competitor-install-base): companies that publicly use a competitor product, with the proof
- [Champion Job-Change Tracker](https://apify.com/david15999/champion-job-change): people from your customer accounts who moved to a new company
- [New-Hire Radar](https://apify.com/david15999/new-hire-radar): decision-makers in their first 6 months at companies like your customers
- [B2B Audience Behavioral Profile](https://apify.com/david15999/audience-profile): the themes, pains and voices your buyers follow, in one report

# Actor input Schema

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

Describe the companies you sell to in a sentence or two: industry, size, region, technology, situation, and who to exclude.

## `domains` (type: `array`):

Company domains to score (acme.com). Website URLs and work emails are accepted too: the domain is extracted.

## Actor input object example

```json
{
  "icp": "Large companies (1,000+ employees) in insurance, financial services, health care or retail, based in the United States. Not consulting firms or software vendors.",
  "domains": [
    "chubb.com",
    "albertsons.com"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

One row per result 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": "Large companies (1,000+ employees) in insurance, financial services, health care or retail, based in the United States. Not consulting firms or software vendors.",
    "domains": [
        "chubb.com",
        "albertsons.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("david15999/company-icp-fit").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": "Large companies (1,000+ employees) in insurance, financial services, health care or retail, based in the United States. Not consulting firms or software vendors.",
    "domains": [
        "chubb.com",
        "albertsons.com",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("david15999/company-icp-fit").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": "Large companies (1,000+ employees) in insurance, financial services, health care or retail, based in the United States. Not consulting firms or software vendors.",
  "domains": [
    "chubb.com",
    "albertsons.com"
  ]
}' |
apify call david15999/company-icp-fit --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,david15999/company-icp-fit"
        }
    }
}
```

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/12ZToRVhoyRG153SW/builds/6IJ1Fk4dUgA1ah5Fo/openapi.json