data-enrichment

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Data Enrichment with x402 APIs

借助x402 API实现数据丰富

STOP — Read before making any API call. enrichx402.com endpoints are not the same as each provider's native API. All paths use the format
https://enrichx402.com/api/{provider}/{action}
. You MUST either:
Copy exact URLs from the Quick Reference table below, OR
Run
x402.discover_api_endpoints(url="https://enrichx402.com")
to get the correct paths
Guessing paths will fail with 405 errors (wrong path) or 404 errors (missing
/api/
prefix).

Use the x402scan MCP tools to access enrichment APIs at enrichx402.com.

注意——调用任何API前请仔细阅读。 enrichx402.com的接口与各服务商的原生API并不相同。所有路径均采用
https://enrichx402.com/api/{provider}/{action}
格式。您必须：
从下方快速参考表中复制准确URL，或
运行
x402.discover_api_endpoints(url="https://enrichx402.com")
获取正确路径
猜测路径会导致失败，返回405错误（路径错误）或404错误（缺少
/api/
前缀）。

使用x402scan MCP工具访问enrichx402.com的丰富数据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://enrichx402.com/api/apollo/people-enrich`	$0.0495	Email/LinkedIn -> full profile
Enrich company	`https://enrichx402.com/api/apollo/org-enrich`	$0.0495	Domain -> company data
Search people	`https://enrichx402.com/api/apollo/people-search`	$0.02	Find people by criteria
Search companies	`https://enrichx402.com/api/apollo/org-search`	$0.02	Find companies by criteria
LinkedIn scrape	`https://enrichx402.com/api/clado/linkedin-scrape`	$0.04	Full LinkedIn profile
Contact recovery	`https://enrichx402.com/api/clado/contacts-enrich`	$0.20	Find missing email/phone
Bulk people	`https://enrichx402.com/api/apollo/people-enrich/bulk`	$0.495	Up to 10 people at once
Bulk companies	`https://enrichx402.com/api/apollo/org-enrich/bulk`	$0.495	Up to 10 companies at once

任务	接口	价格	最佳适用场景
个人资料丰富	`https://enrichx402.com/api/apollo/people-enrich`	$0.0495	通过邮箱/LinkedIn获取完整资料
公司资料丰富	`https://enrichx402.com/api/apollo/org-enrich`	$0.0495	通过域名获取公司数据
人员搜索	`https://enrichx402.com/api/apollo/people-search`	$0.02	根据条件查找人员
公司搜索	`https://enrichx402.com/api/apollo/org-search`	$0.02	根据条件查找公司
LinkedIn资料抓取	`https://enrichx402.com/api/clado/linkedin-scrape`	$0.04	获取完整LinkedIn资料
联系信息恢复	`https://enrichx402.com/api/clado/contacts-enrich`	$0.20	查找缺失的邮箱/电话
批量个人处理	`https://enrichx402.com/api/apollo/people-enrich/bulk`	$0.495	一次处理最多10个个人资料
批量公司处理	`https://enrichx402.com/api/apollo/org-enrich/bulk`	$0.495	一次处理最多10个公司资料

Workflows

工作流程

Standard Enrichment

标准数据丰富流程

(Optional) Check balance:
```
x402.get_wallet_info
```

Discover endpoints (required before first fetch):

x402.discover_api_endpoints(url="https://enrichx402.com")

Check endpoint schema:
```
x402.check_endpoint_schema(url="...")
```
to verify parameters and pricing
Call endpoint with
```
x402.fetch
```
using exact URL from discovery or Quick Reference table above
Parse and present results

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich",
  method="POST",
  body={"email": "user@company.com"}
)

（可选）查看余额：
```
x402.get_wallet_info
```

发现接口（首次调用前必须执行）：

x402.discover_api_endpoints(url="https://enrichx402.com")

检查接口 schema：
```
x402.check_endpoint_schema(url="...")
```
验证参数和定价
使用
```
x402.fetch
```
调用接口，URL需与发现结果或上方快速参考表中的完全一致
解析并展示结果

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich",
  method="POST",
  body={"email": "user@company.com"}
)

Person Enrichment

个人资料丰富

