メインコンテンツへスキップ

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.

People Contact Lookup API は 「このメール／電話／名前は誰のものか？」 という問いに答えます。識別子を渡すだけで people_search_id とマッチした人物のプロフィールが返却されます — 検索を先に走らせる必要はありません。 
curl -X POST https://api.pubrio.com/redeem/people/contact/lookup \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]" }'

​
Contact Lookup を使う場面

識別子を持っていて、対応する人物を見つけたいときに使用します：
  • 受信箱に届いたメール — 送信者は誰、どの会社、肩書は何？
  • 営業ラインに鳴った電話番号 — 既知の連絡先と突き合わせる
  • 名前 + 会社名のみで Pubrio ID のないリードの CSV — 一気に people_search_id に解決
  • email + name を含むフォーム送信 — 完全な連絡先レコードへエンリッチ
逆に、people_search_id（または LinkedIn URL）からその人物のメール + 電話を取りたい場合は、人物リディームを使ってください — 順方向の処理です。

​
2 つの呼び出し形式

エンドポイント用途
POST /redeem/people/contact/lookup単一ルックアップ — リクエストごとに識別子 1 件。
POST /redeem/people/contact/lookup/batch一括ルックアップ — サブスクリプションのバルク上限まで、並列処理。
両エンドポイントとも、各レコードに対して同じ match メタデータを返します（下記 マッチメタデータ を参照）。

​
クイックスタート

curl -X POST https://api.pubrio.com/redeem/people/contact/lookup \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]" }'
レスポンス： 
{
  "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
        }
      }
    ]
  }
}

​
マッチモード

人物のマッチ方法は 2 通りです：

​
完全一致 — メールまたは電話で

デフォルト動作です。email または phone を渡します。Pubrio は正規化済みの連絡先値で照合します。ヒットした場合 match.confidence は常に "exact" です。 
{ "email": "[email protected]" }

{ "phone": "+15551234567" }

​
類似度マッチ — 姓名 + ドメインまたは会社名で

確定的な識別子がない場合、類似度マッチにフォールバックできます。first_name、last_name に加え、domain か company のいずれか、そして is_enable_similarity_search: true を指定します。 
{
  "first_name": "King",
  "last_name": "Lai",
  "domain": "pubrio.com",
  "is_enable_similarity_search": true
}
Pubrio はまず完全一致のメール／電話ヒットを試みます。見つからず、かつ類似度検索が有効な場合、企業ドメイン（domain 未指定時は会社名）配下で名前の近さを基に候補をランク付けします。ヒットしたレコードには match.confidence: "similarity_domain" または "similarity_company" が付くため、確実性で絞り込めます。 両者の併用も可能です：メールと姓名 + ドメインを同時に渡せます。完全一致のメールが優先され、メールが解決できないときに限り名前フィールドがフォールバックとして使われます。

​
マッチメタデータ

返却される各レコードには、どのようにマッチしたかを示す match オブジェクトが含まれます：
フィールド値意味
match.confidenceexactメール／電話の直接一致。最も確実。
similarity_domain既知の企業ドメインに紐づく姓名ベースのマッチ。
similarity_company会社名（ドメインなし）に紐づく姓名ベースのマッチ。
match.input{ value, type }該マッチを引き起こした入力識別子をそのままエコー。UI 上で「[email protected] でマッチ」のように表示できます。
match.is_duplicate_inputboolean同じ識別子がバッチ内で重複していた場合に true — ルックアップは 1 回のみ実行され、重複分は課金されません。
match.confidence で下流の動作を制御できます。例えば、exact のみシーケンスへ自動登録し、similarity_* は手動レビューに回す、など。

​
一括ルックアップ

サブスクリプションのバルク上限まで 1 リクエストで送信できます。各エントリは単一ルックアップのリクエストボディと同じ識別子を受け付けます。 
curl -X POST https://api.pubrio.com/redeem/people/contact/lookup/batch \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "peoples": [
      { "email": "[email protected]" },
      { "first_name": "John", "last_name": "Smith", "domain": "example.com" }
    ],
    "is_enable_similarity_search": true
  }'
一括は同期実行です — レスポンスは入力順で解決済みレコードを返却します。マッチしなかった入力はレスポンスから除外され（出現せず、課金もされません）。

​
クレジット消費

課金対象の 1 マッチにつき 1 クレジット。 具体的には：
  • マッチ成功（完全一致または類似度）→ 1 クレジット
  • マッチなし → 0 クレジット
  • バッチ内の重複入力 → 0 クレジット（解決は 1 回、課金は 1 回）
このため Contact Lookup は Redeem よりも 1 桁安いコストで使えます — 払っているのは人物の特定であって、連絡先のアンロックではありません。ルックアップ後にメール／電話も必要になったら、返ってきた people_search_id をリディームすれば OK です。

​
よくあるパターン

受信メールのエンリッチメント

すべての受信メールで送信者をルックアップ。会社名、肩書、people_search_id を CRM やヘルプデスクのビューに表示。

CSV → CRM 解決

名前 + 会社名 行の CSV を正準の people_search_id へ解決。完全一致しないものには自動的に類似度マッチを試行。

フォーム送信のエンリッチメント

マーケティングフォームの { email } を投げ込み、会社、肩書、スコアリングルートに使える Pubrio ID を取得。

ルックアップ → リディーム パイプライン

2 段階フロー：低コストルックアップ（1 クレジット）で人物を特定し、確信度しきい値以上のマッチに対してのみフルリディーム（5〜10 クレジット）。

​
FAQ

いいえ — Contact Lookup が返すのは人物プロフィール（people_search_id、名前、会社、ドメイン、肩書 など）とマッチメタデータです。検証済みの連絡先そのものを取得するには、返却された people_search_id を Redeem に渡してください。
similarity_domain は名前マッチを既知の企業ドメインに紐付けたもの — 類似度ティアの中で最も信頼性が高いです。similarity_company は標準ドメインのない会社名にアンカーしたもの — 同名の無関係な会社が複数存在し得るため、若干信頼性は劣ります。
いいえ。マッチしなかった入力はレスポンスから静かに除外され、課金もされません。
重複はサーバ側で検出され、ルックアップは 1 回だけ実行され、課金も 1 回のみです。重複エントリはレスポンスで match.is_duplicate_input: true とフラグが付きます。
上限はサブスクリプション設定の people_contact_enrichment_bulk_size で決まります。多くのプランは 1 コール 100+ を許可。さらに高い上限が必要な場合はお問い合わせください。
Contact Lookup ではできません。LinkedIn プロフィールがあり、解決と連絡先取得を 1 コールで完結させたい場合は、linkedin_url を伴って Redeem を使用してください。
電話は正規化形式で照合されます。国際表記（E.164）が最も信頼できる入力です。国を推定できる場合は国内表記でも一致しますが、E.164（+15551234567）であれば曖昧さが排除されます。

​
関連ページ

人物リディーム

順方向：既知の people_search_id または LinkedIn URL の人物について、クレジット消費でメール + 電話をアンロック。

People Search

職種／会社／地域などのフィルターに合致する人物を検索。

People Lookup

既知の識別子から単一人物の完全プロフィールを取得。

料金

全エンドポイントのクレジット消費をプラン別に一覧。