sales-clearbit

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Clearbit Platform Help

Clearbit平台帮助

Help the user with Clearbit platform questions — Person and Company Enrichment, Reveal IP intelligence, Prospector contact search, Name to Domain, Form Shortening, Risk API, Breeze Intelligence (HubSpot), and API integration.

Important context: Clearbit was acquired by HubSpot in December 2023 and rebranded as Breeze Intelligence within HubSpot. The standalone API still works, but product investment has shifted to HubSpot. Non-HubSpot users can still use the API directly; HubSpot users get Breeze Intelligence as an add-on.

为用户解答Clearbit平台相关问题 — Person and Company Enrichment、Reveal IP智能、Prospector联系人搜索、名称转域名、表单缩短、Risk API、Breeze Intelligence（HubSpot）以及API集成。

重要背景：Clearbit于2023年12月被HubSpot收购，在HubSpot生态内更名为Breeze Intelligence。独立API仍可正常使用，但产品研发投入已转向HubSpot。非HubSpot用户仍可直接使用API；HubSpot用户可通过增值服务购买使用Breeze Intelligence。

Step 1 — Gather context

步骤1 — 收集上下文信息

What area of Clearbit do you need help with?

a) Person Enrichment — look up a person by email
b) Company Enrichment — look up a company by domain
c) Reveal — identify companies visiting your website by IP
d) Prospector — find contacts at a target company
e) Name to Domain — resolve company name to website domain
f) Form Shortening — auto-populate form fields from email
g) Risk API — fraud scoring for signups
h) Breeze Intelligence — HubSpot-integrated enrichment
i) API setup and integration
j) Something else

What's your CRM/stack?

a) HubSpot (Breeze Intelligence available)
b) Salesforce
c) Other CRM (Pipedrive, Close, etc.)
d) Custom app / API-only
e) Not sure

What's your goal?

a) Enrich existing CRM records with firmographic/demographic data
b) Identify anonymous website visitors
c) Score and route leads in real-time
d) Shorten forms to improve conversion
e) Build prospect lists by role/company
f) Integrate Clearbit data into my app via API

你需要Clearbit哪个功能模块的帮助？

a) Person Enrichment — 通过邮箱查询个人信息
b) Company Enrichment — 通过域名查询企业信息
c) Reveal — 通过IP识别访问你网站的企业
d) Prospector — 查找目标企业的联系人
e) 名称转域名 — 将企业名称解析为官网域名
f) 表单缩短 — 通过邮箱自动填充表单字段
g) Risk API — 注册行为欺诈评分
h) Breeze Intelligence — 集成在HubSpot内的信息补全服务
i) API设置与集成
j) 其他问题

你使用的CRM/技术栈是什么？

a) HubSpot（可使用Breeze Intelligence）
b) Salesforce
c) 其他CRM（Pipedrive、Close等）
d) 自定义应用/仅使用API
e) 不确定

你的目标是什么？

a) 用企业/人口属性数据丰富现有CRM记录
b) 识别匿名网站访客
c) 实时对线索进行评分和分配
d) 缩短表单长度提升转化率
e) 按角色/企业搭建潜客列表
f) 通过API将Clearbit数据集成到我的应用中

Step 2 — Route or answer directly

步骤2 — 路由或直接解答

If the question is about enrichment strategy across tools (not Clearbit-specific), route to

/sales-enrich

. If the question is about intent signals and visitor identification strategy, route to

/sales-intent

. If the question is about building prospect lists across tools, route to

/sales-prospect-list

. If the question is about lead scoring model design, route to

/sales-lead-score

. If the question is about CRM data quality and dedup, route to

/sales-data-hygiene

. If the question is about connecting Clearbit to other tools, route to

/sales-integration

Otherwise, answer directly using the reference below.

如果问题是关于跨工具的信息补全策略（非Clearbit专属），请路由到

/sales-enrich

。如果问题是关于意图信号和访客识别策略，请路由到

/sales-intent

。如果问题是关于跨工具搭建潜客列表，请路由到

