企業検索

企業情報を検索します。

Request

POST /corporates/search

項目	値
Method	`POST`
Path	`/corporates/search`
Operation ID	`searchCorporates`

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	並び替え指定。省略時は name の昇順。<br>企業自身の日付/数値/連絡先カラム、および求人集約フィールド（`jobCreatedAt` 等）を指定可能。<br>集約フィールドは内部的に OS の配列フィールド + `mode: max` で処理される。<br>
`corporateNameOr`	array<string>	No	企業名の完全一致フィルター。指定した企業名のいずれかに一致する企業を返します。
`corporateNameNot`	array<string>	No	企業名の除外フィルター。指定した企業名のいずれにも一致しない企業を返します。
`corporateNamePartialMatchOr`	array<string>	No	企業名の部分一致フィルター。指定した文字列のいずれかを含む企業を返します。
`corporateNamePartialMatchNot`	array<string>	No	企業名の部分一致除外フィルター。指定した文字列のいずれも含まない企業を返します。
`prefectureIdOr`	array<integer>	No	都道府県IDフィルター（OR条件）。`/master/prefectures` で取得できるIDを指定します。
`prefectureIdNot`	array<integer>	No	都道府県IDフィルター（除外条件）。`/master/prefectures` で取得できるIDを指定します。
`cityNamePartialMatchOr`	array<string>	No	市区町村の部分一致フィルター（OR条件）。指定文字列のいずれかを含む市区町村の企業を返します。
`cityNamePartialMatchNot`	array<string>	No	市区町村の部分一致除外フィルター。指定文字列のいずれも含まない市区町村の企業を返します。
`streetAddressPartialMatchOr`	array<string>	No	住所（番地以降）の部分一致フィルター（OR条件）。
`streetAddressPartialMatchNot`	array<string>	No	住所（番地以降）の部分一致除外フィルター。
`industryCategoryIdOr`	array<integer>	No	業界カテゴリIDフィルター（OR条件）。`/master/industries` で取得できる大分類IDを指定します。
`industryCategoryIdNot`	array<integer>	No	業界カテゴリIDフィルター（除外条件）。`/master/industries` で取得できる大分類IDを指定します。
`industrySubCategoryIdOr`	array<integer>	No	業界サブカテゴリIDフィルター（OR条件）。`/master/industries` で取得できる小分類IDを指定します。
`industrySubCategoryIdNot`	array<integer>	No	業界サブカテゴリIDフィルター（除外条件）。`/master/industries` で取得できる小分類IDを指定します。
`businessCategoryIdOr`	array<integer>	No	業種カテゴリIDフィルター（OR条件）。`/master/business-types` で取得できる大分類IDを指定します。
`businessCategoryIdNot`	array<integer>	No	業種カテゴリIDフィルター（除外条件）。`/master/business-types` で取得できる大分類IDを指定します。
`businessSubCategoryIdOr`	array<integer>	No	業種サブカテゴリIDフィルター（OR条件）。`/master/business-types` で取得できる小分類IDを指定します。
`businessSubCategoryIdNot`	array<integer>	No	業種サブカテゴリIDフィルター（除外条件）。`/master/business-types` で取得できる小分類IDを指定します。
`corporateTypeOr`	array<`CorporateType`>	No
`corporateTypeNot`	array<`CorporateType`>	No
`marketCodeOr`	array<string>	No	市場区分コードフィルター（OR条件）。`/master/markets` で取得できるコードを指定します。
`marketCodeNot`	array<string>	No	市場区分コードフィルター（除外条件）。`/master/markets` で取得できるコードを指定します。
`isListed`	boolean	No	上場/未上場フィルター。true=上場企業のみ、false=未上場企業のみ。<br>nullable
`revenueRangeOr`	array<`RevenueRange`>	No
`revenueRangeNot`	array<`RevenueRange`>	No
`employeeCountMin`	integer	No	従業員数の下限（以上）
`employeeCountMax`	integer	No	従業員数の上限（以下）
`capitalMillionYenMin`	number	No	資本金の下限（百万円単位、以上）
`capitalMillionYenMax`	number	No	資本金の上限（百万円単位、以下）
`hasCorporatePhone`	boolean	No	電話番号の有無でフィルター
`hasCorporateWebsite`	boolean	No	Webサイトの有無でフィルター
`hasCorporateEmail`	boolean	No	メールアドレスの有無でフィルター
`foundedAtFrom`	string	No	設立日の開始日（YYYY-MM-DD形式、以降）
`foundedAtTo`	string	No	設立日の終了日（YYYY-MM-DD形式、以前）
`corporateNumberOr`	array<string>	No	法人番号フィルター（OR条件）。13桁の法人番号を指定します。
`jobTitlePartialMatchOr`	array<string>	No	求人タイトルの部分一致フィルター（OR条件）。紐づく求人のタイトルに指定文字列のいずれかを含む企業を返します。
`jobTitlePartialMatchNot`	array<string>	No	求人タイトルの部分一致除外フィルター。紐づく求人のタイトルに指定文字列のいずれも含まない企業を返します。
`jobMediaIdOr`	array<integer>	No	求人媒体IDフィルター（OR条件）。`/master/media` で取得できるIDを指定します。
`jobMediaIdNot`	array<integer>	No	求人媒体IDフィルター（除外条件）。`/master/media` で取得できるIDを指定します。
`jobEmploymentTypeIdOr`	array<integer>	No	雇用形態IDフィルター（OR条件）。`/master/employment-types` で取得できるIDを指定します。
`jobEmploymentTypeIdNot`	array<integer>	No	雇用形態IDフィルター（除外条件）。`/master/employment-types` で取得できるIDを指定します。
`jobSalaryMin`	integer	No	求人の給与下限（円単位、以上）
`jobSalaryMax`	integer	No	求人の給与上限（円単位、以下）
`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を指定します。
`jobOpenedOnFrom`	string	No	掲載開始日の開始日（YYYY-MM-DD形式、以降）
`jobOpenedOnTo`	string	No	掲載開始日の終了日（YYYY-MM-DD形式、以前）
`jobDeadlineOnFrom`	string	No	掲載終了日の開始日（YYYY-MM-DD形式、以降）
`jobDeadlineOnTo`	string	No	掲載終了日の終了日（YYYY-MM-DD形式、以前）
`jobAdPlanOr`	array<string>	No	広告プランフィルター（OR条件）。紐づく求人の広告プラン名を指定します。
`jobHasDispatchLicense`	boolean	No	紐づく求人の派遣免許の有無でフィルター
`jobHasRecruitmentLicense`	boolean	No	紐づく求人の紹介免許の有無でフィルター
`jobHasContactEmail`	boolean	No	紐づく求人のメールアドレスの有無でフィルター
`jobHasContactPhone`	boolean	No	紐づく求人の電話番号の有無でフィルター
`jobCreatedAtFrom`	string	No	紐づく求人の作成日の開始日（YYYY-MM-DD形式、以降）
`jobCreatedAtTo`	string	No	紐づく求人の作成日の終了日（YYYY-MM-DD形式、以前）
`jobHiringPlanMinAtLeast`	integer	No	紐づく求人の採用予定最小人数が N 人以上（N を指定）<br>min: `0`
`fundingSeriesOr`	array<`FundingSeries`>	No	投資ラウンドフィルター（OR条件）。指定した投資ラウンドのいずれかに該当する企業を返します。
`fundingSeriesNot`	array<`FundingSeries`>	No	投資ラウンドフィルター（除外条件）。指定した投資ラウンドのいずれにも該当しない企業を返します。
`totalAdCostMin`	integer	No	広告出稿総額の下限（円、以上）<br>min: `0`
`totalAdCostMax`	integer	No	広告出稿総額の上限（円、以下）<br>min: `0`
`paidMediaSpendOr`	array<`PaidMediaSpendRange`>	No	出稿額レンジフィルター（OR条件）。
`paidMediaSpendNot`	array<`PaidMediaSpendRange`>	No	出稿額レンジフィルター（除外条件）。
`paidMediaUsedMediaIdOr`	array<integer>	No	掲載課金型媒体フィルター（OR条件）。`/master/media` で取得できる媒体IDを指定します。指定いずれかの媒体に掲載している企業を返します。
`paidMediaUsedMediaIdNot`	array<integer>	No	掲載課金型媒体フィルター（除外条件）。
`hasFax`	boolean	No	FAX 番号の有無でフィルター
`employeeDiff6mMinMin`	integer	No	6 ヶ月従業員増加数の下限（以上）
`employeeDiff6mMinMax`	integer	No	6 ヶ月従業員増加数の上限（以下）
`employeeDiff12mMin`	integer	No	12 ヶ月従業員増加数の下限（以上）
`employeeDiff12mMax`	integer	No	12 ヶ月従業員増加数の上限（以下）
`employeeTransitionPartialMatchOr`	array<string>	No	従業員推移フラグの部分一致フィルター（OR条件）。例：「6 ヶ月連続増加」「12 ヶ月連続増加」
`employeeTransitionPartialMatchNot`	array<string>	No	従業員推移フラグの部分一致除外フィルター。

Request Example

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

Responses

`200`

検索結果

フィールド	型	必須	説明
`totalResults`	integer	No	nullable
`results`	array<`Corporate`>	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": [
    {
      "corporateNumber": "string",
      "name": "string"
    }
  ]
}