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を用意して非同期タスクを送信し、返されたすべての候補を確認します。
- 対象人物の氏名を含む keywords クエリ値を持つ、LinkedInの人物検索URLを作成します。
- urls を /v1/linkedin/search-people に POST し、返された task_id を保存します。
- タスクが終了ステータスになるまで /v1/tasks/{task_id} をポーリングします。
- 成功したら 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 trueLinkedIn 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で重複する候補を排除してください。
- 呼び出し側で結果件数の上限を指定できないため、請求やレビューのワークフローは実際に保存された結果を前提に設計してください。
関連API
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投稿を、キーワードと任意の日付文字列で探し、正規化されたコンテンツ、投稿者、メディア、タグ、タイムスタンプ、表示中のエンゲージメントを返します。