data-enrichment

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Data Enrichment with x402 APIs

借助x402 API实现数据补全

Use the agentcash CLI to access enrichment APIs at stableenrich.dev.

使用agentcash CLI访问stableenrich.dev的补全API。

Setup

设置步骤

See rules/getting-started.md for installation and wallet setup.

安装及钱包设置请查看rules/getting-started.md。

Quick Reference

快速参考

Task	Endpoint	Price	Best For
Enrich person	`https://stableenrich.dev/api/apollo/people-enrich`	$0.0495	Email/LinkedIn -> full profile
Enrich company	`https://stableenrich.dev/api/apollo/org-enrich`	$0.0495	Domain -> company data
Search people	`https://stableenrich.dev/api/apollo/people-search`	$0.02	Find people by criteria
Search companies	`https://stableenrich.dev/api/apollo/org-search`	$0.02	Find companies by criteria
LinkedIn scrape	`https://stableenrich.dev/api/clado/linkedin-scrape`	$0.04	Full LinkedIn profile
Contact recovery	`https://stableenrich.dev/api/clado/contacts-enrich`	$0.20	Find missing email/phone
Verify email	`https://stableenrich.dev/api/hunter/email-verifier`	$0.03	Check deliverability
Influencer by email	`https://stableenrich.dev/api/influencer/enrich-by-email`	$0.40	Email -> social profiles
Influencer by social	`https://stableenrich.dev/api/influencer/enrich-by-social`	$0.40	Handle -> creator data
Bulk people	`https://stableenrich.dev/api/apollo/people-enrich/bulk`	$0.495	Up to 10 people at once
Bulk companies	`https://stableenrich.dev/api/apollo/org-enrich/bulk`	$0.495	Up to 10 companies at once

任务	接口地址	价格	最佳适用场景
个人资料补全	`https://stableenrich.dev/api/apollo/people-enrich`	$0.0495	邮箱/LinkedIn -> 完整个人资料
企业资料补全	`https://stableenrich.dev/api/apollo/org-enrich`	$0.0495	域名 -> 企业数据
个人搜索	`https://stableenrich.dev/api/apollo/people-search`	$0.02	根据条件查找个人
企业搜索	`https://stableenrich.dev/api/apollo/org-search`	$0.02	根据条件查找企业
LinkedIn资料抓取	`https://stableenrich.dev/api/clado/linkedin-scrape`	$0.04	完整LinkedIn个人资料
联系方式找回	`https://stableenrich.dev/api/clado/contacts-enrich`	$0.20	查找缺失的邮箱/电话
邮箱验证	`https://stableenrich.dev/api/hunter/email-verifier`	$0.03	验证邮箱可送达性
邮箱匹配网红资料	`https://stableenrich.dev/api/influencer/enrich-by-email`	$0.40	邮箱 -> 社交平台资料
社交账号匹配网红资料	`https://stableenrich.dev/api/influencer/enrich-by-social`	$0.40	账号名 -> 创作者数据
批量个人资料补全	`https://stableenrich.dev/api/apollo/people-enrich/bulk`	$0.495	一次处理最多10个个人
批量企业资料补全	`https://stableenrich.dev/api/apollo/org-enrich/bulk`	$0.495	一次处理最多10个企业

Workflows

工作流程

Standard Enrichment

标准补全流程

(Optional) Check balance:
```
npx agentcash wallet info
```

Use

npx agentcash discover https://stableenrich.dev

to list all endpoints

Use
```
npx agentcash check <endpoint-url>
```
to see expected parameters and pricing
Call endpoint with
```
npx agentcash fetch
```
Parse and present results

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-enrich -m POST -b '{"email": "user@company.com"}'

（可选）查看余额：
```
npx agentcash wallet info
```

使用

npx agentcash discover https://stableenrich.dev

列出所有接口

使用
```
npx agentcash check <endpoint-url>
```
查看预期参数和定价
使用
```
npx agentcash fetch
```
调用接口
解析并展示结果

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-enrich -m POST -b '{"email": "user@company.com"}'

Person Enrichment

个人资料补全

Enrich a person using any available identifier:

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-enrich -m POST -b '{
  "email": "john@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "organization_name": "Acme Inc",
  "domain": "company.com",
  "linkedin_url": "https://linkedin.com/in/johndoe"
}'

Input options (provide any combination):

