# Enrich-CRM — Company Firmographic (`enrich-crm/enrich-crm-firmographic`) Actor

Get firmographic data for any company: headcount, industry, founding year, HQ location, and more from any input: company name, domain, linkedin url, sales nav...

- **URL**: https://apify.com/enrich-crm/enrich-crm-firmographic.md
- **Developed by:** [Enrich-CRM](https://apify.com/enrich-crm) (community)
- **Categories:** Lead generation, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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

## 🏢 Enrich-CRM — Company Firmographic

**Get complete firmographic data for any company: headcount, industry, HQ location, founding year, and more.**

Powered by [Enrich-CRM](https://enrich-crm.com) · Real-time data · No cached profiles · <1s response · GDPR compliant · EU servers

---

### What does this Actor do?

Retrieve structured firmographic data for any company using its domain, name, or LinkedIn URL. Returns headcount, industry, founding year, headquarters, company type, description, and social links — ideal for ICP scoring and account-based sales.

### Use cases

- Score accounts by headcount and industry before outreach
- Enrich newly created CRM accounts with structured firmographic data
- Filter target account lists by company size and geography

---

### Input parameters

> **Waterfall logic:** provide more identifiers to increase accuracy. The API tries them in order until a confident match is found.

| Parameter | Description | Example |
|-----------|-------------|---------|
| `apiId` | *(Optional)* Your Enrich-CRM API key. Leave empty to use the built-in key (Apify fees apply). | `YOUR_KEY` |
| `items` | *(Optional)* JSON array for batch mode — see below. | `[{"email": "..."}]` |
| `domain` | Company domain. **Primary identifier.** | `enrich-crm.com` |
| `companyName` | Legal company name. | `Enrich CRM` |
| `companyLinkedinUrl` | Company LinkedIn page URL. | `https://www.linkedin.com/company/enrich-crm/` |
| `companyLinkedinSalesNavUrl` | Company Sales Navigator URL. | `https://www.linkedin.com/sales/company/105261719` |
| `companyLinkedinId` | Numerical LinkedIn company ID. | `105261719` |
| `companyLinkedinSalesNavId` | Numerical Sales Navigator company ID. | `105261719` |

#### Single-item example

```json
{
  "domain": "notion.so"
}
````

#### Batch mode example

Pass an `items` array to enrich multiple records in one run:

```json
{
  "items": [
    {
      "domain": "notion.so"
    },
    {
      "domain": "notion.so"
    }
  ]
}
```

Results are saved to the Actor's default dataset — one row per input item.

***

### Response fields

| Field | Type | Description |
|-------|------|-------------|
| `_success` | boolean | `true` if a result was found |
| `_input` | object | The input parameters sent for this item |
| `companyName` | string | Legal company name |
| `domain` | string | Primary domain |
| `description` | string | Company description |
| `industry` | string | Industry vertical |
| `subIndustry` | string | Sub-industry |
| `headcount` | integer | Total number of employees |
| `headcountRange` | string | Headcount range (e.g. '51-200') |
| `foundedYear` | integer | Year the company was founded |
| `hqCountry` | string | HQ country |
| `hqCity` | string | HQ city |
| `hqState` | string | HQ state / region |
| `hqAddress` | string | Full HQ address |
| `companyType` | string | Public / Private / Nonprofit |
| `stockSymbol` | string | Stock ticker symbol (if public) |
| `linkedinUrl` | string | LinkedIn company page URL |
| `twitterUrl` | string | Twitter/X URL |
| `websiteUrl` | string | Official website URL |

***

### Pricing

| Model | Cost |
|-------|------|
| First 10 calls per actor | **Free** — no credit card required |
| Additional results | **$0.03 per result** (charged only when data is found) |
| Bring Your Own Key (BYOK) | Provide your `apiId` → billed directly by Enrich-CRM (1 credit = 1 result found) |

> A "result" means the API returned a non-empty profile. If no data is found for an input, no credit or Apify charge applies.

***

### All Enrich-CRM Actors

- [👤 Enrich-CRM — Enrich Contact](https://apify.com/sylvain-enrich-crm/enrich-crm-enrich-contact)
- [🔍 Enrich-CRM — Reverse Email](https://apify.com/sylvain-enrich-crm/enrich-crm-reverse-email)
- [✉️ Enrich-CRM — Find Email](https://apify.com/sylvain-enrich-crm/enrich-crm-find-email)
- [🏢 Enrich-CRM — Company Firmographic](https://apify.com/sylvain-enrich-crm/enrich-crm-firmographic)
- [💰 Enrich-CRM — Company Financial Data](https://apify.com/sylvain-enrich-crm/enrich-crm-funding)
- [🇫🇷 Enrich-CRM — French SIREN Number Finder](https://apify.com/sylvain-enrich-crm/enrich-crm-siren-finder)
- [📋 Enrich-CRM — French SIRENE Data](https://apify.com/sylvain-enrich-crm/enrich-crm-french-siren)
- [🛠 Enrich-CRM — Website Tech Stack](https://apify.com/sylvain-enrich-crm/enrich-crm-tech-stack)
- [📊 Enrich-CRM — Monthly Website Traffic](https://apify.com/sylvain-enrich-crm/enrich-crm-website-traffic)
- [🌐 Enrich-CRM — Homepage Content](https://apify.com/sylvain-enrich-crm/enrich-crm-homepage-content)

***

### Links

- [Enrich-CRM website](https://enrich-crm.com)
- [API documentation](https://enrich-crm.readme.io/reference/enrichcontactv4)
- [Get a free API key](https://app.enrich-crm.com)

# Actor input Schema

## `apiId` (type: `string`):

Your own Enrich-CRM API key. If provided, your credits are used (BYOK). If left empty, the built-in key is used and Apify usage fees apply. Get a free key at https://app.enrich-crm.com.

## `items` (type: `array`):

Batch mode: JSON array of records to enrich. Each object should contain the relevant input fields for this endpoint. Leave empty to use the single-item fields below.

## `domain` (type: `string`):

Company domain without protocol, e.g. 'acme.com'.

## `companyName` (type: `string`):

Full legal name of the company.

## `companyLinkedinUrl` (type: `string`):

Company LinkedIn page URL, e.g. https://www.linkedin.com/company/enrich-crm/

## `companyLinkedinSalesNavUrl` (type: `string`):

Company Sales Navigator URL.

## `companyLinkedinId` (type: `string`):

Numerical LinkedIn company ID.

## `companyLinkedinSalesNavId` (type: `string`):

Numerical Sales Navigator company ID.

## Actor input object example

```json
{
  "items": []
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("enrich-crm/enrich-crm-firmographic").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("enrich-crm/enrich-crm-firmographic").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 '{}' |
apify call enrich-crm/enrich-crm-firmographic --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Enrich-CRM — Company Firmographic",
        "description": "Get firmographic data for any company: headcount, industry, founding year, HQ location, and more from any input: company name, domain, linkedin url, sales nav...",
        "version": "1.0",
        "x-build-id": "Rrf2m6rwBHLboExcY"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/enrich-crm~enrich-crm-firmographic/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-enrich-crm-enrich-crm-firmographic",
                "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/enrich-crm~enrich-crm-firmographic/runs": {
            "post": {
                "operationId": "runs-sync-enrich-crm-enrich-crm-firmographic",
                "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/enrich-crm~enrich-crm-firmographic/run-sync": {
            "post": {
                "operationId": "run-sync-enrich-crm-enrich-crm-firmographic",
                "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": {
                    "apiId": {
                        "title": "Enrich-CRM API Key (optional)",
                        "type": "string",
                        "description": "Your own Enrich-CRM API key. If provided, your credits are used (BYOK). If left empty, the built-in key is used and Apify usage fees apply. Get a free key at https://app.enrich-crm.com."
                    },
                    "items": {
                        "title": "Items — Batch Mode",
                        "type": "array",
                        "description": "Batch mode: JSON array of records to enrich. Each object should contain the relevant input fields for this endpoint. Leave empty to use the single-item fields below.",
                        "default": []
                    },
                    "domain": {
                        "title": "Domain",
                        "type": "string",
                        "description": "Company domain without protocol, e.g. 'acme.com'."
                    },
                    "companyName": {
                        "title": "Company Name",
                        "type": "string",
                        "description": "Full legal name of the company."
                    },
                    "companyLinkedinUrl": {
                        "title": "Company LinkedIn URL",
                        "type": "string",
                        "description": "Company LinkedIn page URL, e.g. https://www.linkedin.com/company/enrich-crm/"
                    },
                    "companyLinkedinSalesNavUrl": {
                        "title": "Company Sales Navigator URL",
                        "type": "string",
                        "description": "Company Sales Navigator URL."
                    },
                    "companyLinkedinId": {
                        "title": "Company LinkedIn ID",
                        "type": "string",
                        "description": "Numerical LinkedIn company ID."
                    },
                    "companyLinkedinSalesNavId": {
                        "title": "Company Sales Navigator ID",
                        "type": "string",
                        "description": "Numerical Sales Navigator company ID."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
