<!-- BusyBot node reference — https://busybot.net/tools/clearbit/ -->

> Node: Clearbit (`clearbit`) · Action · v1
> Category: Sales · Credentials: Clearbit API (`clearbitApi`)
> Updated: 2026-08-16

# Clearbit

> Enrich company and person data for sales intelligence and lead scoring.

## Overview

Clearbit is a data enrichment service. This tool supports three operations: (1) Person Enrich — look up social and professional information by email address, (2) Company Enrich — look up detailed company data by domain, and (3) Company Autocomplete — auto-complete company names and get domain/logo.

**Category:** Sales  
**Tool Name:** `clearbit`  
**Version:** 1

**Appearance:** Icon: `lucide-Search` | Color: `#4DA6FF`

## Node Type

**Action** — processes input items and produces output

## Input / Output

| Direction | Port(s) |
|-----------|--------|
| Input | `Input` |
| Output | `Output`, `Error` |

## Credentials

This tool requires **Clearbit API** credentials.
See the [Credentials Guide](https://busybot.net/credentials/clearbit-api/) for setup instructions.

### Resources

| Resource | Value |
|----------|-------|
| Company | `company` |
| Person | `person` |

### Operations

Which operations are available depends on the selected resource — see the parameter subsections below.

| Operation | Value | Description |
|-----------|-------|-------------|
| Autocomplete | `autocomplete` | Auto-complete company names and retrieve logo and domain. |
| Enrich | `enrich` | Look up person and company data based on an email or domain. |

### Parameters

#### Company: Enrich

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Domain | `string` | Yes | — | The domain to look up. |
| Additional Fields | `collection` | No | `{}` | Extra hints sent with the lookup to improve the match. |
| — Company Name | `string` | No | — | The name of the company. |
| — Facebook | `string` | No | — | The Facebook URL for the company. |
| — LinkedIn | `string` | No | — | The LinkedIn URL for the company. |
| — Twitter | `string` | No | — | The Twitter handle for the company. |

#### Company: Autocomplete

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Name | `string` | Yes | — | The partial name of the company to search for. |

#### Person: Enrich

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Email | `string` | Yes | — | The email address to look up. |
| Additional Fields | `collection` | No | `{}` | Extra hints sent with the lookup to improve the match. |
| — Company | `string` | No | — | The name of the person's employer. |
| — Company Domain | `string` | No | — | The domain for the person's employer. |
| — Facebook | `string` | No | — | The Facebook URL for the person. |
| — Family Name | `string` | No | — | Last name of person. Passing this is strongly recommended to improve match rates. |
| — Given Name | `string` | No | — | First name of person. |
| — IP Address | `string` | No | — | IP address of the person. Passing this is strongly recommended to improve match rates. |
| — LinkedIn | `string` | No | — | The LinkedIn URL for the person. |
| — Location | `string` | No | — | The city or country where the person resides. |
| — Twitter | `string` | No | — | The Twitter handle for the person. |

#### All Operations

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Max Concurrency | `number` | No | `10` | Maximum number of items to process concurrently. |

## Output Data

Clearbit's response is **merged onto the input item's JSON** — your existing fields survive and the enrichment fields are added alongside them, overwriting any key of the same name. Binary data on the input item is forwarded.

| Operation | Output items per input item |
|-----------|-----------------------------|
| `company` / `enrich` | One — the company record merged onto the item. |
| `person` / `enrich` | One — the person record merged onto the item. |
| `company` / `autocomplete` | **One per suggestion**, so a single input item fans out into several. |

An autocomplete lookup that matched nothing still produces one item, carrying your original JSON plus a marker:

```json
{
  "_noResults": true
}
```

Test for `{{ $json._noResults }}` before treating an autocomplete branch as a hit. The two enrich operations have no such marker — an empty response simply leaves the item as it arrived, so check for a field you expect (for example `{{ $json.name }}`) instead.

The enrichment fields themselves are whatever Clearbit returns for the lookup; the node does not rename, nest or filter them. Reference them downstream by expression, e.g. `{{ $json.domain }}`.

## Usage Examples

- Look up company information by domain
- Enrich a lead with person data by email address
- Auto-complete company names for a search interface
- Get company metrics and social profiles from a domain
- Find a person's employment and social data by email

## Example Configuration

Enrich a company from a domain on the item:

```json
{
  "type": "clearbit",
  "parameters": {
    "resource": "company",
    "operation": "enrich",
    "domain": "{{ $json.domain }}"
  }
}
```

Give the company lookup extra hints to improve the match:

```json
{
  "type": "clearbit",
  "parameters": {
    "resource": "company",
    "operation": "enrich",
    "domain": "{{ $json.website }}",
    "additionalFields": {
      "companyName": "{{ $json.company }}",
      "linkedin": "{{ $json.linkedinUrl }}",
      "twitter": "{{ $json.twitterHandle }}"
    }
  }
}
```

Suggest companies from a partial name typed by a user:

```json
{
  "type": "clearbit",
  "parameters": {
    "resource": "company",
    "operation": "autocomplete",
    "name": "{{ $json.query }}"
  }
}
```

Enrich a lead by email, passing name and location to raise the match rate:

```json
{
  "type": "clearbit",
  "parameters": {
    "resource": "person",
    "operation": "enrich",
    "email": "{{ $json.email }}",
    "additionalFields": {
      "givenName": "{{ $json.firstName }}",
      "familyName": "{{ $json.lastName }}",
      "company": "{{ $json.company }}",
      "companyDomain": "{{ $json.domain }}",
      "location": "{{ $json.city }}"
    },
    "maxConcurrency": 5
  }
}
```

### Error Handling

| Mode | Behavior |
|------|----------|
| **stop** | Halts workflow on first error |
| **continue** | Skips failed items, passes successful ones through |
| **errorPort** | Routes failed items to Error output port |

## Tips

Enrich company and person data using the Clearbit API — look up companies by domain, people by email, or auto-complete company names.

### Parameter Dependencies

- `operation` options depend on the selected `resource`
- `domain` is only required for company enrichment
- `name` is only required for company autocomplete
- `email` is only required for person enrichment
- `additionalFields` structure varies by resource type
- All conditional parameters are hidden unless their display conditions are met