linkedin/
profiles

/in/{slug} 形式のURLから公開LinkedInプロフィールを取得し、正規化された基本情報と現在の役職、職歴、スキル、所在地、表示中のオーディエンス数を返します。

LinkedIn Profiles API

プロフィールURLで指定
キャリア情報
公開スナップショット
結果1件あたり2.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

既知のプロフィールリンクから始め、プロフィールタスクの完了を待ってから、キャリアレコードをページごとに読み取ります。

  1. パスが /in/{slug} に一致する公開LinkedInリンクのみを残します。
  2. それらのリンクを urls に入れて /v1/linkedin/profiles に送信し、task_id を保存します。
  3. プロフィールの処理が succeeded または failed になるまで /v1/tasks/{task_id} を確認します。
  4. 成功したら 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 true

LinkedIn Profiles API の主なユースケース

  • 連絡先・候補者データの補完: 既知のプロフィールURLにひも付くレコードに、現在の役職、勤務先、所在地、職歴、学歴、スキルを追加します。
  • キャリアパスの調査: 構造化された職歴と学歴のセクションを使い、役職の変遷や職業上の経歴を分析します。
  • 公開プロフィールのモニタリング: 保存したプロフィールのスナップショットを比較し、役職、現在の勤務先、スキル、表示中のオーディエンス数の変化を把握します。

LinkedIn Profiles API 活用のヒント

  • 送信前に /in/ URLを正規化して重複を排除し、表記の異なるURLから同じプロフィールレコードが重複して作成されないようにしてください。
  • 返された id がある場合はそれをプロフィールのキーとして使い、識別子のないレコードでは url をフォールバックとして使用してください。
  • 公開プロフィールではいずれの項目も省略されている場合があるため、職歴、学歴、スキル、オーディエンス数は任意項目として扱ってください。
  • 役職やオーディエンスの経時的な変化を比較する場合は、保存する各スナップショットに collected_at を残してください。

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に関連する公開投稿を探し、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。

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

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

LinkedIn Profiles API — よくある質問

LinkedIn Profiles APIは、受け付け可能な1つ以上の /in/{slug} URLから公開されている職業データを取得します。正規化された基本情報、現在の役職、所在地、職歴、学歴、スキル、取得可能なフォロワー数とつながり数を返します。

パスが /in/{slug} に一致する、http または https の完全なLinkedIn URLを送信してください。会社ページ、投稿、フィード、求人のリンクはプロフィールの入力として使用できません。

返しません。結果は処理時点で公開プロフィールに表示されているフィールドに限られ、メンバーの非公開データがレスポンスに追加されることはありません。

公開プロフィールで公開されていない場合、職歴、学歴、スキル、オーディエンス数などの任意フィールドは null または空になることがあります。

返されたプロフィールに基づいて課金され、結果1件につき2.5 SocQクレジットです。完了したタスクでプロフィールが返されなかった場合、結果に対する課金はありません。