用已有邮箱、个人社交主页，或完整姓名加已知背景，匹配一条个人记录。匹配成功后，可读取来源提供的姓名、职业信息与工作经历，并附1–10分的匹配置信分数。Agent 再依据可用资料整理人物摘要。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
People Data Labs
用已有邮箱、个人社交主页，或完整姓名加已知背景，匹配一条个人记录。匹配成功后，可读取来源提供的姓名、职业信息与工作经历，并附1–10分的匹配置信分数。Agent 再依据可用资料整理人物摘要。
匹配到个人时，响应中的 data 包含其资料，并附 likelihood 分数。可用信息可能包括完整姓名、职位、公司信息与工作经历。你可选择返回字段，也可请求列出匹配上的输入名称。Agent 再整理取得的职业资料，并区分来源内容与自己的解读。
根据[LinkedIn 个人主页链接]或[工作邮箱]查找个人资料。概括可查到的职位和工作经历，核对是否找对人，并标出没有提供的信息。
匹配记录不等于独立确认身份、当前任职，或邮箱和电话仍可联系。资料范围取决于可用信息，未知属性可能为 null。提高分数门槛可能没有可接受的匹配；未匹配到，也不能据此认定这个人没有资料记录。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
个人匹配请求body | object | 选填 | 请求对象，包含个人的已知标识、匹配背景和返回设置。可用邮箱或个人主页等标识，也可用完整姓名配合已知工作、学校、地点或出生信息。 |
LinkedIn 个人 IDbody.lid | string | 选填 | 这个人的已知 LinkedIn ID，以字符串提供。它不同于个人社交主页链接及 PDL 持久 ID。 |
完整姓名body.name | string | 选填 | 个人完整姓名，包含名与姓。按姓名匹配时，还应提供至少一项已知公司、学校、地点、地址或出生信息。 |
已知邮箱body.email | string | 选填 | 这个人使用过的邮箱，用于匹配。作为标识使用，不等于验证邮箱目前仍可联系。 |
已知电话号码body.phone | string | 选填 | 这个人使用过的电话号码。PDL 输入说明要求以 + 和国家代码开头；它用于识别，不是可联系性检查。 |
PDL 个人持久 IDbody.pdl_id | string | 选填 | PDL 个人记录的持久 ID。提供后，只用这个 ID 匹配，其他匹配输入会被忽略。 |
返回内容缩进body.pretty | boolean | 选填 | 设为 true 时添加便于阅读的 JSON 缩进。默认 false，只调整格式。
|
居住地州或地区body.region | string | 选填 | 个人居住地的已知州或地区，用作匹配背景，可与完整姓名配合。 |
曾就读院校body.school | string | 选填 | 这个人曾就读大学或学院的已知名称、网站或社交主页，提供教育背景，不确认目前在读。 |
曾任职公司body.company | string | 选填 | 这个人曾工作公司的已知名称、网站或社交主页，用于辅助匹配，不要求该任职关系仍然有效。 |
居住地国家body.country | string | 选填 | 个人居住地的已知国家，用作匹配背景，不是搜索该国全部人员。 |
个人社交主页body.profile | string | 选填 | 这个人使用过的已知社交主页，例如 LinkedIn 个人页面。以一个字符串提供一条引用。 |
居住地城市或所在地body.locality | string | 选填 | 个人居住地的已知城市或所在地，可辅助区分同名或近似姓名的人。 |
居住位置文字body.location | string | 选填 | 用一个字符串描述个人居住位置，可从街道地址到国家名称。以已知信息作为匹配背景。 |
个人资料存在条件body.required | string | 选填 | 用 AND、OR 和括号组合可用顶层个人资料字段的存在条件。排除已用作匹配输入的字段及此请求无法返回的字段。此设置用于接受具备所需信息的匹配，不会生成缺失数据。 |
姓body.last_name | string | 选填 | 已知姓氏。按姓名匹配时，与 first_name 及至少一项已知背景配合提供。 |
文字标题式大小写body.titlecase | boolean | 选填 | 设为 true 时，返回文字按英文标题式大小写显示。默认 false，只改变显示形式，不改变匹配对象。
|
出生年份或日期body.birth_date | string | 选填 | 已知出生年份，或写成 YYYY-MM-DD 的完整出生日期。以字符串提供，作为识别个人的背景。 |
邮箱哈希body.email_hash | string | 选填 | 个人邮箱的已知 SHA-256 或 MD5 哈希，用作匹配标识，不是还原邮箱地址的请求。 |
名body.first_name | string | 选填 | 已知名字。按姓名请求时，还需提供 last_name，以及已知公司、学校、地点、地址或出生信息。 |
中间名body.middle_name | string | 选填 | 已知中间名，如适用。可补充姓名背景，但不能代替按姓名匹配所用的名与姓。 |
居住地邮编body.postal_code | string | 选填 | 已知居住地邮编，以文字提供。PDL 输入说明在省略 country 时按美国邮编处理；已知时可提供国家以明确地点。 |
返回或排除的个人字段body.data_include | string | 选填 | 用逗号列出要返回的个人字段，嵌套字段可用点号。开头一个减号可排除后面的字段列表；空字符串隐藏全部个人资料。省略则请求完整的可用个人资料。 |
最低匹配分数body.min_likelihood | integer | 选填 | 1–10的整数，默认2。匹配达到此门槛才接受。更严格的门槛可能没有匹配结果；分数不是百分比。
|
居住地街道地址body.street_address | string | 选填 | 个人居住地的已知街道地址，以文字提供一条地址作为匹配背景。 |
返回匹配输入名称body.include_if_matched | boolean | 选填 | 设为 true 时返回 matched，列出与资料吻合的输入名称。默认 false，不代表核实了所有提供的信息。
|
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"lid": {
"type": "string"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"pdl_id": {
"type": "string"
},
"pretty": {
"type": "boolean",
"default": false
},
"region": {
"type": "string"
},
"school": {
"type": "string"
},
"company": {
"type": "string"
},
"country": {
"type": "string"
},
"profile": {
"type": "string"
},
"locality": {
"type": "string"
},
"location": {
"type": "string"
},
"required": {
"type": "string"
},
"last_name": {
"type": "string"
},
"titlecase": {
"type": "boolean",
"default": false
},
"birth_date": {
"type": "string"
},
"email_hash": {
"type": "string"
},
"first_name": {
"type": "string"
},
"middle_name": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"data_include": {
"type": "string"
},
"min_likelihood": {
"type": "integer",
"default": 2,
"maximum": 10,
"minimum": 1
},
"street_address": {
"type": "string"
},
"include_if_matched": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
先选择匹配方式，再补充背景。个人社交主页、邮箱、电话、邮箱哈希、LinkedIn ID 或 PDL ID 可用于识别目标。若用完整姓名或分别提供名与姓，还需要公司、学校、地点、街道地址、城市、地区、国家、邮编或出生信息中的至少一项。仅中间名不能代替这个组合。提供 pdl_id 时，只用它匹配；返回内容设置仍然有效。
个人资料在响应的 data 中，与 likelihood 一起阅读。来源提供相应信息时，可查看姓名、职位、公司信息与工作经历；部分属性可能未知。输入公司可指这个人曾工作过的公司，学校可指曾就读的院校。这些输入本身不确认当前任职或在读状态。
用 data_include 选择资料。省略时请求完整的可用个人资料；字段名用逗号分隔，嵌套字段可用点号选择。开头加一个减号，可排除后面的字段列表；空字符串会隐藏全部个人资料。返回 null 表示来源没有该属性数据，被排除的字段则未进入请求展示范围。
required 要求某些顶层个人资料存在才接受匹配，可用 AND、OR 和括号组合字段名。所选字段需可供此请求返回，且不能包含已用作匹配输入的字段。例如，用 email 匹配并设置 required=experience，要求有可用工作经历，不会生成缺失经历，也不是验证邮箱。
likelihood 是1–10分的匹配置信分数；min_likelihood 默认2，提高门槛可能排除较弱匹配。include_if_matched 默认关闭，开启后可取得与资料吻合的输入名称。pretty 和 titlecase 也默认关闭，用于调整显示格式。Agent 可另行整理简报，但分数和格式都不能证明所有属性准确或仍然最新。
例如填写[目前职位和工作经历]来整理职业简介；想全面了解时，可以要求[所有可提供的资料]。来源没有的信息无法补出来。
根据[LinkedIn 个人主页链接]或[工作邮箱]查找个人资料。概括可查到的职位和工作经历，核对是否找对人，并标出没有提供的信息。
核对返回的姓名、工作和公司信息是否与你已知的情况相符。如果不确定，可补充[公司、学校或所在地]，或提供更具体的个人主页链接。助手只整理实际查到的信息，并说明缺少的内容。
姓名匹配需要完整姓名或名与姓，并配合至少一项已知公司、学校、地点、地址或出生信息。也可改用已知邮箱、电话、社交主页、邮箱哈希、LinkedIn ID 或 PDL ID。应提供已有事实，不猜背景来凑出匹配。
profile 是个人社交主页引用，lid 是 LinkedIn 个人 ID，pdl_id 是 PDL 个人记录的持久 ID，它们是不同标识。提供 pdl_id 时，只用它匹配，其他匹配输入会被忽略。
这些值依据个人使用过的信息识别资料。匹配不是邮箱送达测试、电话可联系性检查，也不确认当前任职。应按来源背景阅读有返回的联系信息，不把匹配输入当作刚验证过的联系方式。
接受资料前，会要求更强的匹配把握程度。设置范围1–10，默认2；更严格的门槛可能没有可接受的结果。likelihood 不是准确率百分比，高分也不会独立核实每项工作经历。
当 experience 可供此请求返回、且未被用作匹配输入时，可设置 required=experience。另用 data_include 选择展示字段。存在条件用于选择有相应信息的资料，不会生成工作经历，也不确认其中职位仍是当前任职。
返回 null 表示 PDL 没有该属性的数据。字段选择也会省略属性，data_include 为空字符串时隐藏全部个人资料。这些状态不证明这个人没有工作、教育或其他实际信息。Agent 摘要应区分未知项与主动省略的信息。