> ## 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_search_id` と基本情報、加えて一致方法を示す `match` メタデータを返します。課金対象の一致 1 件につき 1 クレジットを消費します。 ## OpenAPI ````yaml jp-openapi POST /redeem/people/contact/lookup openapi: 3.0.0 info: description: >- Pubrio API はマーケット拡大インテリジェンスを提供します——企業の新市場参入を捉えるリアルタイムシグナルと、その基盤となる企業・人物データ。アカウントやコンタクトの検索・ルックアップ・エンリッチメントに加え、200+ 市場にわたる種別・日付付きの動きシグナルを購読できます。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ja/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ja/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: ワークスペースプロフィール情報と使用統計 - name: Enrichment description: 詳細なB2Bデータで人物・企業レコードをエンリッチメント - name: Lookalike description: 指定した企業に類似する企業を検索 - name: Search description: フィルターを使用して人物、企業、求人、ニュース、広告を検索 - name: Lookup description: 特定の人物、企業、求人、ニュース、広告、テクノロジーの詳細情報を検索 - name: LinkedIn description: LinkedInプロフィールURLから人物・企業データを検索 - name: Redeem description: クレジットを消費して人物の連絡先情報をアンロック（単件・バッチ） - name: Channels description: アウトリーチチャネルテンプレートの管理（作成・更新・削除・一覧） - name: Monitor description: Webhook、統計、処理を含むデータモニターの作成と管理 - name: Filters description: 検索パラメータで使用可能なフィルター値を取得（テクノロジー、地域、バーティカルなど） - name: API Keys description: APIキーのリクエストログと使用状況分析を表示 - name: Insights description: 企業のシグナル集計インサイト(採用、ニュース、広告)。 - name: Export description: 一括データエクスポート(クレジット消費)。 - name: Expansion description: '企業の市場拡大インテリジェンス: シグナル、ステージ、市場、エクスポート。' externalDocs: description: >- Pubrio API は、コンタクトおよびアカウント情報の検索・プレビュー・エンリッチメントに利用できます。Pubrio データベースは、豊富な B2B 連絡先データとセールスインテリジェンスを提供します。 url: https://docs.pubrio.com paths: /redeem/people/contact/lookup: post: tags: - Redeem summary: 連絡先識別子で人物を検索 description: >- メール、電話、または（類似度検索を有効にした場合）名 + 姓 + ドメインまたは会社名で人物を逆引き検索します。一致した人物の `people_search_id` と基本情報、加えて一致方法を示す `match` メタデータを返します。課金対象の一致 1 件につき 1 クレジットを消費します。 operationId: redeem_people_contact_lookup parameters: [] requestBody: required: true content: application/json: schema: type: object properties: email: $ref: '#/components/schemas/contact_lookup_email' phone: $ref: '#/components/schemas/contact_lookup_phone' first_name: $ref: '#/components/schemas/contact_lookup_first_name' last_name: $ref: '#/components/schemas/contact_lookup_last_name' domain: $ref: '#/components/schemas/contact_lookup_domain' company: $ref: '#/components/schemas/contact_lookup_company' is_enable_similarity_search: $ref: >- #/components/schemas/contact_lookup_is_enable_similarity_search profile_id: $ref: '#/components/schemas/profile_id' anyOf: - title: メールアドレス required: - email - title: 電話番号 required: - phone - title: 氏名 + ドメイン(類似度マッチ) required: - first_name - last_name - domain - is_enable_similarity_search - title: 氏名 + 会社名(類似度マッチ) required: - first_name - last_name - company - is_enable_similarity_search responses: '200': description: 一致した人物と一致メタデータを含む正常応答。 content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: 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: king.lai@pubrio.com type: email-work is_duplicate_input: false '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: contact_lookup_email: type: string format: email example: person@example.com description: 検索する仕事用または個人のメールアドレス。システムは照合前に大文字小文字と空白を正規化します。 contact_lookup_phone: type: string example: '+15551234567' description: 検索する電話番号。国際形式（E.164）を推奨します。 contact_lookup_first_name: type: string example: King description: >- 名（ファーストネーム）。`is_enable_similarity_search` が `true` のとき、`last_name` および `domain` または `company` と併せて使用します。 contact_lookup_last_name: type: string example: Lai description: >- 姓（ラストネーム）。`is_enable_similarity_search` が `true` のとき、`first_name` および `domain` または `company` と併せて使用します。 contact_lookup_domain: type: string example: pubrio.com description: >- 会社ドメイン。`is_enable_similarity_search` が `true` の場合に、`first_name` + `last_name` と組み合わせて類似度検索のアンカーとして使用します。 contact_lookup_company: type: string example: Pubrio description: >- 会社名。`is_enable_similarity_search` が `true` で `domain` が未指定の場合に、`first_name` + `last_name` と組み合わせて類似度検索のアンカーとして使用します。 contact_lookup_is_enable_similarity_search: type: boolean default: false example: true description: >- `true` の場合、メール／電話の完全一致が見つからないときに、名前ベースの類似度マッチにフォールバックします。`first_name`、`last_name`、および `domain` または `company` が必要です。 profile_id: type: integer description: >- オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。 data: type: object nullable: true description: エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。 responses: general_error: description: リクエストエラー。リクエストの形式が不正であるか、無効なパラメータが含まれています。エラーコードとメッセージを確認してください。 content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。 type: string details: type: object rate_limit_error: description: レート制限超過。一定期間内に多すぎるリクエストが送信されました。レート制限ウィンドウがリセットされた後に再試行してください。 content: application/json: schema: required: - error type: object properties: error: example: クライアントはしばらく待ってから再試行することが推奨されます。 type: string server_error: description: 内部サーバーエラー。サーバーで予期しないエラーが発生しました。エラーが続く場合はサポートにお問い合わせください。 content: application/json: schema: required: - error type: object properties: error: example: レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの [設定](https://dashboard.pubrio.com/#/settings/) 画面から発行できます。 in: header ````