people_search_id とマッチした人物のプロフィールが返却されます — 検索を先に走らせる必要はありません。
Contact Lookup を使う場面
識別子を持っていて、対応する人物を見つけたいときに使用します：- 受信箱に届いたメール — 送信者は誰、どの会社、肩書は何？
- 営業ラインに鳴った電話番号 — 既知の連絡先と突き合わせる
- 名前 + 会社名のみで Pubrio ID のないリードの CSV — 一気に
people_search_idに解決 email + nameを含むフォーム送信 — 完全な連絡先レコードへエンリッチ
people_search_id（または LinkedIn URL）からその人物のメール + 電話を取りたい場合は、人物リディームを使ってください — 順方向の処理です。
2 つの呼び出し形式
両エンドポイントとも、各レコードに対して同じ
match メタデータを返します（下記 マッチメタデータ を参照）。
クイックスタート
マッチモード
人物のマッチ方法は 2 通りです：完全一致 — メールまたは電話で
デフォルト動作です。email または phone を渡します。Pubrio は正規化済みの連絡先値で照合します。ヒットした場合 match.confidence は常に "exact" です。
類似度マッチ — 姓名 + ドメインまたは会社名で
確定的な識別子がない場合、類似度マッチにフォールバックできます。first_name、last_name に加え、domain か company のいずれか、そして is_enable_similarity_search: true を指定します。
domain 未指定時は会社名）配下で名前の近さを基に候補をランク付けします。ヒットしたレコードには match.confidence: "similarity_domain" または "similarity_company" が付くため、確実性で絞り込めます。
両者の併用も可能です：メールと姓名 + ドメインを同時に渡せます。完全一致のメールが優先され、メールが解決できないときに限り名前フィールドがフォールバックとして使われます。
マッチメタデータ
返却される各レコードには、どのようにマッチしたかを示すmatch オブジェクトが含まれます：
match.confidence で下流の動作を制御できます。例えば、exact のみシーケンスへ自動登録し、similarity_* は手動レビューに回す、など。
一括ルックアップ
サブスクリプションのバルク上限まで 1 リクエストで送信できます。各エントリは単一ルックアップのリクエストボディと同じ識別子を受け付けます。クレジット消費
課金対象の 1 マッチにつき 1 クレジット。 具体的には：- マッチ成功（完全一致または類似度）→ 1 クレジット
- マッチなし → 0 クレジット
- バッチ内の重複入力 → 0 クレジット（解決は 1 回、課金は 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 は検証済みのメールと電話を返しますか？
Contact Lookup は検証済みのメールと電話を返しますか？
いいえ — Contact Lookup が返すのは人物プロフィール（
people_search_id、名前、会社、ドメイン、肩書 など）とマッチメタデータです。検証済みの連絡先そのものを取得するには、返却された people_search_id を Redeem に渡してください。similarity_domain と similarity_company の違いは？
similarity_domain と similarity_company の違いは？
similarity_domain は名前マッチを既知の企業ドメインに紐付けたもの — 類似度ティアの中で最も信頼性が高いです。similarity_company は標準ドメインのない会社名にアンカーしたもの — 同名の無関係な会社が複数存在し得るため、若干信頼性は劣ります。マッチしなかった入力に課金されますか？
マッチしなかった入力に課金されますか？
いいえ。マッチしなかった入力はレスポンスから静かに除外され、課金もされません。
同じメールをバッチで 2 回送るとどうなりますか？
同じメールをバッチで 2 回送るとどうなりますか？
重複はサーバ側で検出され、ルックアップは 1 回だけ実行され、課金も 1 回のみです。重複エントリはレスポンスで
match.is_duplicate_input: true とフラグが付きます。バッチサイズの上限は？
バッチサイズの上限は？
上限はサブスクリプション設定の
people_contact_enrichment_bulk_size で決まります。多くのプランは 1 コール 100+ を許可。さらに高い上限が必要な場合はお問い合わせください。LinkedIn URL でルックアップできますか？
LinkedIn URL でルックアップできますか？
Contact Lookup ではできません。LinkedIn プロフィールがあり、解決と連絡先取得を 1 コールで完結させたい場合は、
linkedin_url を伴って Redeem を使用してください。国際電話番号はどう扱われますか？
国際電話番号はどう扱われますか？
電話は正規化形式で照合されます。国際表記（E.164）が最も信頼できる入力です。国を推定できる場合は国内表記でも一致しますが、E.164（
+15551234567）であれば曖昧さが排除されます。関連ページ
人物リディーム
順方向：既知の
people_search_id または LinkedIn URL の人物について、クレジット消費でメール + 電話をアンロック。People Search
職種／会社／地域などのフィルターに合致する人物を検索。
People Lookup
既知の識別子から単一人物の完全プロフィールを取得。
料金
全エンドポイントのクレジット消費をプラン別に一覧。