/sales-prospect-list

。如果问题是关于线索评分模型设计，请路由到

/sales-lead-score

。如果问题是关于CRM数据质量与去重，请路由到

/sales-data-hygiene

。如果问题是关于Clearbit与其他工具的连接，请路由到

/sales-integration

。

否则，请使用下方参考内容直接解答。

Step 3 — Clearbit platform reference

步骤3 — Clearbit平台参考

Data model

数据模型

Entity	Key	Attributes	Source
Person	email	name, title, role, seniority, company, employment history, social profiles (LinkedIn, Twitter, GitHub), location, bio, avatar, time zone	Person API
Company	domain	name, legal name, industry (SIC/NAICS/GICS), sector, sub-industry, employee count, revenue range, funding (raised, stage), tech stack, type (private/public/nonprofit), location (HQ + geo), logo, social profiles, phone, description, founded year, parent company	Company API
Reveal	IP address	company match (domain, name, industry, employee count, revenue, location, tech stack), confidence score	Reveal API
Prospect	domain + filters	name, email, title, role, seniority, verified status	Prospector API

实体	键	属性	来源
个人	email	姓名、职位、角色、层级、所属企业、雇佣历史、社交档案（LinkedIn、Twitter、GitHub）、位置、个人简介、头像、时区	Person API
企业	domain	名称、法定名称、行业（SIC/NAICS/GICS）、赛道、子行业、员工数、营收区间、融资情况（融资额、阶段）、技术栈、企业类型（私有/公有/非盈利）、位置（总部+地理范围）、Logo、社交档案、电话、企业简介、成立年份、母公司	Company API
Reveal	IP address	匹配企业（域名、名称、行业、员工数、营收、位置、技术栈）、置信度评分	Reveal API
潜客	domain + 筛选条件	姓名、邮箱、职位、角色、层级、验证状态	Prospector API

Person Enrichment

Look up a person by email to get 80+ attributes:

GET https://person.clearbit.com/v2/people/find?email={email}

Streaming (holds connection up to 60s instead of 202 queue):

GET https://person-stream.clearbit.com/v2/people/find?email={email}

Key attributes returned:

name.fullName

name.givenName

name.familyName

employment.title

employment.role

employment.seniority

employment.company

employment.domain

geo.city

geo.state

geo.country

linkedin.handle

twitter.handle

github.handle

avatar

bio

timeZone

通过邮箱查询个人信息，可获取80+属性：

GET https://person.clearbit.com/v2/people/find?email={email}

流式查询（最长保持60秒连接，无需使用202状态队列）：

GET https://person-stream.clearbit.com/v2/people/find?email={email}

返回核心属性：

name.fullName

name.givenName

name.familyName

employment.title

employment.role

employment.seniority

employment.company

employment.domain

geo.city

geo.state

geo.country

linkedin.handle

twitter.handle

github.handle

avatar

bio

timeZone

Company Enrichment

Look up a company by domain to get 100+ firmographic attributes:

GET https://company.clearbit.com/v2/companies/find?domain={domain}

Streaming:

GET https://company-stream.clearbit.com/v2/companies/find?domain={domain}

Key attributes returned:

name

legalName

industry

sector

subIndustry

category.industryGroup

tags

metrics.employees

metrics.estimatedAnnualRevenue

metrics.raised

metrics.alexaUsRank

tech

(array of technologies),

type

(private/public/nonprofit/education/government),

geo

logo

url

phone

foundedYear

parent.domain

通过域名查询企业信息，可获取100+企业属性：

GET https://company.clearbit.com/v2/companies/find?domain={domain}

流式查询：

GET https://company-stream.clearbit.com/v2/companies/find?domain={domain}

返回核心属性：

name

legalName

industry

sector

subIndustry

category.industryGroup

tags

metrics.employees

metrics.estimatedAnnualRevenue

metrics.raised

metrics.alexaUsRank

tech

（技术栈数组）,

type

（私有/公有/非盈利/教育/政府）,

geo