```
email
```
- Email address (most reliable)
```
linkedin_url
```
- LinkedIn profile URL
```
first_name
```
+
```
last_name
```
- Name (works better with domain/org)
```
organization_name
```
or
```
domain
```
- Helps match the right person

Returns: Name, title, company, employment history, location, social profiles, phone numbers.

使用任意可用标识补全个人资料：

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-enrich -m POST -b '{
  "email": "john@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "organization_name": "Acme Inc",
  "domain": "company.com",
  "linkedin_url": "https://linkedin.com/in/johndoe"
}'

输入选项（可提供任意组合）：

```
email
```
- 邮箱地址（最可靠）
```
linkedin_url
```
- LinkedIn个人资料URL
```
first_name
```
+
```
last_name
```
- 姓名（搭配域名/企业名效果更佳）
```
organization_name
```
或
```
domain
```
- 帮助匹配正确的个人

返回内容：姓名、职位、企业、工作经历、所在地、社交账号、电话号码。

Company Enrichment

企业资料补全

Enrich a company by domain:

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/org-enrich -m POST -b '{"domain": "stripe.com"}'

Returns: Company name, industry, employee count, revenue estimates, funding info, technologies used, social links.

通过域名补全企业资料：

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/org-enrich -m POST -b '{"domain": "stripe.com"}'

返回内容：企业名称、行业、员工数量、收入预估、融资信息、使用技术、社交链接。

People Search

个人搜索

Search for people matching criteria:

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-search -m POST -b '{
  "q_keywords": "software engineer",
  "person_titles": ["CTO", "VP Engineering"],
  "organization_domains": ["google.com", "meta.com"],
  "person_locations": ["San Francisco, CA"]
}'

Search filters:

```
q_keywords
```
- Keywords to search
```
person_titles
```
- Job title filters
```
organization_domains
```
- Company domains
```
person_locations
```
- Location filters
```
person_seniorities
```
- Seniority levels

根据条件搜索匹配的个人：

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-search -m POST -b '{
  "q_keywords": "software engineer",
  "person_titles": ["CTO", "VP Engineering"],
  "organization_domains": ["google.com", "meta.com"],
  "person_locations": ["San Francisco, CA"]
}'

搜索筛选条件：

```
q_keywords
```
- 搜索关键词
```
person_titles
```
- 职位筛选
```
organization_domains
```
- 企业域名
```
person_locations
```
- 所在地筛选
```
person_seniorities
```
- 职级筛选

Company Search

企业搜索

Search for companies matching criteria:

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/org-search -m POST -b '{
  "q_keywords": "fintech",
  "organization_locations": ["New York, NY"],
  "organization_num_employees_ranges": ["51-200", "201-500"]
}'

根据条件搜索匹配的企业：

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/org-search -m POST -b '{
  "q_keywords": "fintech",
  "organization_locations": ["New York, NY"],
  "organization_num_employees_ranges": ["51-200", "201-500"]
}'

LinkedIn Scraping (Clado)

LinkedIn资料抓取（Clado）

Get full LinkedIn profile data:

bash

npx agentcash fetch https://stableenrich.dev/api/clado/linkedin-scrape -m POST -b '{"linkedin_url": "https://linkedin.com/in/johndoe"}'

Returns: Experience history, education, skills, certifications, recommendations, connection count.

获取完整LinkedIn个人资料数据：

bash

npx agentcash fetch https://stableenrich.dev/api/clado/linkedin-scrape -m POST -b '{"linkedin_url": "https://linkedin.com/in/johndoe"}'

返回内容：工作经历、教育背景、技能、证书、推荐语、联系人数量。

Contact Recovery (Clado)

联系方式找回（Clado）

Find missing email or phone:

bash

npx agentcash fetch https://stableenrich.dev/api/clado/contacts-enrich -m POST -b '{
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "email": "john@example.com"
}'

Returns: Validated email addresses and phone numbers with confidence scores.

查找缺失的邮箱或电话：

bash

npx agentcash fetch https://stableenrich.dev/api/clado/contacts-enrich -m POST -b '{
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "email": "john@example.com"
}'

返回内容：带置信度评分的已验证邮箱地址和电话号码。

Bulk Operations

批量操作

