跳转到主要内容
POST
/
redeem
/
people
/
contact
/
lookup
通过联系标识查找人员
curl --request POST \
  --url https://api.pubrio.com/redeem/people/contact/lookup \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "email": "[email protected]",
  "phone": "+15551234567",
  "first_name": "King",
  "last_name": "Lai",
  "domain": "pubrio.com",
  "company": "Pubrio",
  "is_enable_similarity_search": true,
  "profile_id": 123
}
'
{
  "data": {
    "profile": {
      "credit": 450375,
      "topup_credit": 235236,
      "total_credit_cost": 1
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "first_name": "King",
        "last_name": "Lai",
        "people_name": "King Lai",
        "company_name": "Pubrio",
        "domain": "pubrio.com",
        "match": {
          "confidence": "exact",
          "input": {
            "value": "[email protected]",
            "type": "email-work"
          },
          "is_duplicate_input": false
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt

Use this file to discover all available pages before exploring further.

授权

​
pubrio-api-key
string
header
必填

一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 设置 部分创建该令牌。

请求体

application/json
​
email
string<email>
必填

要查找的工作或个人电子邮箱地址。系统会在匹配前规范化大小写和空白字符。

示例:

"[email protected]"

​
phone
string

要查找的电话号码。建议使用国际格式（E.164）。

示例:

"+15551234567"

​
first_name
string

名字。当 is_enable_similarity_search 为 true 时，与 last_name 以及 domain 或 company 配合使用。

示例:

"King"

​
last_name
string

姓氏。当 is_enable_similarity_search 为 true 时，与 first_name 以及 domain 或 company 配合使用。

示例:

"Lai"

​
domain
string

公司域名。当 is_enable_similarity_search 为 true 时，与 first_name + last_name 一起作为相似度搜索的锚点。

示例:

"pubrio.com"

​
company
string

公司名称。当 is_enable_similarity_search 为 true 且未提供 domain 时，与 first_name + last_name 一起作为相似度搜索的锚点。

示例:

"Pubrio"

​
is_enable_similarity_search
boolean
默认值:false

设为 true 时，若未找到精确匹配的邮箱/电话，将回退到基于姓名的相似度匹配。需要提供 first_name、last_name 以及 domain 或 company。

示例:

true

​
profile_id
integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

响应

成功响应，包含匹配到的人员及匹配元数据。

​
data
object

响应信息取决于具体接口。