メインコンテンツへスキップ
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[]
必須

検索条件の配列。各エントリーは単一検索のリクエストボディと同じ識別子（email、phone、または類似度検索が有効な場合は first_name + last_name + domain／company）を受け付けます。サブスクリプションの一括処理上限が適用されます。

例:
[
  { "email": "[email protected]" },
  {
    "first_name": "John",
    "last_name": "Smith",
    "domain": "example.com"
  }
]
​
is_enable_similarity_search
boolean
デフォルト:false

true の場合、メール／電話の完全一致が見つからないときに、名前ベースの類似度マッチにフォールバックします。first_name、last_name、および domain または company が必要です。

例:

true

​
profile_id
integer

オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。

レスポンス

一致した人物とレコードごとの一致メタデータを含む正常応答。

​
data
object

エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。