linkedin/
company-jobs

用意した /jobs/ URLから公開LinkedIn求人を収集し、職種、企業、勤務地、雇用形態、経験レベル、リモート可否、給与、日時を正規化したフィールドで返します。

LinkedIn Company Jobs API

求人ページで指定
URLごとの件数上限
正規化された求人レコード
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を送信し、非同期タスクをポーリングして、返されたすべての結果ページを処理します。

  1. パスが /jobs/ で始まる公開LinkedIn URLを用意し、有用なクエリパラメータは残しておきます。
  2. urls と results_limit を /v1/linkedin/company-jobs に POST し、task_id を保存します。
  3. タスクが終了ステータスになるまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら 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 true

LinkedIn Company Jobs API の主なユースケース

  • 特定企業の求人モニタリング: 用意した企業向けの求人URLを定期的に再取得し、取得時点ごとに返された公開求人を比較します。
  • 職種カタログの情報補完: 公開求人カタログに、正規化された企業、勤務地、雇用形態、経験レベル、リモート可否、給与、日付のフィールドを追加します。
  • 採用ページの調査: 取得元URLと取得タイムスタンプをすべて保持したまま、選定した求人ページ間で返された職種の構成を比較します。
  • ワークフローへの取り込み: 収集した公開求人レコードを、レビュー、重複排除、アラート、下流の分析ワークフローに投入します。

LinkedIn Company Jobs API 活用のヒント

  • ページに表示される求人に影響する場合があるため、用意するURLには意味のあるクエリパラメータを残してください。
  • 重複する求人ページから同じ募集が返される場合は、固定の求人 id または求人URLで重複を排除してください。
  • あるURLの結果が空でも、それは収集結果の1つであり、その企業に募集中の職種がないことの証明ではないと考えてください。
  • 用意したページURLではなく、キーワードや勤務地を明示的に指定したい場合は、構造化された求人検索を使用してください。
  • 掲載日時と取得日時を混同しないよう、published_at、expires_at、collected_at は区別して保持してください。

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の公開求人を検索し、正規化された職種、企業、勤務地、雇用形態、経験、リモート、給与、掲載時期の各フィールドを返します。

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

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

LinkedIn Company Jobs API — よくある質問

LinkedIn Company Jobs APIは、用意したLinkedInの /jobs/ URLから公開求人を収集するためのプログラムインターフェースです。取得時点で表示されている求人について、正規化された職種、企業、勤務地、雇用形態、経験レベル、リモート可否、給与、日時のフィールドを返します。

各値は、linkedin.com またはLinkedInのサブドメイン上の、http または https の完全なURLで、パスが /jobs/ で始まる必要があります。通常の /company/ プロフィールURLは検証を通過しません。

この整数の上限は各URLに個別に適用されます。たとえば上限を20にすると、送信した求人ページごとに最大20件の求人が返されます。

いいえ。結果が空というのは、その時点でそのURLから対応する公開求人が返されなかったことを意味するだけです。

できません。このエンドポイントは公開求人データを返すもので、職種への応募、リクルーターへの連絡、非公開の採用分析データの提供は行いません。

返された求人レコード1件につき0.5 SocQクレジットで、基本料金はかかりません。結果が空の場合は結果に対する課金はなく、許可されている場合は実際の使用量が見積もりを上回ることがあります。