Process up to 10 records in one request:

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-enrich/bulk -m POST -b '{
  "people": [
    {"email": "person1@company.com"},
    {"email": "person2@company.com"},
    {"linkedin_url": "https://linkedin.com/in/person3"}
  ]
}'

For companies:

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/org-enrich/bulk -m POST -b '{
  "organizations": [
    {"domain": "company1.com"},
    {"domain": "company2.com"}
  ]
}'

一次请求处理最多10条记录：

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/people-enrich/bulk -m POST -b '{
  "people": [
    {"email": "person1@company.com"},
    {"email": "person2@company.com"},
    {"linkedin_url": "https://linkedin.com/in/person3"}
  ]
}'

企业批量操作：

bash

npx agentcash fetch https://stableenrich.dev/api/apollo/org-enrich/bulk -m POST -b '{
  "organizations": [
    {"domain": "company1.com"},
    {"domain": "company2.com"}
  ]
}'

Cost Optimization

成本优化

Field Filtering

字段过滤

Reduce costs by excluding unneeded fields:

json

{
  "email": "john@company.com",
  "excludeFields": ["employment_history", "photos", "phone_numbers"]
}

Common fields to exclude:

```
employment_history
```
- Past jobs (often large)
```
photos
```
- Profile images
```
phone_numbers
```
- If you only need email
```
social_profiles
```
- If you don't need social links

通过排除不需要的字段降低成本：

json

{
  "email": "john@company.com",
  "excludeFields": ["employment_history", "photos", "phone_numbers"]
}

常见可排除字段：

```
employment_history
```
- 过往工作经历（通常数据量较大）
```
photos
```
- 个人资料图片
```
phone_numbers
```
- 若仅需邮箱
```
social_profiles
```
- 若无需社交账号链接

Bulk vs Individual

批量 vs 单个处理

Individual: $0.0495 per record
Bulk (10): $0.495 total = $0.0495 per record

Bulk is the same price per record but faster for multiple items.

单个处理：每条记录$0.0495
批量（10条）：总计$0.495 = 每条$0.0495

批量处理单条记录价格相同，但处理多条数据时速度更快。

Search Before Enrich

先搜索后补全

Use search endpoints ($0.02) to find the right records before enriching ($0.0495):

Search for candidates:

https://stableenrich.dev/api/apollo/people-search

Review results, pick the right match
Enrich only the matches you need

先使用搜索接口（$0.02）找到目标记录，再进行补全（$0.0495）：

搜索候选人：

https://stableenrich.dev/api/apollo/people-search

查看结果，选择匹配项
仅对匹配项进行补全

Email Verification (Hunter)

邮箱验证（Hunter）

Verify if an email address is deliverable before sending outreach:

bash

npx agentcash fetch https://stableenrich.dev/api/hunter/email-verifier -m POST -b '{"email": "john@stripe.com"}'

Returns: Deliverability status, MX record validation, SMTP verification, confidence score, and flags for catch-all, disposable, or role-based addresses.

Status	Meaning	Action
`deliverable`	Email exists and accepts mail	Safe to send
`undeliverable`	Email doesn't exist or rejects mail	Do not send
`risky`	Catch-all domain or temporary issues	Send with caution
`unknown`	Could not determine status	Try again later

Tip: Combine with people-enrich to find and verify contacts in one pipeline:

Search:
```
people-search
```
($0.02) -> find candidates
Enrich:
```
people-enrich
```
($0.0495) -> get email
Verify:
```
hunter/email-verifier
```
($0.03) -> confirm deliverability

发送触达邮件前验证邮箱是否可送达：

bash

npx agentcash fetch https://stableenrich.dev/api/hunter/email-verifier -m POST -b '{"email": "john@stripe.com"}'

返回内容：可送达状态、MX记录验证、SMTP验证、置信度评分，以及是否为 catch-all、一次性或角色型邮箱的标记。

状态	含义	操作建议
`deliverable`	邮箱存在且接受邮件	可安全发送
`undeliverable`	邮箱不存在或拒绝邮件	请勿发送
`risky`	域名为catch-all或存在临时问题	谨慎发送
`unknown`	无法确定状态	稍后重试

提示：结合个人资料补全接口，在一个流程中完成查找和验证：

搜索：
```
people-search
```
（$0.02）-> 找到候选人
补全：
```
people-enrich
```
（$0.0495）-> 获取邮箱
验证：
```
hunter/email-verifier
```
（$0.03）-> 确认可送达性

