求人検索API

POST /jobs/searchで、求人情報と企業属性を組み合わせて求人を検索します。利用前にAPIキーと認証を設定してください。

リクエスト例

直近のインサイドセールス求人を、取得日の新しい順に取得します。

printf 'header = "X-API-Key: %s"\n' "$SALESBRAIN_API_KEY" |
  curl -sS --config - "$SALESBRAIN_API_BASE_URL/jobs/search" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "job": {
        "title": {"anyContains": ["インサイドセールス", "SDR"]},
        "createdAt": {"gte": "2026-07-01"}
      }
    },
    "sort": { "field": "job.createdAt", "order": "desc" },
    "limit": 25,
    "offset": 0,
    "includeTotalResults": true
  }'

日付はYYYY-MM-DD形式で指定します。運用時は固定日ではなく、取得時点から必要な期間を計算してください。

よく使う検索条件

検索条件は filter.job（求人属性）と filter.company（求人元企業の属性）に分けます。異なる項目は初期状態でAND評価されます。ORや条件グループの指定方法は、企業検索APIを参照してください。

業界、媒体、職種、雇用形態のIDは、マスターデータから取得します。

給与条件は円単位で指定します。filter.job.salary.gte は給与下限、lte は給与上限に対して評価されます。求人ごとに年収・月給・日給・時給が異なるため、結果の salaryType と金額を合わせて確認してください。

ページング

• limit: 1回に返す件数。1〜1000、初期値25
• offset: 先頭から読み飛ばす件数。初期値0。offset + limit は500,000以下
• includeTotalResults: 総件数が必要な場合はtrue（初期値）。falseならtotalはnull

並び替え

省略時は求人取得日の降順です。募集開始日、募集終了日、給与、企業属性でも並び替えられます。

{
  "sort": { "field": "job.createdAt", "order": "desc" }
}

レスポンス

itemsに求人一覧、totalに総件数が返ります。主な項目は次のとおりです。

値を保有していない項目はnullになる場合があります。掲載元の求人は、取得後に更新・終了している場合があります。

エラーと制限

最初はlimitを5〜25件にして条件を確認し、必要な場合だけ件数を増やしてください。

次に読む

• マスターデータ
• 求人詳細本文検索ガイド