logo

url

phone

foundedYear

parent.domain

Combined Enrichment

组合补全查询

Look up both person and company in one call:

GET https://person.clearbit.com/v2/combined/find?email={email}

Returns

{ person: {...}, company: {...} }

单次调用同时查询个人和企业信息：

GET https://person.clearbit.com/v2/combined/find?email={email}

{ person: {...}, company: {...} }

。

Reveal (IP Intelligence)

Reveal（IP智能）

Identify the company behind a website visitor's IP:

GET https://reveal.clearbit.com/v1/companies/find?ip={ip}

Returns company firmographics + a confidence score. Use for:

De-anonymizing website traffic
Personalizing website content by company
Triggering sales alerts when target accounts visit
Feeding intent models with visit data

识别网站访客IP对应的企业：

GET https://reveal.clearbit.com/v1/companies/find?ip={ip}

返回企业属性信息+置信度评分，适用于：

网站流量去匿名化
按企业个性化展示网站内容
目标客户访问时触发销售提醒
为意图模型提供访问数据

Prospector

Search for contacts at a company by role, seniority, title, or location:

GET https://prospector.clearbit.com/v1/people/search?domain={domain}

Filter parameters:

role

roles[]

seniority

seniorities[]

title

titles[]

city

cities[]

state

states[]

country

countries[]

name

page

page_size

suppression

(domain to exclude)

按角色、层级、职位或位置搜索企业联系人：

GET https://prospector.clearbit.com/v1/people/search?domain={domain}

筛选参数：

role

roles[]

seniority

seniorities[]

title

titles[]

city

cities[]

state

states[]

country

countries[]

name

page

page_size

suppression

（要排除的域名）

Name to Domain

名称转域名

Resolve a company name to its website domain:

GET https://company.clearbit.com/v1/domains/find?name={company_name}

Returns

{ name, domain, logo }

. Useful for building prospect lists from company names without domains.

将企业名称解析为官网域名：

GET https://company.clearbit.com/v1/domains/find?name={company_name}

{ name, domain, logo }

，适用于从没有域名的企业名称搭建潜客列表。

Form Shortening

表单缩短

Auto-populate form fields when a visitor enters their email:

User enters email in form field
JavaScript calls Person Enrichment API
Pre-fill company, name, title, phone fields
User confirms and submits shorter form

Reduces form fields from 8-10 to 1-2, improving conversion rates by 20-50%.

访客输入邮箱时自动填充表单字段：

用户在表单字段输入邮箱
JavaScript调用Person Enrichment API
预填充企业、姓名、职位、电话字段
用户确认后提交更简短的表单

可将表单字段从8-10个减少到1-2个，转化率提升20-50%。

Risk API

Score signups for fraud risk:

GET https://risk.clearbit.com/v1/calculate?email={email}&ip={ip}&name={name}

Returns risk score and signals (disposable email, IP proxy, new domain, etc.).

对注册行为进行欺诈风险评分：

GET https://risk.clearbit.com/v1/calculate?email={email}&ip={ip}&name={name}

返回风险评分和风险信号（临时邮箱、IP代理、新域名等）。

Breeze Intelligence (HubSpot)

Breeze Intelligence（HubSpot）

For HubSpot users, Clearbit is integrated as Breeze Intelligence:

Auto-enrichment — new contacts/companies automatically enriched in HubSpot
Bulk enrichment — enrich existing records in batches
Form shortening — built into HubSpot forms
Buyer intent — Reveal data powers HubSpot's intent features
40+ attributes — firmographic, demographic, technographic data on every record

Credit system: 100 credits = $45/mo, 1,000 = $150/mo, 10,000 = $700/mo. One credit per record enriched. Credits reset monthly (no rollover). Requires paid HubSpot subscription.

对于HubSpot用户，Clearbit集成后名为Breeze Intelligence：

自动补全 — HubSpot内新增的联系人/企业自动补全信息
批量补全 — 批量补全现有记录
表单缩短 — 内置在HubSpot表单中
采购意图 — Reveal数据为HubSpot的意图功能提供支持
40+属性 — 每条记录的企业、人口、技术栈属性数据

