linkedin/
search-people

人物検索URLから公開LinkedInプロフィールの候補を収集し、正規化された基本情報、説明文、画像、所在地、Webサイト、アカウントのシグナル、取得可能な指標を返します。

LinkedIn Search People API

検索URLで指定
氏名ベースの検索
正規化されたアカウント
結果1件あたり1クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

LinkedIn Search People

LinkedIn Search Peopleは、送信された各人物検索URLの keywords の値を、氏名ベースのプロバイダークエリに変換します。結果は本人確認のレビューに使う公開プロフィールの候補であり、そのプロフィールが目的の人物のものであることを証明するものではなく、このエンドポイントはURLに含まれる企業、学校、所在地、業種、つながりのフィルターも再現しません。

LinkedIn Search People API の主な機能

  • 人物検索URLで指定パスが /search/results/people で始まる1つ以上の公開LinkedIn URLを送信します。
  • 明確な氏名のマッピングkeywords をデコードし、空白で区切られた最初のトークンを first_name に、残りのトークンを連結して last_name に割り当てます。
  • 候補プロフィールの検索手動での照合や、後で行うプロフィール単位の収集に使える、公開プロフィールURLと基本情報を受け取れます。
  • 正規化されたアカウントレコード安定した基本情報、説明文、画像、Webサイト、アカウント状態、所在地、指標、取得日時のフィールドを返します。
  • ソースに忠実なnull値取得できないフィールドは null のままにし、非公開の連絡先、職歴、学歴、スキル、本人であることの確度を推測しません。

LinkedIn Search People API のパラメータ

パラメータ必須説明
urls必須必須。http または https の公開LinkedIn URLのリストです。各ホストは linkedin.com またはLinkedInのサブドメインで、各パスは /search/results/people で始まる必要があります。氏名ベースの検索を確実に行うには keywords を含めてください。

LinkedIn Search People API の使い方

氏名ベースの人物検索URLを用意して非同期タスクを送信し、返されたすべての候補を確認します。

  1. 対象人物の氏名を含む keywords クエリ値を持つ、LinkedInの人物検索URLを作成します。
  2. urls を /v1/linkedin/search-people に POST し、返された task_id を保存します。
  3. タスクが終了ステータスになるまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら data.results.items を処理し、has_more が true の間は next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

LinkedIn Search People API の主なユースケース

  • プロフィールURLの特定: プロフィール単位の収集エンドポイントを使う前に、公開LinkedInプロフィールURLの候補を見つけます。
  • 手動での本人特定: 不確実性を残したまま、候補間で氏名、説明文、所在地、画像、URLを比較します。
  • 公開ディレクトリへの取り込み: 連絡先の補完や非公開の属性を約束することなく、正規化された候補アカウントをレビューキューに投入します。
  • 氏名の表記ゆれの調査: 慎重に選んだ氏名の表記ごとに個別に実行し、各取得時点で得られた公開候補を比較します。

LinkedIn Search People API 活用のヒント

  • 必ず意味のある keywords クエリ値を含めてください。これがないと、URLが有効でも空の氏名行が作成され、プロバイダーの挙動は信頼できません。
  • Mary Jane Smith は一般的なキーワード表現としてではなく、first_name が Mary、last_name が Jane Smith としてマッピングされる点に注意してください。
  • URLに含まれる所在地、企業、学校、業種、つながりのフィルターが反映されるとは考えないでください。現在のアダプターではこれらは破棄されます。
  • 人物を特定する前に、公開プロフィールURLに加えて、裏付けとなる複数の属性を確認してください。
  • 送信した複数の検索結果が重複する場合は、固定のプロフィールURLで重複する候補を排除してください。
  • 呼び出し側で結果件数の上限を指定できないため、請求やレビューのワークフローは実際に保存された結果を前提に設計してください。

LinkedIn Search People API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。

  • LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
  • LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
  • LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
  • LinkedIn Jobs API — 公開求人の職種名、企業、説明、勤務地、応募資格、雇用条件、応募リンク、取得可能な給与フィールドを正規化して返します。
  • LinkedIn Profile Posts API — LinkedInのプロフィールURLに関連する公開投稿を探し、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
  • LinkedIn Search Posts API — Googleにインデックスされた公開LinkedIn投稿を、キーワードと任意の日付文字列で探し、正規化されたコンテンツ、投稿者、メディア、タグ、タイムスタンプ、表示中のエンゲージメントを返します。

他のプラットフォームを見る

LinkedInのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

LinkedIn Search People API — よくある質問

LinkedIn Search People APIは、人物検索URLから公開LinkedInプロフィールの候補を見つけるためのプログラムインターフェースです。URLの keywords の値を氏名ベースのプロバイダークエリに変換し、レビュー用に正規化された公開アカウントレコードを返します。

各値は、linkedin.com またはLinkedInのサブドメイン上の、http または https の完全なURLで、パスが /search/results/people で始まる必要があります。

デコード後、値は空白で分割されます。最初のトークンが first_name となり、残りのすべてのトークンが連結されて last_name になります。

保持されません。現在のアダプターは、URLに含まれる所在地、企業、学校、業種、つながりの次数、その他の検索フィルターをマッピングしません。

できません。このエンドポイントには呼び出し側で指定できる結果件数の上限がなく、送信した各URLについて検索ソースから得られたレコードを保存します。

できません。氏名は一意ではありません。各結果は候補として扱い、公開URL、氏名、説明文、所在地、その他の表示されている属性で裏付けを取ってください。

正常に保存されたプロフィール結果1件につき1 SocQクレジットで、基本料金はかかりません。計画時の見積もりはURLごとに100件を前提とし、結果が空の場合は結果に対する課金はありません。結果件数の上限が設けられていないため、実際の使用量は変動することがあります。