Clearbit
Enrich emails and domains with company and person data via the Clearbit API.
Given an email, Clearbit returns a rich person profile (name, role, location, employment, social handles) and/or the company behind the email's domain. Given a domain, it returns a full company profile (industry, headcount, funding, tech stack, location). It can also resolve a free-text company name to its primary web domain and logo.
This is a read-only enrichment tool — it never writes to Clearbit.
Operations
| operation | Endpoint | Required input | Returns |
|---|---|---|---|
person_enrich |
GET person.clearbit.com/v2/people/find?email= |
email |
Person profile for the email |
company_enrich |
GET company.clearbit.com/v2/companies/find?domain= |
domain |
Company profile for the domain |
combined_enrich |
GET person.clearbit.com/v2/combined/find?email= |
email |
Person + company profile in one call |
name_to_domain |
GET company.clearbit.com/v1/domains/find?name= |
name |
Best-match domain + logo for a company name |
Inputs
| Name | Required | Default | Description |
|---|---|---|---|
apiKey |
yes | — | Your Clearbit API key |
operation |
yes | — | One of the operations above |
email |
for person/combined | "" |
Email address to enrich |
domain |
for company | "" |
Company domain (e.g. stripe.com) |
name |
for name_to_domain | "" |
Company name to resolve |
Outputs
| Name | Description |
|---|---|
result |
The raw Clearbit JSON response, as a string |
status |
HTTP status code (200 on success; 202 while Clearbit is still looking up an async result; 404 when nothing is found) |
API key setup
- Sign in to the Clearbit dashboard.
- Open the API section and copy your secret API key.
- Pass it to the tool as
apiKey.
Authentication is HTTP Bearer: the key is sent as
Authorization: Bearer <apiKey>. (Clearbit also accepts HTTP Basic with the
key as the username and a blank password; this tool uses Bearer because a
single key encodes it directly.)
Examples
Enrich a person by email:
operation = person_enrich
email = [email protected]
Enrich a company by domain:
operation = company_enrich
domain = stripe.com
Combined person + company in one call:
operation = combined_enrich
email = [email protected]
Resolve a company name to its domain:
operation = name_to_domain
name = Stripe
Notes
- A
202status means Clearbit accepted the request but the lookup is still running asynchronously — retry shortly to get the populated record. - A
404means Clearbit has no record for that email/domain/name. - Response bodies are capped at 5 MB.