额度体系：100额度 = 45美元/月，1,000额度 = 150美元/月，10,000额度 = 700美元/月。每条记录补全消耗1额度，额度每月重置（不结转），需要付费HubSpot订阅才能使用。

API quick reference

API快速参考

API	Base URL	Method	Key param
Person	`person.clearbit.com/v2/people/find`	GET	`email`
Person (stream)	`person-stream.clearbit.com/v2/people/find`	GET	`email`
Company	`company.clearbit.com/v2/companies/find`	GET	`domain`
Company (stream)	`company-stream.clearbit.com/v2/companies/find`	GET	`domain`
Combined	`person.clearbit.com/v2/combined/find`	GET	`email`
Reveal	`reveal.clearbit.com/v1/companies/find`	GET	`ip`
Prospector	`prospector.clearbit.com/v1/people/search`	GET	`domain`
Name to Domain	`company.clearbit.com/v1/domains/find`	GET	`name`
Risk	`risk.clearbit.com/v1/calculate`	GET	`email` , `ip`

Auth: HTTP Basic Auth — API key as username, empty password. Or

Authorization: Bearer {api_key}

Rate limit: 600 requests/minute per API (streaming and Reveal may differ).

API	基础URL	请求方法	核心参数
Person	`person.clearbit.com/v2/people/find`	GET	`email`
Person（流式）	`person-stream.clearbit.com/v2/people/find`	GET	`email`
Company	`company.clearbit.com/v2/companies/find`	GET	`domain`
Company（流式）	`company-stream.clearbit.com/v2/companies/find`	GET	`domain`
组合查询	`person.clearbit.com/v2/combined/find`	GET	`email`
Reveal	`reveal.clearbit.com/v1/companies/find`	GET	`ip`
Prospector	`prospector.clearbit.com/v1/people/search`	GET	`domain`
名称转域名	`company.clearbit.com/v1/domains/find`	GET	`name`
Risk	`risk.clearbit.com/v1/calculate`	GET	`email` , `ip`

认证：HTTP Basic Auth — 用API密钥作为用户名，密码留空。或者使用

Authorization: Bearer {api_key}

。

限流：每个API每分钟最多600次请求（流式接口和Reveal可能有差异）。

Integrations

集成

Integration	Type	What it does
HubSpot	Native (Breeze Intelligence)	Auto-enrich contacts/companies, form shortening, intent
Salesforce	Native	Enrich leads/contacts/accounts, create enrichment workflows
Segment	Native	Enrichment pushed to all connected destinations
Zapier	Triggers + actions	Enrich person/company on trigger, push data to 8,000+ apps
Make (Integromat)	Module	Clearbit enrichment in automation scenarios
Marketo	Native	Lead enrichment in marketing automation
Slack	Native (clearbit-slack)	Notify channels when target accounts visit site
Webhooks	API	Async enrichment delivery for queued lookups

集成对象	类型	功能
HubSpot	原生集成（Breeze Intelligence）	联系人/企业自动补全、表单缩短、意图识别
Salesforce	原生集成	线索/联系人/账户补全、创建补全工作流
Segment	原生集成	补全数据推送到所有连接的下游
Zapier	触发器+动作	触发时补全个人/企业信息，推送数据到8,000+应用
Make（Integromat）	模块	自动化场景中使用Clearbit补全功能
Marketo	原生集成	营销自动化中的线索补全
Slack	原生集成（clearbit-slack）	目标客户访问网站时通知频道
Webhooks	API	队列查询的异步补全结果推送

Step 4 — Actionable guidance

步骤4 — 可落地指导

Setting up Clearbit enrichment

搭建Clearbit信息补全

