Logo
Section 1 / 3

获取人员详情

学习并练习如何使用 Clearbit 的人员 API 获取人员的基本信息。

导入

获取人员详情

学习并练习如何使用 Clearbit 的人员 API 获取人员的基本信息。

如果消费者对我们公司提供的服务感兴趣，我们很可能会迎来新的注册用户。然而，只有经过身份验证的用户注册才有价值，虚假注册则无用。我们如何判断这一点？一种方法是花费大量时间调查用户，另一种更高效的方法是使用 Clearbit 的增强 API。该 API 提供三个接口：

  1. 人员 API
  2. 公司 API
  3. 综合 API

Course Image
...
人员端点

代码示例

1https://person.clearbit.com/v2/people/find?email={person_email}
字段名类型必填说明
emailstring是用于查找人员信息的电子邮件地址。
given_namestring否人员的名（名字）。
family_namestring否人员的姓（姓氏）——提供此参数可提高匹配准确率和结果可靠性。
ip_addressstring否目标人员的 IP 地址——提供此参数可提高匹配准确率和结果可靠性。
locationstring否人员所在的城市或国家。
companystring否人员所属雇主名称（通常是公司名），例如 Google。
company_domainstring否人员所属雇主的域名，例如 google.com。
linkedinstring否人员 LinkedIn 个人主页的 URL。
twitterstring否与人员关联的 Twitter 账号。
facebookstring否人员 Facebook 个人主页的 URL。
webhook_urlstring否用于接收可能延迟的结果的 Webhook 地址。
webhook_idstring否Webhook 请求的自定义标识符（如有）。
subscribeboolean否设置为 True 可接收人员信息更新或变更的通知。
suppressionstring否用于排除某些国家的数据。例如设置为 us 会排除美国的数据；设置为 us_strict 则会排除美国数据以及无国家信息的数据。
电子邮件地址
andrew@airbnb.com
sundar@google.com
marc@salesforce.com
fahim@example.com
1import json
2import requests
3from pprint import pprint
4
5url = "https://person.clearbit.com/v2/people/find?"
6
7params = {
8    'email': '{{EMAIL}}'
9}
10
11headers = {
12    'Content-Type': 'application/json',
13    'Authorization': 'Bearer {{API_KEY}}'
14}
15
16response = requests.request("GET", url, headers=headers, params=params)
17print(json.dumps(response.json(), indent=4))
字段名类型说明
idstringClearbit 中与该人员关联的内部 ID。
nameobject包含人员姓名信息的对象，包括名字、姓氏或其他相关名称。
locationstringClearbit 能获取到的最准确的人员所在地信息。
geoobject包含人员地理信息的对象，如纬度、经度、城市、州、街道编号等。
biostringClearbit 能获取到的最准确的人员简介。
sitestring人员的个人网站（如有）。
avatarstringClearbit 能获取到的最佳人员头像图片链接。
employmentobject包含人员就业信息的对象。

Clearbit 的人员查询采用的是模糊匹配而非精确匹配，因此可能会返回一些不准确的结果。Clearbit 允许我们协助其修正这些问题。我们可以使用其 **标记人员** 接口，将某人的信息标记为错误，并提交正确的属性值，以便他们进行修复。收到请求后，Clearbit 会进行审核并根据需要更新数据。标记人员是一个 `POST` 请求。

Course Image

代码示例

1https://person.clearbit.com/v1/people/{person_id}/flag
字段名类型必填说明
given_namestring否人员的名（名字）。
family_namestring否人员的姓（姓氏）。
employment_titlestring否人员在公司中的职位名称。
facebook_handlestring否人员的 Facebook ID 或用户名。
github_handlestring否人员的 GitHub 用户名。
twitter_handlestring否人员在 Twitter 上的用户名。
linkedin_handlestring否人员的 LinkedIn 链接。
googleplus_handlestring否人员的 Google+ 用户名。
1import json
2import requests
3from pprint import pprint
4
5url = "https://person.clearbit.com/v1/people/{{ID}}/flag"
6
7headers = {
8    'Content-Type': 'application/json',
9    'Authorization': 'Bearer {{API_KEY}}'
10}
11
12response = requests.request("POST", url, headers=headers)
13
14if response.status_code == 200:
15    print("请求已成功接收，Clearbit 将处理该问题。")
16else:
17    print("未找到该人员。")

简介

获取公司详情