求人検索

求人情報を検索します。

Request

POST /jobs/search

項目	値
Method	`POST`
Path	`/jobs/search`
Operation ID	`searchJobs`

Request Body

フィールド	型	必須	説明
`limit`	integer	No	default: `25`<br>min: `1`<br>max: `1000`
`offset`	integer	No	default: `0`<br>min: `0`
`includeTotalResults`	boolean	No	default: `true`
`sort`	object	No	並び替え指定。省略時は jobCreatedAt の降順。<br>求人スカラーおよび企業クロスエンティティ（`corporate*` プレフィクス）を指定可能。<br>
`jobTitleOr`	array<string>	No	求人タイトルの完全一致フィルター（OR条件）。
`jobTitleNot`	array<string>	No	求人タイトルの完全一致除外フィルター。
`jobTitlePartialMatchOr`	array<string>	No	求人タイトルの部分一致フィルター（OR条件）。指定文字列のいずれかを含む求人を返します。
`jobTitlePartialMatchNot`	array<string>	No	求人タイトルの部分一致除外フィルター。指定文字列のいずれも含まない求人を返します。
`corporateNameOr`	array<string>	No	企業名の完全一致フィルター（OR条件）。紐づく企業名で絞り込みます。
`corporateNameNot`	array<string>	No	企業名の完全一致除外フィルター。
`corporateNamePartialMatchOr`	array<string>	No	企業名の部分一致フィルター（OR条件）。紐づく企業名に指定文字列のいずれかを含む求人を返します。
`corporateNamePartialMatchNot`	array<string>	No	企業名の部分一致除外フィルター。
`mediaIdOr`	array<integer>	No	媒体IDフィルター（OR条件）。`/master/media` で取得できるIDを指定します。
`mediaIdNot`	array<integer>	No	媒体IDフィルター（除外条件）。`/master/media` で取得できるIDを指定します。
`jobCategoryIdOr`	array<integer>	No	職種カテゴリIDフィルター（OR条件）。`/master/job-categories` で取得できる大分類IDを指定します。
`jobCategoryIdNot`	array<integer>	No	職種カテゴリIDフィルター（除外条件）。`/master/job-categories` で取得できる大分類IDを指定します。
`jobSubCategoryIdOr`	array<integer>	No	職種サブカテゴリIDフィルター（OR条件）。`/master/job-categories` で取得できる小分類IDを指定します。
`jobSubCategoryIdNot`	array<integer>	No	職種サブカテゴリIDフィルター（除外条件）。`/master/job-categories` で取得できる小分類IDを指定します。
`employmentTypeIdOr`	array<integer>	No	雇用形態IDフィルター（OR条件）。`/master/employment-types` で取得できるIDを指定します。
`employmentTypeIdNot`	array<integer>	No	雇用形態IDフィルター（除外条件）。`/master/employment-types` で取得できるIDを指定します。
`adPlanOr`	array<string>	No	広告プランのフィルター（OR条件）。求人の広告プラン名を指定します。
`salaryMin`	integer	No	給与の下限（円単位、以上）
`salaryMax`	integer	No	給与の上限（円単位、以下）
`hasDispatchLicense`	boolean	No	派遣免許の有無でフィルター
`hasRecruitmentLicense`	boolean	No	紹介免許の有無でフィルター
`hasContactEmail`	boolean	No	メールアドレスの有無でフィルター
`hasContactPhone`	boolean	No	電話番号の有無でフィルター
`jobCreatedAtFrom`	string	No	求人掲載日の開始日（YYYY-MM-DD形式、以降）
`jobCreatedAtTo`	string	No	求人掲載日の終了日（YYYY-MM-DD形式、以前）
`jobOpenedOnFrom`	string	No	掲載開始日の開始日（YYYY-MM-DD形式、以降）
`jobOpenedOnTo`	string	No	掲載開始日の終了日（YYYY-MM-DD形式、以前）
`jobDeadlineOnFrom`	string	No	掲載終了日の開始日（YYYY-MM-DD形式、以降）
`jobDeadlineOnTo`	string	No	掲載終了日の終了日（YYYY-MM-DD形式、以前）
`corporateNumberOr`	array<string>	No	法人番号フィルター（OR条件）。13桁の法人番号を指定します。
`corporatePrefectureIdOr`	array<integer>	No	企業の都道府県IDフィルター（OR条件）。`/master/prefectures` で取得できるIDを指定します。
`corporatePrefectureIdNot`	array<integer>	No	企業の都道府県IDフィルター（除外条件）。`/master/prefectures` で取得できるIDを指定します。
`corporateCityNamePartialMatchOr`	array<string>	No	企業の市区町村の部分一致フィルター（OR条件）。
`corporateCityNamePartialMatchNot`	array<string>	No	企業の市区町村の部分一致除外フィルター。
`corporateStreetAddressPartialMatchOr`	array<string>	No	企業の住所（番地以降）の部分一致フィルター（OR条件）。
`corporateStreetAddressPartialMatchNot`	array<string>	No	企業の住所（番地以降）の部分一致除外フィルター。
`corporateIndustryCategoryIdOr`	array<integer>	No	企業の業界カテゴリIDフィルター（OR条件）。`/master/industries` で取得できる大分類IDを指定します。
`corporateIndustryCategoryIdNot`	array<integer>	No	企業の業界カテゴリIDフィルター（除外条件）。`/master/industries` で取得できる大分類IDを指定します。
`corporateIndustrySubCategoryIdOr`	array<integer>	No	企業の業界サブカテゴリIDフィルター（OR条件）。`/master/industries` で取得できる小分類IDを指定します。
`corporateIndustrySubCategoryIdNot`	array<integer>	No	企業の業界サブカテゴリIDフィルター（除外条件）。`/master/industries` で取得できる小分類IDを指定します。
`corporateBusinessCategoryIdOr`	array<integer>	No	企業の業種カテゴリIDフィルター（OR条件）。`/master/business-types` で取得できる大分類IDを指定します。
`corporateBusinessCategoryIdNot`	array<integer>	No	企業の業種カテゴリIDフィルター（除外条件）。`/master/business-types` で取得できる大分類IDを指定します。
`corporateBusinessSubCategoryIdOr`	array<integer>	No	企業の業種サブカテゴリIDフィルター（OR条件）。`/master/business-types` で取得できる小分類IDを指定します。
`corporateBusinessSubCategoryIdNot`	array<integer>	No	企業の業種サブカテゴリIDフィルター（除外条件）。`/master/business-types` で取得できる小分類IDを指定します。
`corporateCorporateTypeOr`	array<`CorporateType`>	No
`corporateCorporateTypeNot`	array<`CorporateType`>	No
`corporateMarketCodeOr`	array<string>	No	企業の市場区分コードフィルター（OR条件）。`/master/markets` で取得できるコードを指定します。
`corporateMarketCodeNot`	array<string>	No	企業の市場区分コードフィルター（除外条件）。`/master/markets` で取得できるコードを指定します。
`corporateIsListed`	boolean	No	企業の上場/未上場フィルター。true=上場企業のみ、false=未上場企業のみ。<br>nullable
`corporateRevenueRangeOr`	array<`RevenueRange`>	No
`corporateRevenueRangeNot`	array<`RevenueRange`>	No
`corporateCapitalMillionYenMin`	number	No
`corporateCapitalMillionYenMax`	number	No
`corporateEmployeeCountMin`	integer	No
`corporateEmployeeCountMax`	integer	No
`corporateHasCorporateWebsite`	boolean	No
`corporateHasCorporatePhone`	boolean	No
`corporateHasCorporateEmail`	boolean	No
`hiringPlanMinAtLeast`	integer	No	採用予定最小人数が N 人以上（N を指定）<br>min: `0`
`corporateFundingSeriesOr`	array<`FundingSeries`>	No	企業の投資ラウンドフィルター（OR条件）。
`corporateFundingSeriesNot`	array<`FundingSeries`>	No	企業の投資ラウンドフィルター（除外条件）。
`corporateTotalAdCostMin`	integer	No	企業の広告出稿総額の下限（円）。<br>min: `0`
`corporateTotalAdCostMax`	integer	No	企業の広告出稿総額の上限（円）。<br>min: `0`
`corporatePaidMediaSpendOr`	array<`PaidMediaSpendRange`>	No	企業の出稿額レンジフィルター（OR条件）。
`corporatePaidMediaSpendNot`	array<`PaidMediaSpendRange`>	No	企業の出稿額レンジフィルター（除外条件）。
`corporatePaidMediaUsedMediaIdOr`	array<integer>	No	企業の掲載課金型媒体フィルター（OR条件）。`/master/media` で取得できる ID を指定します。
`corporatePaidMediaUsedMediaIdNot`	array<integer>	No	企業の掲載課金型媒体フィルター（除外条件）。`/master/media` で取得できる ID を指定します。
`corporateHasFax`	boolean	No	企業の FAX 番号の有無。true=あり、false=なし。
`corporateEmployeeDiff6mMinMin`	integer	No	企業の 6 ヶ月従業員増加数の下限（min 値）。
`corporateEmployeeDiff6mMinMax`	integer	No	企業の 6 ヶ月従業員増加数の上限（max 値）。
`corporateEmployeeDiff12mMin`	integer	No	企業の 12 ヶ月従業員増加数の下限。
`corporateEmployeeDiff12mMax`	integer	No	企業の 12 ヶ月従業員増加数の上限。
`corporateEmployeeTransitionPartialMatchOr`	array<string>	No	企業の従業員推移フラグの部分一致（OR条件）。
`corporateEmployeeTransitionPartialMatchNot`	array<string>	No	企業の従業員推移フラグの部分一致（除外条件）。