Get your API key — sign up at clearbit.com, find key in account settings
Choose sync vs. async — use streaming endpoints (
```
-stream.clearbit.com
```
) for real-time; use standard endpoints + webhooks for batch/async
Start with Combined endpoint —
```
person.clearbit.com/v2/combined/find?email={email}
```
returns both person and company in one call
Handle 202 responses — if not using streaming, a 202 means the lookup is queued. Set up a webhook URL to receive results when ready
Cache results — enrichment data is valid for 30-90 days. Cache locally to avoid burning API calls on repeated lookups
Map to CRM fields — create custom fields in your CRM for key attributes (employee count, revenue, industry, tech stack)

获取API密钥 — 在clearbit.com注册，在账户设置中找到密钥
选择同步/异步模式 — 实时场景使用流式接口（
```
-stream.clearbit.com
```
）；批量/异步场景使用标准接口+Webhooks
优先使用组合查询接口 —
```
person.clearbit.com/v2/combined/find?email={email}
```
单次调用返回个人和企业信息
处理202响应 — 如果不使用流式接口，202状态表示查询已进入队列，设置Webhook URL接收就绪后的结果
缓存结果 — 补全数据有效期为30-90天，本地缓存避免重复查询消耗API调用次数
映射到CRM字段 — 在CRM中为核心属性（员工数、营收、行业、技术栈）创建自定义字段

Reveal setup for website visitor identification

Reveal搭建网站访客识别

Add the Clearbit JavaScript tag to your website (or use Segment)
Configure IP-to-company matching — Reveal identifies the company, not the individual
Set up alerts — trigger Slack notifications or CRM tasks when target accounts visit
Filter internal traffic — exclude your own company's IP ranges
Combine with Prospector — once Reveal identifies a company, use Prospector to find the right contact

在网站添加Clearbit JavaScript标签（或使用Segment）
配置IP转企业匹配规则 — Reveal识别企业，而非个人
设置提醒 — 目标客户访问时触发Slack通知或CRM任务
过滤内部流量 — 排除自有公司的IP范围
结合Prospector使用 — Reveal识别企业后，用Prospector查找对应联系人

Breeze Intelligence setup (HubSpot users)

Breeze Intelligence搭建（HubSpot用户）

Purchase credits — go to HubSpot Settings → Account Management → Breeze Intelligence
Enable auto-enrichment — toggle on for new contacts and companies
Map fields — Breeze auto-maps to standard HubSpot properties; review custom property mapping
Set up form shortening — enable on HubSpot forms to auto-populate fields from email
Monitor credit usage — credits don't roll over; adjust volume to match monthly needs

购买额度 — 进入HubSpot设置 → 账户管理 → Breeze Intelligence
开启自动补全 — 为新增联系人和企业开启自动补全
字段映射 — Breeze自动映射到HubSpot标准属性，检查自定义属性映射是否正确
设置表单缩短 — 在HubSpot表单上开启功能，通过邮箱自动填充字段
监控额度使用 — 额度不结转，调整使用量匹配月度需求

Gotchas

注意事项

Best-effort from research — review these, especially items about plan-gated features and pricing that may be outdated.

HubSpot lock-in: Breeze Intelligence requires a paid HubSpot subscription. If you use Salesforce, Pipedrive, or any other CRM, you must use the standalone Clearbit API (not Breeze Intelligence). The standalone API's future is uncertain post-acquisition.
Credits don't roll over: Breeze Intelligence credits reset monthly. If you buy 1,000 credits and use 200, you lose 800. Right-size your plan carefully.
Reveal identifies companies, not people: The Reveal API returns company data from IP addresses, not individual visitors. You still need Prospector or another tool to find the specific contact at that company.
SDK deprecation: The official Ruby, Node.js, Python, and Go SDKs are all deprecated. Clearbit recommends direct HTTP requests. If your code uses these SDKs, plan migration to direct API calls.
202 responses require webhooks: Standard (non-streaming) enrichment endpoints return 202 if the person/company isn't in Clearbit's cache. You must configure a webhook URL to receive async results, or use the streaming endpoints which hold the connection open.

基于研究的最优建议 — 请留意这些内容，尤其是与套餐功能和定价相关的内容可能已过时。

