マスターデータAPI

都道府県、業界、求人媒体、職種などは、検索条件に名前ではなくIDまたはコードを指定します。マスターデータAPIで、表示名と識別子の対応を取得してください。

すべてのマスターAPIにX-API-Keyヘッダーが必要です。取得は検索クレジットを消費しません。

エンドポイント

エンドポイント	取得するもの	検索で使う主な項目
`GET /master/prefectures`	都道府県	`filters.prefectureId.any`, `filters.corporatePrefectureId.any`
`GET /master/industries`	業界の大分類・小分類	`filters.industryCategoryId.any`, `filters.industrySubCategoryId.any`
`GET /master/media`	求人媒体	`filters.mediaId.any`, `filters.jobMediaId.any`
`GET /master/job-categories`	職種の大分類・小分類	`filters.jobCategoryId.any`, `filters.jobSubCategoryId.any`
`GET /master/markets`	市場区分	`filters.marketCode.any`, `filters.corporateMarketCode.any`
`GET /master/employment-types`	雇用形態	`filters.employmentTypeId.any`, `filters.jobEmploymentTypeId.any`

curl -s "$SALESBRAIN_API_BASE_URL/master/industries" \
  -H "X-API-Key: $SALESBRAIN_API_KEY"

業界と職種は、大分類の中にsubCategoriesとして小分類が返ります。

[
  {
    "id": 1,
    "name": "大分類名",
    "subCategories": [
      { "id": 101, "name": "小分類名" }
    ]
  }
]

取得したIDを検索リクエストへ指定します。

{
  "filters": {
    "industryCategoryId": {"any": [1]},
    "industrySubCategoryId": {"any": [101]}
  },
  "limit": 25
}

市場区分はidではなくcodeを検索条件へ指定します。雇用形態は検索項目に応じてIDを指定します。

マスターは頻繁に変わらないため、レスポンスのCache-Control: max-age=86400に従い、24時間キャッシュできます。リクエストのたびに取得する必要はありません。