メインコンテンツへスキップ
POST
類似企業を検索

承認

pubrio-api-key
string
header
必須

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの 設定 画面から発行できます。

ボディ

application/json
domain_search_id
string
必須

Pubrio company identifier.

domain
string

企業の主要ドメイン(例:stripe.com)。

例:

"stripe.com"

linkedin_url
string

LinkedIn company URL.

tiktok_url
string

企業の TikTok プロフィール URL。

wantedly_url
string

企業の Wantedly プロフィール URL。

tw104_url
string

企業の 104(台湾)プロフィール URL。

rocketpunch_url
string

企業の RocketPunch プロフィール URL。

remember_url
string

企業の Remember プロフィール URL。

youtrust_url
string

企業の YOUTRUST プロフィール URL。

company_name
string

検索結果を、指定した社名に一致する企業のみに絞り込むためのフィルターです。入力値が企業名と一致しない場合、その企業は他の条件を満たしていても結果に含まれず、部分一致によるマッチングもサポートされます。

例:

"pubrio"

companies
string<uuid>[]

企業および人物検索処理で利用する domain_search_id の一覧です。

domains
string[]

企業および人物検索に使用する会社ドメインの一覧です。www や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。

例:
linkedin_urls
string[]

企業の LinkedIn 公式ページを指す完全な URL です。値は http で始まり、linkedin.com/company/ を含んでいる必要があります。

例:
locations
string[]

ISO 3166-1 alpha-2(CCA2)コードで地域を指定するフィルターです。詳細はフィルタータブの location エンドポイントを参照します。

例:
exclude_locations
string[]

ISO 3166-1 alpha-2 コードで、検索結果から除外する地域を指定します。

例:
places
string[]

結果をフィルタリングするための場所名(都市または地域)です。ローカライズまたは英語の場所名を受け付けます。

例:
exclude_places
string[]

結果から除外する場所名(都市または地域)です。ローカライズまたは英語の場所名を受け付けます。

例:
job_locations
string[]

ISO 3166-1 alpha-2(CCA2)コードで地域を指定するフィルターです。詳細はフィルタータブの location エンドポイントを参照します。

例:
job_exclude_locations
string[]

求人結果から除外する地理的位置。

例:
job_posted_dates
string[]

求人の掲載日レンジです。最大値には当日が指定可能です。 日付境界はワークスペースのタイムゾーンに従います。

例:
job_titles
string[]

対象人物に関連する役職名です。完全一致でなくても、類似する役職を含む結果が返されます(例:software engineer で senior software engineer もヒット)。

例:
verticals
integer[]

特定の業界・業種セグメントに属する企業を検索するための vertical_id 一覧です。is_enable_similarity_search を有効化すると、["AI"] などの自由テキスト入力が可能です。

vertical_categories
integer[]

特定の業界カテゴリに属する企業を検索するための vertical_category_id の一覧です。フィルターは is_enable_similarity_search に対応しており、有効化すると ["Information Technology"] のような自由テキストから候補 ID を解決できます。

vertical_sub_categories
integer[]

特定の業界サブカテゴリに属する企業を検索するための vertical_sub_category_id の一覧です。is_enable_similarity_search を有効化すると、["Software"] のような自由テキスト入力に基づいて関連 ID を検索できます。

categories
integer[]

特定のテクノロジーカテゴリを利用している企業を検索するための category_id 一覧です。is_enable_similarity_search を有効化すると、["CDN"] のような自由テキスト入力も可能になります。

technologies
integer[]

特定のテクノロジーを利用している企業を検索するための tag_id 一覧です。ID はフィルタータブの technology エンドポイントから取得します。is_enable_similarity_search を有効化すると、["Shopify"] のような自由テキスト入力も可能になります。

テクノロジー一覧にある製品名は、その製品と同社の製品に一致します("Salesforce" は Salesforce Desk や Salesforce Service Cloud にも一致)。似た別製品には一致しません。それ以外のテキストは類似度で一致します。

employees
string[][]