Enrich a person using any available identifier:

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich",
  method="POST",
  body={
    "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.

使用任意可用标识丰富个人资料：

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich",
  method="POST",
  body={
    "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:

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-enrich",
  method="POST",
  body={
    "domain": "stripe.com"
  }
)

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

通过域名丰富公司资料：

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-enrich",
  method="POST",
  body={
    "domain": "stripe.com"
  }
)

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

People Search

人员搜索

Search for people matching criteria:

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-search",
  method="POST",
  body={
    "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

根据条件搜索人员：

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-search",
  method="POST",
  body={
    "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:

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-search",
  method="POST",
  body={
    "q_keywords": "fintech",
    "organization_locations": ["New York, NY"],
    "organization_num_employees_ranges": ["51-200", "201-500"]
  }
)

根据条件搜索公司：

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-search",
  method="POST",
  body={
    "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:

mcp

x402.fetch(
  url="https://enrichx402.com/api/clado/linkedin-scrape",
  method="POST",
  body={
    "linkedin_url": "https://linkedin.com/in/johndoe"
  }
)

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

获取完整LinkedIn资料数据：

mcp

x402.fetch(
  url="https://enrichx402.com/api/clado/linkedin-scrape",
  method="POST",
  body={
    "linkedin_url": "https://linkedin.com/in/johndoe"
  }
)

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

Contact Recovery (Clado)

联系信息恢复（Clado）

Find missing email or phone:

mcp

x402.fetch(
  url="https://enrichx402.com/api/clado/contacts-enrich",
  method="POST",
  body={
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "email": "john@example.com"
  }
)

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

查找缺失的邮箱或电话：

mcp

x402.fetch(
  url="https://enrichx402.com/api/clado/contacts-enrich",
  method="POST",
  body={
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "email": "john@example.com"
  }
)

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

Bulk Operations

批量操作

Process up to 10 records in one request:

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich/bulk",
  method="POST",
  body={
    "people": [
      { "email": "person1@company.com" },
      { "email": "person2@company.com" },
      { "linkedin_url": "https://linkedin.com/in/person3" }
    ]
  }
)

For companies:

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-enrich/bulk",
  method="POST",
  body={
    "organizations": [
      { "domain": "company1.com" },
      { "domain": "company2.com" }
    ]
  }
)

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

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich/bulk",
  method="POST",
  body={
    "people": [
      { "email": "person1@company.com" },
      { "email": "person2@company.com" },
      { "linkedin_url": "https://linkedin.com/in/person3" }
    ]
  }
)

公司批量处理：

mcp

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-enrich/bulk",
  method="POST",
  body={
    "organizations": [
      { "domain": "company1.com" },
      { "domain": "company2.com" }
    ]
  }
)

Cost Optimization

成本优化

Field Filtering

字段过滤

Reduce costs by excluding unneeded fields:

body={
  "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

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

body={
  "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:
```
/api/apollo/people-search
```
Review results, pick the right match
Enrich only the matches you need

使用搜索接口（$0.02）找到目标记录后再进行丰富（$0.0495）：

搜索候选人：
```
/api/apollo/people-search
```
查看结果，选择匹配的记录
仅对需要的记录进行丰富

Parallel Calls

并行调用

When enriching multiple independent records, make calls in parallel:

mcp

undefined

丰富多个独立记录时，可并行发起调用：

mcp

undefined

These can run simultaneously since they're independent

这些调用可同时执行，因为彼此独立

x402.fetch(url=".../people-enrich", body={"email": "a@co.com"}) x402.fetch(url=".../people-enrich", body={"email": "b@co.com"})


Or use bulk endpoints for the best efficiency.

x402.fetch(url=".../people-enrich", body={"email": "a@co.com"}) x402.fetch(url=".../people-enrich", body={"email": "b@co.com"})


或使用批量接口以获得最佳效率。

Handling missing data

缺失数据处理

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

Oftentimes, if apollo is missing data, clado will have it, and vice versa.

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可能会有，反之亦然。

如果这些API仍无法获取数据，请使用内置的WebSearch和WebFetch工具查找额外信息（如公司域名或LinkedIn URL），然后利用这些数据发起更精准的查询。