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つ送信し、非同期タスクをポーリングして、返されたすべての結果ページを処理します。
- 必須の勤務地を決め、解釈を検証済みのプロバイダーフィルター値のみを追加します。
- クエリを /v1/linkedin/search-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/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 trueLinkedIn Search Jobs API の主なユースケース
- 地域ごとの職種調査: 職種と勤務地の条件を固定したクエリで公開求人を収集し、後で比較できるよう取得日時を保持します。
- 採用企業と職種のレビュー: 返されたサンプルに、どの採用企業、職種名、勤務地、勤務形態、経験レベル、雇用形態が含まれているかを確認します。
- 給与情報の有無の確認: 給与情報を公開している求人を特定し、給与が掲載されていないものは明示的な null として保持します。
- 求人ワークフローへの取り込み: 正規化された公開求人のURLとフィールドを、レビュー、重複排除、アラート、下流の分析ワークフローに投入します。
LinkedIn Search Jobs API 活用のヒント
- 定期的なワークフローで使う前に、プロバイダー固有のフィルター表記を小規模なクエリで検証してください。
- 勤務地や日付を比較する場合は、同じフィルターと取得スケジュールを使用してください。
- 再掲載された求人や条件の重なる検索で同じ募集が返されることがあるため、固定の求人 id または求人URLで重複を排除してください。
- リモートのラベルは取得元のシグナルとして扱い、地域、居住地、タイムゾーンの制約については説明文を確認してください。
- 掲載日時と取得日時を混同しないよう、published_at、expires_at、collected_at は区別して保持してください。
- 結果が空でも、それは収集結果の1つであり、条件に合う公開求人が存在しないことの証明ではないと考えてください。
関連API
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から公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。