企業の従業員数レンジを表します。複数レンジを指定することで、対象となる会社規模の幅を広げられます。詳細は company size エンドポイントを参照します。

例:
revenues
integer[]

企業収益の最小値と最大値を表すレンジです。

例:
founded_dates
integer[]

企業の設立年レンジです。最大値には当年が指定可能です。

例:
keywords
string[]

会社を関連性、専門分野、または説明でフィルタリングするためのキーワードのリスト。

例:
news_categories
string[]

特定のニュースカテゴリを検索するためのカテゴリスラッグ一覧です。スラッグは news categories エンドポイントから取得します。

例:
news_published_dates
string[]

ニュースの公開日レンジです。最大値には当日が指定可能です。 日付境界はワークスペースのタイムゾーンに従います。

例:
advertisement_search_terms
string[]

広告コンテンツやタイトル内で検索するために使用するキーワードです。

例:
advertisement_target_locations
string[]

広告のターゲット地理的位置。

例:
advertisement_exclude_target_locations
string[]

広告ターゲティングから除外する地理的位置。

例:
advertisement_start_dates
string<date>[]

広告フィルタリングの開始日範囲です。

例:
advertisement_end_dates
string<date>[]

広告フィルタリングの終了日範囲です。

例:
filter_conditions
object[]

企業検索の高度なフィルタリングオプションです。キーと論理演算子を組み合わせた条件を指定して検索結果を絞り込めます。

対応するフィルターで類似度検索を有効にするフラグです。有効化すると、ID ではなく自由テキストを渡しても、内部で類似スコアに基づいて候補を解決できます。

similarity_score
number<float>

is_enable_similarity_search と併用するスコアしきい値で、業種や技術などのスラッグとユーザー入力の近さを数値で指定します。値が高いほどマッチング条件が厳しくなり、より精度の高い結果に絞り込まれます。

例:

0.7

exclude_fields
string[]

レスポンスペイロードから除外するフィールドのリストです。

例:
is_parameter_metadata_available
boolean

リクエストにパラメータメタデータが利用可能かどうかを示します。

is_profile_metadata_available
boolean

リクエストにプロファイルメタデータが利用可能かどうかを示します。

per_page
integer
デフォルト:25

1 ページあたりの件数。既定は 25 で、多くのプランではこれが上限でもあります。制限値はサブスクリプションの max_search_per_page で、Profile から取得できます。超過すると結果が丸められるのではなく、HTTP 416 とコード 41676(企業・人物検索では 41613)が返ります。

必須範囲: x <= 25
例:

25

page
integer
デフォルト:1

ページ番号(1 から開始)。上限はサブスクリプションの max_search_page(企業検索では max_company_search_page)で、Profile から取得できます。超過すると HTTP 416 が返ります。

例:

1

company_filters
object

企業レベルフィルターのラッパーオブジェクト。推奨グループ化 — どのキーが人物を絞り(トップレベル)、どのキーが企業を絞るかを視覚的に分けます。トップレベルの企業フィルターと同じキーを受け付けます(例: technologies、verticals、vertical_categories、vertical_sub_categories、categories、keywords、founded_dates、employees、revenues、company_locations、company_exclude_locations、company_places、company_exclude_places、companies、domains、company_linkedin_urls、is_enable_similarity_search、similarity_score、および filter_conditions)。エンジンは処理前にこのオブジェクトをトップレベルに展開します — 同名キーがある場合はトップレベルが勝ちます。Monitor company_filters と同じ形状です。例はフィルター概要開発者ガイドを参照してください。

例:

レスポンス

関連する詳細情報を含む成功レスポンスです。

metadata
object

リクエストのコンテキスト。エコーされた filters と parameters、および credit・topup_credit・total_credit_cost を含む profile ブロックを保持します。これは API が返す唯一の呼び出し単位のクレジット計上情報です。

data
object[]

類似企業の一覧です。各企業は similarity_score を持ちます。このエンドポイントは配列をそのまま返します — 他の検索エンドポイントと異なり、data 内に pagination ラッパーはありません。ページ送りには page と per_page を使用します。

最終更新日 2026年4月22日