LinkedIn Company Jobs
LinkedIn企業の求人は、タイトル、企業、勤務地、雇用形態、経験レベル、リモート可否、給与、日時の情報を含む公開求人です。これらのフィールドは、求人の追跡、職種の比較、採用動向の調査、構造化された求人ディレクトリの作成に活用できます。
LinkedIn Company Jobs API の主な機能
- 求人ページからの収集パスが /jobs/ で始まる1つ以上の公開LinkedIn URLを送信し、用意した各ページに表示される求人を収集します。
- 入力ごとの件数上限results_limit は1〜2000の範囲で設定でき、指定した上限はリクエスト内の各URLに個別に適用されます。
- 正規化された求人レコードソース固有の入れ子構造ではなく、求人、企業、勤務地、給与、掲載日時、終了日時、取得日時の安定したフィールドで受け取れます。
- ソースに忠実なnull値給与、リモート可否、経験レベル、正確な勤務地などの値が求人で公開されていない場合、フィールドは null のまま保持されます。
LinkedIn Company Jobs API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。http または https の公開LinkedIn URLのリストです。各ホストは linkedin.com またはLinkedInのサブドメインで、各パスは /jobs/ で始まる必要があります。 |
results_limit | 任意 | 任意。各入力URLに適用される結果件数の上限(整数)です。デフォルトは100、最小値は1、最大値は2000です。 |
LinkedIn Company Jobs API の使い方
用意した求人ページのURLを送信し、非同期タスクをポーリングして、返されたすべての結果ページを処理します。
- パスが /jobs/ で始まる公開LinkedIn URLを用意し、有用なクエリパラメータは残しておきます。
- urls と results_limit を /v1/linkedin/company-jobs に POST し、task_id を保存します。
- タスクが終了ステータスになるまで /v1/tasks/{task_id} をポーリングします。
- 成功したら data.results.items を処理し、has_more が true の間は next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/company-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/microsoft-jobs/"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Company Jobs API の主なユースケース
- 特定企業の求人モニタリング: 用意した企業向けの求人URLを定期的に再取得し、取得時点ごとに返された公開求人を比較します。
- 職種カタログの情報補完: 公開求人カタログに、正規化された企業、勤務地、雇用形態、経験レベル、リモート可否、給与、日付のフィールドを追加します。
- 採用ページの調査: 取得元URLと取得タイムスタンプをすべて保持したまま、選定した求人ページ間で返された職種の構成を比較します。
- ワークフローへの取り込み: 収集した公開求人レコードを、レビュー、重複排除、アラート、下流の分析ワークフローに投入します。
LinkedIn Company Jobs API 活用のヒント
- ページに表示される求人に影響する場合があるため、用意するURLには意味のあるクエリパラメータを残してください。
- 重複する求人ページから同じ募集が返される場合は、固定の求人 id または求人URLで重複を排除してください。
- あるURLの結果が空でも、それは収集結果の1つであり、その企業に募集中の職種がないことの証明ではないと考えてください。
- 用意したページURLではなく、キーワードや勤務地を明示的に指定したい場合は、構造化された求人検索を使用してください。
- 掲載日時と取得日時を混同しないよう、published_at、expires_at、collected_at は区別して保持してください。
関連API
LinkedIn Company Jobs API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
- LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Jobs API — 公開求人の職種名、企業、説明、勤務地、応募資格、雇用条件、応募リンク、取得可能な給与フィールドを正規化して返します。
- LinkedIn Company Posts API — LinkedInの企業ページURLから公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
- LinkedIn Search Jobs API — 必須の勤務地と任意のフィルターでLinkedInの公開求人を検索し、正規化された職種、企業、勤務地、雇用形態、経験、リモート、給与、掲載時期の各フィールドを返します。