Person Enrichment API
Person Enrichment Bettercontact API
通过 BetterContact 的瀑布式邮箱查找处理一位联系人,输入姓名加公司域名或 LinkedIn URL,返回最终命中的邮箱及其可送达性判定、找到它的服务商,以及雇主记录。只对匹配成功的联系人扣费。
POST/v1/run/person_enrichment.bettercontact
可用率
100.00%
30d · 3 次调用
请求数
3
30d · 按周,近 12 周
响应时间
110.1s
中位数 · 30d
调用方式
发出你的第一个请求
import os, requests res = requests.post( "https://api.getanyapi.com/v1/run/person_enrichment.bettercontact", headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"}, json={ "firstName": "", "lastName": "" }, ) print(res.json())
示例响应
{
"data": {
"city": "San Francisco",
"company": {
"about": "A short example description of this item.",
"addressCity": "San Francisco",
"addressCountry": "US",
"addressState": "CA",
"addressStreet": "123 Main St",
"addressZipcode": "123 Main St",
"companyId": "Acme Inc",
"countryCode": "US",
"crunchbaseUrl": "https://example.com/page",
"description": "A short example description of this item.",
"directionsUrl": "https://example.com/page",
"domain": "example.com",
"employees": 42,
"employeesOnLinkedin": 42,
"followers": 12500,
"founded": 42,
"headquarters": "example",
"headquartersAddress": "123 Main St",
"headquartersCity": "San Francisco",
"headquartersCountry": "US",
"image": "https://example.com/image.jpg",
"industryCode": "general",
"legalId": "a1b2c3d4",
"legalName": "Example title",
"linkedinId": "https://example.com/page",
"linkedinUrl": "https://example.com/page",
"name": "Example title",
"organizationType": "Acme Inc",
"phone": "+1 555-0142",
"size": "example",
"website": "https://example.com/page"
},
"connections": 42,
"contactId": "a1b2c3d4",
"country": "US",
"countryCode": "US",
"currentCompany": "Acme Inc",
"doNotContact": true,
"email": "alex@example.com",
"emailProvider": "alex@example.com",
"emailStatus": "alex@example.com",
"enriched": true,
"firstName": "Alex",
"followers": 12500,
"fullName": "Alex Rivera",
"gender": "example",
"image": "https://example.com/image.jpg",
"jobTitle": "Example title",
"lastName": "Rivera",
"linkedinId": "https://example.com/page",
"linkedinUrl": "https://example.com/page",
"location": "example",
"postalCode": "94107",
"provider": "a1b2c3d4"
},
"found": true,
"reason": "not_found"
}响应类型定义
interface PersonEnrichmentBettercontactResponse {
data: {
city?: string;
company?: {
about?: string;
addressCity?: string;
addressCountry?: string;
addressState?: string;
addressStreet?: string;
addressZipcode?: string;
companyId?: string;
countryCode?: string;
crunchbaseUrl?: string;
description?: string;
directionsUrl?: string;
domain?: string;
employees?: number;
employeesOnLinkedin?: number;
followers?: number;
founded?: number;
headquarters?: string;
headquartersAddress?: string;
headquartersCity?: string;
headquartersCountry?: string;
image?: string;
industryCode?: string;
legalId?: string;
legalName?: string;
linkedinId?: string;
linkedinUrl?: string;
name?: string;
organizationType?: string;
phone?: string;
size?: string;
website?: string;
};
connections?: number;
contactId?: string;
country?: string;
countryCode?: string;
currentCompany?: string;
doNotContact?: boolean;
email?: string;
emailProvider?: string;
emailStatus?: string;
enriched: boolean;
firstName?: string;
followers?: number;
fullName?: string;
gender?: string;
image?: string;
jobTitle?: string;
lastName?: string;
linkedinId?: string;
linkedinUrl?: string;
location?: string;
postalCode?: string;
provider?: string;
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/person_enrichment.bettercontact
curl -X POST https://api.getanyapi.com/v1/run/person_enrichment.bettercontact \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"companyDomain":"stripe.com","firstName":"Patrick","lastName":"Collison","linkedinUrl":"https://www.linkedin.com/in/patrickcollison"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| firstName | string | "Patrick"联系人的名字。 |
| lastName | string | "Collison"联系人的姓氏。 |
| company | string | 雇主名称,用于没有域名时。 |
| companyDomain | string | "stripe.com"雇主域名,例如 stripe.com。这是瀑布式查找中最强的公司信号。 |
| customFields | string | 任意标识符,会原样随结果返回,便于把结果关联到你自己的记录。 |
| linkedinUrl | string | "https://www.linkedin.com/in/patrickcollison"联系人的 LinkedIn 主页 URL,可提高匹配率。 |
| 响应 | ||
| data | object | The matched contact, or null when the waterfall found none. |
| data.city | string | City. |
| data.company | object | The contact's employer. |
| data.company.about | string | Company about text. |
| data.company.addressCity | string | Address city. |
| data.company.addressCountry | string | Address country. |
| data.company.addressState | string | Address state or region. |
| data.company.addressStreet | string | Street address. |
| data.company.addressZipcode | string | Address postal code. |
| data.company.companyId | string | BetterContact's own company identifier. |
| data.company.countryCode | string | ISO 3166-1 alpha-2 country code. |
| data.company.crunchbaseUrl | string | Company Crunchbase profile URL. |
| data.company.description | string | Company description. |
| data.company.directionsUrl | string | Map directions URL for the office. |
| data.company.domain | string | Company domain. |
| data.company.employees | integer | Employees BetterContact counts. |
| data.company.employeesOnLinkedin | integer | Employees LinkedIn shows for the company. |
| data.company.followers | integer | LinkedIn follower count. |
| data.company.founded | integer | Year the company was founded. |
| data.company.headquarters | string | Headquarters as one display string. |
| data.company.headquartersAddress | string | Headquarters street address. |
| data.company.headquartersCity | string | Headquarters city. |
| data.company.headquartersCountry | string | Headquarters country. |
| data.company.image | string | Company logo URL. |
| data.company.industryCode | string | Industry classification code. |
| data.company.legalId | string | Company registration number. |
| data.company.legalName | string | Registered legal name. |
| data.company.linkedinId | string | Company LinkedIn numeric id. |
| data.company.linkedinUrl | string | Company LinkedIn page URL. |
| data.company.name | string | Company name. |
| data.company.organizationType | string | Organization type. |
| data.company.phone | string | Company switchboard number. |
| data.company.size | string | Employee headcount band. |
| data.company.website | string | Company website URL. |
| data.connections | integer | LinkedIn connection count. |
| data.contactId | string | BetterContact's own contact identifier. |
| data.country | string | Country. |
| data.countryCode | string | ISO 3166-1 alpha-2 country code. |
| data.currentCompany | string | Current employer as BetterContact names it. |
| data.doNotContact | boolean | True when the contact is on a do-not-contact list. |
| data.email | string | The email address the waterfall settled on. |
| data.emailProvider | string | Mailbox provider behind the address, e.g. Google. |
| data.emailStatus | string | Deliverability verdict for the address, e.g. valid, catch_all_safe, catch_all_not_safe, undeliverable, not_found. |
| data.enriched | boolean | True when the waterfall matched a contact. A false answer is a legitimate miss and is not billed. |
| data.firstName | string | First name. |
| data.followers | integer | LinkedIn follower count. |
| data.fullName | string | Contact's full name. |
| data.gender | string | Gender recorded for the contact. |
| data.image | string | Contact's profile picture URL. |
| data.jobTitle | string | Current job title. |
| data.lastName | string | Last name. |
| data.linkedinId | string | Contact's LinkedIn numeric id. |
| data.linkedinUrl | string | Contact's LinkedIn profile URL. |
| data.location | string | Location as one display string. |
| data.postalCode | string | Postal code. |
| data.provider | string | Which data source in the waterfall produced the address. |
| found | boolean | False when the waterfall matched no contact. |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0828 |
| 价格(/千次请求) | USD | US$82.80 |
常见问题
关于 Person Enrichment Bettercontact API
AnyAPI 的 Person Enrichment Bettercontact API 只需一次 POST 请求 /v1/run/person_enrichment.bettercontact,就以统一格式的 JSON 返回 Person Enrichment 数据。通过 BetterContact 的瀑布式邮箱查找处理一位联系人,输入姓名加公司域名或 LinkedIn URL,返回最终命中的邮箱及其可送达性判定、找到它的服务商,以及雇主记录。只对匹配成功的联系人扣费。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$82.80 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Person Enrichment Bettercontact API 调用中有 100.0% 成功,响应时间中位数为 110.1 秒,共测量 3 次调用。
费用:每千次请求 US$82.80 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
通过 BetterContact 的瀑布式邮箱查找处理一位联系人,输入姓名加公司域名或 LinkedIn URL,返回最终命中的邮箱及其可送达性判定、找到它的服务商,以及雇主记录。只对匹配成功的联系人扣费。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 Person Enrichment Bettercontact API 调用中有 100.0% 成功,响应时间中位数为 110.1 秒,共测量 3 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。