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"}'
字段类型示例值
请求体
firstNamestring"Patrick"联系人的名字。
lastNamestring"Collison"联系人的姓氏。
companystring雇主名称,用于没有域名时。
companyDomainstring"stripe.com"雇主域名,例如 stripe.com。这是瀑布式查找中最强的公司信号。
customFieldsstring任意标识符,会原样随结果返回,便于把结果关联到你自己的记录。
linkedinUrlstring"https://www.linkedin.com/in/patrickcollison"联系人的 LinkedIn 主页 URL,可提高匹配率。
响应
dataobjectThe matched contact, or null when the waterfall found none.
data.citystringCity.
data.companyobjectThe contact's employer.
data.company.aboutstringCompany about text.
data.company.addressCitystringAddress city.
data.company.addressCountrystringAddress country.
data.company.addressStatestringAddress state or region.
data.company.addressStreetstringStreet address.
data.company.addressZipcodestringAddress postal code.
data.company.companyIdstringBetterContact's own company identifier.
data.company.countryCodestringISO 3166-1 alpha-2 country code.
data.company.crunchbaseUrlstringCompany Crunchbase profile URL.
data.company.descriptionstringCompany description.
data.company.directionsUrlstringMap directions URL for the office.
data.company.domainstringCompany domain.
data.company.employeesintegerEmployees BetterContact counts.
data.company.employeesOnLinkedinintegerEmployees LinkedIn shows for the company.
data.company.followersintegerLinkedIn follower count.
data.company.foundedintegerYear the company was founded.
data.company.headquartersstringHeadquarters as one display string.
data.company.headquartersAddressstringHeadquarters street address.
data.company.headquartersCitystringHeadquarters city.
data.company.headquartersCountrystringHeadquarters country.
data.company.imagestringCompany logo URL.
data.company.industryCodestringIndustry classification code.
data.company.legalIdstringCompany registration number.
data.company.legalNamestringRegistered legal name.
data.company.linkedinIdstringCompany LinkedIn numeric id.
data.company.linkedinUrlstringCompany LinkedIn page URL.
data.company.namestringCompany name.
data.company.organizationTypestringOrganization type.
data.company.phonestringCompany switchboard number.
data.company.sizestringEmployee headcount band.
data.company.websitestringCompany website URL.
data.connectionsintegerLinkedIn connection count.
data.contactIdstringBetterContact's own contact identifier.
data.countrystringCountry.
data.countryCodestringISO 3166-1 alpha-2 country code.
data.currentCompanystringCurrent employer as BetterContact names it.
data.doNotContactbooleanTrue when the contact is on a do-not-contact list.
data.emailstringThe email address the waterfall settled on.
data.emailProviderstringMailbox provider behind the address, e.g. Google.
data.emailStatusstringDeliverability verdict for the address, e.g. valid, catch_all_safe, catch_all_not_safe, undeliverable, not_found.
data.enrichedbooleanTrue when the waterfall matched a contact. A false answer is a legitimate miss and is not billed.
data.firstNamestringFirst name.
data.followersintegerLinkedIn follower count.
data.fullNamestringContact's full name.
data.genderstringGender recorded for the contact.
data.imagestringContact's profile picture URL.
data.jobTitlestringCurrent job title.
data.lastNamestringLast name.
data.linkedinIdstringContact's LinkedIn numeric id.
data.linkedinUrlstringContact's LinkedIn profile URL.
data.locationstringLocation as one display string.
data.postalCodestringPostal code.
data.providerstringWhich data source in the waterfall produced the address.
foundbooleanFalse 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.
价格
每次请求价格USDUS$0.0828
价格(/千次请求)USDUS$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 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。