Request Example

{
  "limit": 25,
  "offset": 0,
  "includeTotalResults": true,
  "sort": {
    "field": "jobCreatedAt",
    "order": "asc"
  },
  "jobTitleOr": [
    "string"
  ]
}

Responses

`200`

検索結果

フィールド	型	必須	説明
`totalResults`	integer	No	nullable
`results`	array<`Job`>	Yes

`400`

リクエストエラー

フィールド	型	必須	説明
`message`	string	Yes
`errors`	array<`ValidationError`>	No	バリデーションエラーの詳細

`401`

認証エラー

フィールド	型	必須	説明
`message`	string	Yes
`errors`	array<`ValidationError`>	No	バリデーションエラーの詳細

`500`

サーバーエラー

フィールド	型	必須	説明
`message`	string	Yes
`errors`	array<`ValidationError`>	No	バリデーションエラーの詳細

`402`

Payment Required - APIクレジットが不足

フィールド	型	必須	説明
`message`	string	Yes
`errors`	array<`ValidationError`>	No	バリデーションエラーの詳細

`429`

Too Many Requests - レートリミット超過

フィールド	型	必須	説明
`message`	string	Yes
`errors`	array<`ValidationError`>	No	バリデーションエラーの詳細

Response Example

{
  "results": [
    {
      "id": "string",
      "shortId": "string",
      "corporateNumber": "string",
      "corporateName": "string",
      "mediaId": 1,
      "mediaName": "string",
      "title": "string",
      "url": "string",
      "jobCreatedAt": "string"
    }
  ]
}