Influencer Enrichment

网红资料补全

Enrich social media influencer/creator profiles across Instagram, TikTok, YouTube, X/Twitter, and Facebook.

跨Instagram、TikTok、YouTube、X/Twitter和Facebook平台完善社交媒体网红/创作者资料。

Find Profiles by Email

通过邮箱匹配资料

bash

npx agentcash fetch https://stableenrich.dev/api/influencer/enrich-by-email -m POST -b '{
  "email": "creator@example.com",
  "platform": "instagram",
  "enrichment_mode": "enhanced"
}'

Parameters:

```
email
```
— the creator's email address (required)

platform

—

"instagram"

"tiktok"

"youtube"

"twitter"

"facebook"

(required)

```
enrichment_mode
```
—
```
"enhanced"
```
for full data (recommended)

Returns: Social media profiles, follower counts, engagement metrics, audience demographics, contact info, content categories.

bash

npx agentcash fetch https://stableenrich.dev/api/influencer/enrich-by-email -m POST -b '{
  "email": "creator@example.com",
  "platform": "instagram",
  "enrichment_mode": "enhanced"
}'

参数：

```
email
```
— 创作者邮箱地址（必填）

platform

—

"instagram"

、

"tiktok"

、

"youtube"

、

"twitter"

、

"facebook"

（必填）

```
enrichment_mode
```
—
```
"enhanced"
```
获取完整数据（推荐）

返回内容：社交媒体资料、粉丝数、互动指标、受众 demographics、联系信息、内容分类。

Enrich by Social Handle

通过社交账号匹配资料

bash

npx agentcash fetch https://stableenrich.dev/api/influencer/enrich-by-social -m POST -b '{
  "platform": "instagram",
  "username": "creator_handle",
  "enrichment_mode": "enhanced",
  "email_required": "must_have"
}'

Parameters:

platform

—

"instagram"

"tiktok"

"youtube"

"twitter"

"facebook"

(required)

```
username
```
— handle on that platform (required)
```
enrichment_mode
```
—
```
"enhanced"
```
for full data (recommended)
```
email_required
```
—
```
"must_have"
```
to only return profiles with email

Returns: Full profile with engagement metrics, contact info (email, phone), audience demographics, brand affinity, cross-platform links.

bash

npx agentcash fetch https://stableenrich.dev/api/influencer/enrich-by-social -m POST -b '{
  "platform": "instagram",
  "username": "creator_handle",
  "enrichment_mode": "enhanced",
  "email_required": "must_have"
}'

参数：

platform

—

"instagram"

、

"tiktok"

、

"youtube"

、

"twitter"

、

"facebook"

（必填）

```
username
```
— 对应平台的账号名（必填）
```
enrichment_mode
```
—
```
"enhanced"
```
获取完整数据（推荐）
```
email_required
```
—
```
"must_have"
```
仅返回带邮箱的资料

返回内容：完整资料（含互动指标）、联系信息（邮箱、电话）、受众 demographics、品牌偏好、跨平台链接。

When to Use Influencer vs Apollo/Clado

何时使用网红接口 vs Apollo/Clado

Apollo/Clado — best for professional/B2B profiles (job titles, company, employment history)
Influencer — best for social media creators (followers, engagement, audience data, content categories)

Apollo/Clado — 最适合专业/B2B资料（职位、企业、工作经历）
网红接口 — 最适合社交媒体创作者（粉丝数、互动数据、受众信息、内容分类）

Handling missing data

缺失数据处理

If any query fails to return the data you are looking for, revisit the list of available APIs.

Oftentimes, if Apollo is missing data, Clado will have it, and vice versa. For social media creators, try the influencer endpoints. For email deliverability, use Hunter.

If those still fail, use built-in WebSearch and WebFetch tools to find additional information like a company domain name or LinkedIn URL, and then use that data to make more targeted queries.

若任何查询未返回所需数据，请重新查看可用API列表。

通常，如果Apollo缺少数据，Clado可能会有，反之亦然。对于社交媒体创作者，请尝试网红接口。对于邮箱可送达性，请使用Hunter接口。

若上述接口仍无法获取数据，可使用内置的WebSearch和WebFetch工具查找额外信息（如企业域名或LinkedIn URL），再利用这些数据进行更精准的查询。