求人検索API

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

リクエスト例

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

curl -s "$SALESBRAIN_API_BASE_URL/jobs/search" \
  -H "X-API-Key: $SALESBRAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "jobTitle": {"anyContains": ["インサイドセールス", "SDR"]},
      "jobCreatedAt": {"from": "2026-07-01"}
    },
    "sort": { "field": "jobCreatedAt", "order": "desc" },
    "limit": 25,
    "offset": 0,
    "includeTotalResults": true
  }'

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

よく使う検索条件

目的	フィールド
求人タイトルの部分一致	`filters.jobTitle.anyContains/noneContains`
企業名	`filters.corporateName.anyContains/noneContains`
求人媒体	`filters.mediaId.any/none`
職種	`filters.jobCategoryId.any`, `filters.jobSubCategoryId.any`
雇用形態	`filters.employmentTypeId.any/none`
給与	`filters.salary.min/max`
求人連絡先の有無	`filters.hasContactEmail`, `filters.hasContactPhone`
求人取得日	`filters.jobCreatedAt.from/to`
法人番号	`filters.corporateNumber.any`
企業の都道府県	`filters.corporatePrefectureId.any`
企業の業界	`filters.corporateIndustryCategoryId.any`, `filters.corporateIndustrySubCategoryId.any`
企業の従業員数	`filters.corporateEmployeeCount.min/max`

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

ページング

limit: 1回に返す件数。1〜1000、初期値25
offset: 先頭から読み飛ばす件数。初期値0
includeTotalResults: 総件数が必要な場合はtrue

並び替え

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

"sort": { "field": "jobCreatedAt", "order": "desc" }

レスポンス

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

項目	内容
`id`, `shortId`	求人の識別子
`corporateNumber`, `corporateName`	求人元企業
`title`	求人タイトル
`mediaId`, `mediaName`	求人媒体
`jobPostingUrl`	媒体上の求人URL
`originalJobUrl`	転載求人の掲載元URL。取得できない場合は `null`
`jobCategoryName`	職種
`employmentTypes`	雇用形態
`salaryMin`, `salaryMax`	給与
`contactEmail`, `contactPhoneNumber`	求人連絡先
`jobCreatedAt`	セールスブレインが求人を取得した日時

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

エラーと制限

ステータス	主な原因
`400`	フィールド名、値の型、日付形式が正しくない
`401`	APIキーがない、無効、期限切れ
`402`	検索クレジットが不足している
`429`	毎秒5リクエストの上限を超えた

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