メインコンテンツへスキップ
POST
/
redeem
/
people
cURL
curl --request POST \
  --url https://api.pubrio.com/redeem/people \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "people_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "people_contact_types": [
    "email-personal",
    "email-work",
    "phone"
  ],
  "profile_id": 123,
  "linkedin_url": "http://www.linkedin.com/in/king-lai-605382b7"
}
'
{
  "data": {
    "profile": {
      "credit": 450376,
      "topup_credit": 235237,
      "total_credit_cost": 45
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "emails": [
          {
            "value": "[email protected]",
            "type": "email-personal",
            "status": null
          },
          {
            "value": "[email protected]",
            "type": "email-work",
            "status": "Verified"
          }
        ],
        "phones": [
          {
            "value": "+1123456789",
            "type": "phone",
            "status": null
          }
        ]
      }
    ]
  }
}

Authorizations

​
pubrio-api-key
string
header
required

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの 設定 画面から発行できます。

Body

application/json
​
people_search_id
string<uuid>
required

人物検索処理を対象とする一意の識別子です。

​
people_contact_types
enum<string>[]
required

取得する連絡先種別（勤務メール、個人メール、電話番号など）を制御するためのパラメーターで、1 つ以上を指定できます。

利用可能なオプション:
email-personal,
email-work,
phone
Example:
["email-personal", "email-work", "phone"]
​
profile_id
integer
required

リクエストを送信するチームを表す識別子です。この ID によって検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。

​
linkedin_url
string

個人の LinkedIn プロフィールを指す完全な URL です。値は http で始まり、linkedin.com/in/ または linkedin.com/pub/ を含んでいる必要があります。

Example:

"http://www.linkedin.com/in/king-lai-605382b7"

Response

関連する詳細情報を含む成功レスポンスです。

​
data
object

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