HubSpot绑定：Breeze Intelligence需要付费HubSpot订阅。如果你使用Salesforce、Pipedrive或其他CRM，必须使用独立Clearbit API（而非Breeze Intelligence）。收购后独立API的未来发展尚不明确。
额度不结转：Breeze Intelligence额度每月重置，如果你购买1000额度仅使用200，剩余800将失效，请合理选择套餐规模。
Reveal识别企业而非个人：Reveal API通过IP返回企业数据，而非单个访客，你仍需使用Prospector或其他工具查找该企业的具体联系人。
SDK已废弃：官方Ruby、Node.js、Python、Go SDK均已废弃，Clearbit推荐直接使用HTTP请求。如果你的代码使用这些SDK，请计划迁移到直接API调用。
202响应需要Webhook：标准（非流式）补全接口如果个人/企业不在Clearbit缓存中会返回202，你必须配置Webhook URL接收异步结果，或使用保持连接的流式接口。

Step 5 — Related skills

步骤5 — 相关技能

```
/sales-enrich
```
— Enrichment strategy across tools (Clearbit, ZoomInfo, Apollo, Clay, etc.)
```
/sales-intent
```
— Buying signals and visitor identification strategy (Reveal feeds intent models)
```
/sales-prospect-list
```
— Build prospect lists across tools (Prospector is one option)
```
/sales-lead-score
```
— Design lead scoring models using enrichment data
```
/sales-data-hygiene
```
— CRM data quality, dedup, enrichment automation
```
/sales-audience-growth
```
— Form optimization and conversion (form shortening)
```
/sales-integration
```
— Connect Clearbit to CRM, marketing automation, and other tools
```
/sales-zoominfo
```
— ZoomInfo platform (primary competitor for enterprise enrichment)
```
/sales-do
```
— Not sure which skill to use? The router matches any sales objective to the right skill. Install:
```
npx skills add sales-skills/sales --skills sales-do
```

```
/sales-enrich
```
— 跨工具信息补全策略（Clearbit、ZoomInfo、Apollo、Clay等）
```
/sales-intent
```
— 采购信号和访客识别策略（Reveal为意图模型提供数据）
```
/sales-prospect-list
```
— 跨工具搭建潜客列表（Prospector是其中一个选项）
```
/sales-lead-score
```
— 使用补全数据设计线索评分模型
```
/sales-data-hygiene
```
— CRM数据质量、去重、补全自动化
```
/sales-audience-growth
```
— 表单优化和转化（表单缩短）
```
/sales-integration
```
— 将Clearbit连接到CRM、营销自动化和其他工具
```
/sales-zoominfo
```
— ZoomInfo平台（企业级信息补全的主要竞品）
```
/sales-do
```
— 不确定使用哪个技能？路由会匹配所有销售目标到对应技能。安装命令：
```
npx skills add sales-skills/sales --skills sales-do
```

Examples

示例

Example 1: Real-time lead enrichment via API

示例1：通过API实时补全线索

User says: "I want to enrich new leads in real-time as they submit our website form — how do I set up Clearbit for this?" Skill does: Recommends the Combined streaming endpoint (

person-stream.clearbit.com/v2/combined/find

), explains authentication, walks through the response structure, shows how to map key fields (company size, revenue, industry, title) to CRM properties, and suggests caching results to avoid redundant API calls Result: Working real-time enrichment pipeline that enriches leads on form submission

用户提问："我想在网站表单提交时实时补全新增线索信息，怎么设置Clearbit？" 技能处理：推荐组合流式接口（

person-stream.clearbit.com/v2/combined/find

），说明认证方式，讲解响应结构，展示如何将核心字段（企业规模、营收、行业、职位）映射到CRM属性，建议缓存结果避免重复API调用结果：可用的实时补全流程，表单提交时自动补全线索信息

Example 2: Identify target accounts visiting the website

示例2：识别访问网站的目标客户

