跳转到主要内容
POST
/
redeem
/
people
/
contact
/
lookup
/
batch
批量通过联系标识查找人员
curl --request POST \
  --url https://api.pubrio.com/redeem/people/contact/lookup/batch \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "peoples": [
    {
      "email": "[email protected]"
    },
    {
      "first_name": "John",
      "last_name": "Smith",
      "domain": "example.com"
    }
  ],
  "is_enable_similarity_search": true,
  "profile_id": 123
}
'
{
  "data": {
    "profile": {
      "credit": 450374,
      "topup_credit": 235236,
      "total_credit_cost": 2
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "people_name": "King Lai",
        "company_name": "Pubrio",
        "domain": "pubrio.com",
        "match": {
          "confidence": "exact",
          "input": {
            "value": "[email protected]",
            "type": "email-work"
          },
          "is_duplicate_input": false
        }
      },
      {
        "people_search_id": "1c4f0a9d-9a8e-4ab0-9b07-2cd09c4a3a6b",
        "people_name": "John Smith",
        "company_name": "Example",
        "domain": "example.com",
        "match": {
          "confidence": "similarity_domain",
          "input": {
            "value": "example.com",
            "type": "domain"
          },
          "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
peoples
object[]
必填

查询规格数组。每个条目接受与单条查询请求体相同的标识符(emailphone,或在启用相似度搜索时使用 first_name + last_name + domain/company)。受订阅计划的批量上限约束。

示例:
[
{ "email": "[email protected]" },
{
"first_name": "John",
"last_name": "Smith",
"domain": "example.com"
}
]

设为 true 时,若未找到精确匹配的邮箱/电话,将回退到基于姓名的相似度匹配。需要提供 first_namelast_name 以及 domaincompany

示例:

true

profile_id
integer

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

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

响应

成功响应,包含匹配到的人员及每条记录的匹配元数据。

data
object

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