LinkedIn Profiles
公開LinkedInプロフィールには、ビジネスパーソンの基本情報、現在の役職、所在地、職歴、学歴、スキル、表示中のオーディエンス規模が掲載されています。これらの情報は、連絡先データの補完、キャリアパスの調査、本人確認、公開プロフィールの経時的な変化の比較に活用できます。
LinkedIn Profiles API の主な機能
- 公開プロフィールURLで指定1つ以上のLinkedIn /in/{slug} URLを処理します。会社ページ、投稿、求人情報が混在することはありません。
- 現在のキャリア情報公開されている氏名、自己紹介文、アバター、所在地、役職、現在の勤務先を1件の正規化レコードで返します。
- 構造化された職歴職歴、学歴、スキルをそれぞれ別のセクションとして保持するため、フィルタリング、インデックス作成、レコードの補完に利用できます。
- 表示中のオーディエンス指標取得可能なフォロワー数とつながり数を、プロフィールの各フィールドとは別の指標として返します。
LinkedIn Profiles API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。公開LinkedInプロフィールURLのリストです。すべてのURLは、linkedin.com またはLinkedInのサブドメイン上の /in/{slug} パスである必要があります。 |
LinkedIn Profiles API の使い方
既知のプロフィールリンクから始め、プロフィールタスクの完了を待ってから、キャリアレコードをページごとに読み取ります。
- パスが /in/{slug} に一致する公開LinkedInリンクのみを残します。
- それらのリンクを urls に入れて /v1/linkedin/profiles に送信し、task_id を保存します。
- プロフィールの処理が succeeded または failed になるまで /v1/tasks/{task_id} を確認します。
- 成功したら data.results.items を読み取り、has_more が true の間は next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Profiles API の主なユースケース
- 連絡先・候補者データの補完: 既知のプロフィールURLにひも付くレコードに、現在の役職、勤務先、所在地、職歴、学歴、スキルを追加します。
- キャリアパスの調査: 構造化された職歴と学歴のセクションを使い、役職の変遷や職業上の経歴を分析します。
- 公開プロフィールのモニタリング: 保存したプロフィールのスナップショットを比較し、役職、現在の勤務先、スキル、表示中のオーディエンス数の変化を把握します。
LinkedIn Profiles API 活用のヒント
- 送信前に /in/ URLを正規化して重複を排除し、表記の異なるURLから同じプロフィールレコードが重複して作成されないようにしてください。
- 返された id がある場合はそれをプロフィールのキーとして使い、識別子のないレコードでは url をフォールバックとして使用してください。
- 公開プロフィールではいずれの項目も省略されている場合があるため、職歴、学歴、スキル、オーディエンス数は任意項目として扱ってください。
- 役職やオーディエンスの経時的な変化を比較する場合は、保存する各スナップショットに collected_at を残してください。
関連API
LinkedIn Profiles API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Jobs API — 公開求人の職種名、企業、説明、勤務地、応募資格、雇用条件、応募リンク、取得可能な給与フィールドを正規化して返します。
- LinkedIn Company Jobs API — 用意したLinkedInの/jobs/ URLから公開求人を探し、正規化された職種、企業、勤務地、雇用形態、経験、リモート、給与、掲載時期の各フィールドを返します。
- LinkedIn Company Posts API — LinkedInの企業ページURLから公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
- LinkedIn Profile Posts API — LinkedInのプロフィールURLに関連する公開投稿を探し、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。