User says: "We want to know when our target accounts are browsing our pricing page so sales can follow up" Skill does: Sets up Reveal API integration, explains IP-to-company matching, configures Slack alerts for target account visits filtered by page URL, recommends combining with Prospector to find the right contact, and suggests adding visit data to CRM account records Result: Sales team gets real-time alerts when target accounts show buying intent on the website

用户提问："我们想知道目标客户什么时候浏览我们的定价页，方便销售跟进" 技能处理：搭建Reveal API集成，讲解IP转企业匹配逻辑，配置按页面URL过滤的目标客户访问Slack提醒，推荐结合Prospector查找对应联系人，建议将访问数据添加到CRM账户记录结果：目标客户在网站展现采购意图时，销售团队收到实时提醒

Example 3: Breeze Intelligence setup in HubSpot

示例3：HubSpot中搭建Breeze Intelligence

User says: "We just got HubSpot Professional and want to use Clearbit enrichment — how do I set up Breeze Intelligence?" Skill does: Walks through purchasing credits, enabling auto-enrichment for new contacts/companies, configuring form shortening on HubSpot forms, mapping enrichment fields to HubSpot properties, and monitoring credit usage to avoid waste Result: HubSpot CRM automatically enriches every new contact with firmographic and demographic data

用户提问："我们刚购买了HubSpot Professional，想使用Clearbit补全功能，怎么设置Breeze Intelligence？" 技能处理：讲解购买额度、为新增联系人/企业开启自动补全、配置HubSpot表单的表单缩短功能、映射补全字段到HubSpot属性、监控额度使用避免浪费的全流程结果：HubSpot CRM自动为每个新增联系人补全企业和人口属性数据

Troubleshooting

故障排查

Enrichment returns 202 with no data

补全返回202无数据

Symptom: API call returns HTTP 202 instead of enrichment data Cause: The person or company isn't in Clearbit's cache and needs to be looked up asynchronously Solution: Either switch to the streaming endpoint (

person-stream.clearbit.com

) which holds the connection open for up to 60 seconds, or configure a webhook URL in your Clearbit account settings to receive results when the async lookup completes.

症状：API调用返回HTTP 202而非补全数据原因：个人或企业不在Clearbit缓存中，需要异步查询 解决方案：切换到最长保持60秒连接的流式接口（

person-stream.clearbit.com

），或在Clearbit账户设置中配置Webhook URL接收异步查询完成后的结果。

Reveal returns null for most visitors

大多数访客的Reveal返回空

Symptom: The Reveal API returns no company match for a large percentage of website visitors Cause: Reveal can only match IP addresses that belong to known business ISPs. Residential IPs, VPNs, and mobile networks can't be matched to companies. Match rates are typically 20-30% of total traffic. Solution: This is expected behavior — focus on the matched visits rather than the miss rate. Combine with UTM tracking, form fills, and other signals to identify the remaining visitors.

症状：Reveal API对大部分网站访客没有返回企业匹配结果原因：Reveal只能匹配属于已知商业ISP的IP地址，住宅IP、VPN、移动网络无法匹配到企业，匹配率通常为总流量的20-30%。 解决方案：这是预期行为，重点关注匹配成功的访问，结合UTM追踪、表单提交和其他信号识别剩余访客。

Breeze Intelligence credits depleting too fast

Breeze Intelligence额度消耗过快

Symptom: Monthly credits run out before the billing cycle resets Cause: Auto-enrichment is enriching every new contact, including low-value leads from form spam, imported lists, or internal test records Solution: Set up enrichment rules to only enrich contacts that meet minimum criteria (e.g., business email domain, specific form source, lead score threshold). Disable auto-enrichment for imported lists and use manual bulk enrichment instead.

症状：月度额度在账单周期重置前就用完了原因：自动补全为所有新增联系人补全信息，包括表单垃圾信息、导入列表、内部测试记录等低价值线索 解决方案：设置补全规则，仅为满足最低标准的联系人补全信息（例如企业邮箱域名、特定表单来源、线索评分阈值），关闭导入列表的自动补全，改用手动批量补全。