LinkedIn Jobs
公開LinkedIn求人は、職種、採用企業、説明文、勤務地、役職レベル、雇用形態、業種、応募方法、公開されている場合は給与によって、特定の募集ポジションを説明するものです。これらの情報は、求人の追跡、職種の比較、採用市場の調査、構造化された求人カタログの作成に活用できます。
LinkedIn Jobs API の主な機能
- 求人詳細URLで指定1つ以上の公開LinkedIn /jobs/view/{slug} ページを処理します。検索結果や求人一覧のURLは受け付けません。
- 職種と採用企業を1件のレコードに求人タイトル、説明文の全文、求人URL、正規化された採用企業の公開情報をまとめて返します。
- 構造化された雇用属性勤務地、役職レベル、雇用形態、業種を説明文に埋もれさせず、それぞれ独立したフィールドとして提供します。
- 応募と給与のフィールドapply_link、Easy Applyの有無、給与、掲載日時、取得日時を、求人の個別フィールドとして返します。
LinkedIn Jobs API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。公開LinkedIn求人詳細URLのリストです。すべてのURLは、linkedin.com またはLinkedInのサブドメイン上の /jobs/view/{slug} パスである必要があります。 |
LinkedIn Jobs API の使い方
既知の求人詳細リンクを送信し、求人レコードの準備が整うのを待ってから、取得可能なすべての結果ページを読み取ります。
- 入力リストを、公開されている /jobs/view/{slug} の詳細リンクに絞り込みます。
- それらのリンクを urls に入れて /v1/linkedin/jobs に POST し、task_id を保存します。
- 求人タスクが終了ステータスになるまで /v1/tasks/{task_id} を照会します。
- 成功したら data.results.items を処理し、has_more が示す続きのページは next_cursor を使って取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/view/software-engineer-at-microsoft-4429527118"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Jobs API の主なユースケース
- 求人の追跡: 職種、採用企業、勤務地、掲載日時、取得元URLを使い、把握済みの募集ポジションを構造化リストとして管理します。
- 職種と応募要件の比較: 選定した求人の説明文、役職レベル、雇用形態、業種、勤務地、公開されている給与を比較します。
- 採用市場の調査: 選定した求人を採用企業、勤務地、業種、雇用形態ごとに分類し、公開されている採用動向を分析します。
- 応募経路の管理: apply_link とEasy Applyの有無を使い、保存した各求人を利用可能な応募経路に振り分けます。
LinkedIn Jobs API 活用のヒント
- /jobs/view/ リンクから求人IDを抽出して重複を排除し、表記の異なるURLから同じ求人が重複して作成されないようにしてください。
- 多くの求人では給与が省略されており、公開されている値の形式も統一されていない場合があるため、salary は任意のソースデータとして扱ってください。
- 下流のインターフェースで外部リンクとして表示する前に、apply_link を検証してください。
- 掲載日時と求人の取得日時を混同しないよう、created_at と collected_at は分けて保持してください。
関連API
LinkedIn Jobs API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
- LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Company Jobs API — 用意したLinkedInの/jobs/ URLから公開求人を探し、正規化された職種、企業、勤務地、雇用形態、経験、リモート、給与、掲載時期の各フィールドを返します。
- LinkedIn Company Posts API — LinkedInの企業ページURLから公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
- LinkedIn Search Jobs API — 必須の勤務地と任意のフィルターでLinkedInの公開求人を検索し、正規化された職種、企業、勤務地、雇用形態、経験、リモート、給与、掲載時期の各フィールドを返します。