linkedin/
search-jobs

勤務地と任意のプロバイダーフィルターで公開LinkedIn求人を検索し、職種、企業、勤務地、雇用形態、経験レベル、リモート可否、給与、日時を正規化したフィールドで返します。

LinkedIn Search Jobs API

勤務地は必須
構造化された検索
正規化された求人レコード
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

LinkedIn Search Jobs

LinkedIn Search Jobsは、必須の勤務地と任意のフィルターから1つの公開検索クエリを作成します。調査やワークフローへの取り込みに使える取得時点の求人レコードを返しますが、返された求人が現在も応募を受け付けていることを保証するものではなく、結果件数は採用活動や従業員数を直接示す指標でもありません。

LinkedIn Search Jobs API の主な機能

  • 勤務地を軸にした検索すべてのクエリは空でない勤務地から始まり、キーワード、国、企業、その他のプロバイダーフィルターで公開求人のサンプルを任意に絞り込めます。
  • 柔軟なソースフィルターtime_range、job_type、experience_level、remote、company、location_radius、selective_search、除外値を、SocQ独自の列挙値を設けずにそのまま転送します。
  • 設定可能な件数上限1つの検索クエリに対して results_limit を1〜2000の範囲で設定できます。デフォルトは100で、プロバイダーから返される件数がこれより少ない場合もあります。
  • 正規化された求人レコードプロバイダー固有の入れ子構造ではなく、求人、企業、勤務地、給与、掲載日時、終了日時、取得日時の安定したフィールドで受け取れます。
  • ソースに忠実なnull値取得できない給与、リモート可否、企業、経験レベル、勤務地、掲載日時、終了日時の値は推測せず、null のまま保持します。

LinkedIn Search Jobs API のパラメータ

パラメータ必須説明
location必須必須。プロバイダーの検索クエリの作成に使用される、空でない勤務地の文字列です。
keyword任意任意。プロバイダーに転送される、職種、スキル、トピックを表す空でない文字列です。
country任意任意。SocQ側で変換せずに転送される、空でない国フィルターの文字列です。
time_range任意任意。プロバイダー固有の、新しさや期間を指定する空でない文字列です。
job_type任意任意。プロバイダー固有の、雇用形態や求人種別を指定する空でないフィルター文字列です。
experience_level任意任意。プロバイダー固有の、経験や役職レベルを指定する空でないフィルター文字列です。
remote任意任意。プロバイダー固有の、勤務形態やリモートを指定する空でないフィルター文字列です。
company任意任意。プロバイダーに転送される、空でない企業フィルターの文字列です。
selective_search任意任意。プロバイダーの選択的検索の動作を制御するために転送されるブール値です。
jobs_to_not_include任意任意。プロバイダーに転送される、空でない除外文字列のリストです。
location_radius任意任意。勤務地のクエリに関連付けられる、プロバイダー固有の空でない範囲指定の文字列です。
results_limit任意任意。このクエリの件数上限(整数)です。デフォルトは100、最小値は1、最大値は2000です。

LinkedIn Search Jobs API の使い方

勤務地ベースのクエリを1つ送信し、非同期タスクをポーリングして、返されたすべての結果ページを処理します。

  1. 必須の勤務地を決め、解釈を検証済みのプロバイダーフィルター値のみを追加します。
  2. クエリを /v1/linkedin/search-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/search-jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"Seattle","keyword":"Python","country":"US","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • 地域ごとの職種調査: 職種と勤務地の条件を固定したクエリで公開求人を収集し、後で比較できるよう取得日時を保持します。
  • 採用企業と職種のレビュー: 返されたサンプルに、どの採用企業、職種名、勤務地、勤務形態、経験レベル、雇用形態が含まれているかを確認します。
  • 給与情報の有無の確認: 給与情報を公開している求人を特定し、給与が掲載されていないものは明示的な null として保持します。
  • 求人ワークフローへの取り込み: 正規化された公開求人のURLとフィールドを、レビュー、重複排除、アラート、下流の分析ワークフローに投入します。

LinkedIn Search Jobs API 活用のヒント

  • 定期的なワークフローで使う前に、プロバイダー固有のフィルター表記を小規模なクエリで検証してください。
  • 勤務地や日付を比較する場合は、同じフィルターと取得スケジュールを使用してください。
  • 再掲載された求人や条件の重なる検索で同じ募集が返されることがあるため、固定の求人 id または求人URLで重複を排除してください。
  • リモートのラベルは取得元のシグナルとして扱い、地域、居住地、タイムゾーンの制約については説明文を確認してください。
  • 掲載日時と取得日時を混同しないよう、published_at、expires_at、collected_at は区別して保持してください。
  • 結果が空でも、それは収集結果の1つであり、条件に合う公開求人が存在しないことの証明ではないと考えてください。

LinkedIn Search Jobs API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。

  • LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
  • 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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

LinkedIn Search Jobs API — よくある質問

LinkedIn Search Jobs APIは、必須の勤務地と任意のプロバイダーフィルターから公開LinkedIn求人を検索するためのプログラムインターフェースです。取得時点で利用可能な求人について、正規化された職種、企業、勤務地、雇用形態、経験レベル、リモート可否、給与、日時のフィールドを返します。

location は必須で、空でない文字列を指定する必要があります。キーワード、企業、その他の任意フィルターのみを指定しても、現在のバリデーションは通過しません。

いいえ。SocQは空でないフィルター文字列を検索プロバイダーにそのまま転送し、受け付けられる表記や組み合わせを定義・変換することはありません。

いいえ。results_limit は1〜2000の整数で指定する上限で、デフォルトは100です。公開状況、フィルターの組み合わせ、ページネーション、重複、プロバイダーの挙動によって、返される件数が少なくなる場合があります。

いいえ。各結果は取得時点の公開レコードです。行動に移す前に、求人ページで応募状況、業務内容、勤務地の制約、給与を確認してください。

できません。このエンドポイントは、応募、求人の保存、アラートの作成、応募者の取得、Recruiterへのアクセス、パーソナライズされたマッチスコアの提供は行いません。

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