Skip to main content
POST
類似企業を検索

承認

pubrio-api-key
string
header
必須

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

ボディ

application/json
company_name
string

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

:

"pubrio"

companies
string<uuid>[]

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

domains
string[]

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

:
linkedin_urls
string[]

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

:
company_filters
object

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

:
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 engineersenior 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"] のような自由テキスト入力も可能になります。

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

1 ページあたりに返される検索結果件数です。ページサイズを制限することで、レスポンス速度や API パフォーマンスの向上が期待できます。

:

25

page
integer

取得したい結果セットのページ番号です。

:

1

profile_id
integer

オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム(ワークスペース)に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。

レスポンス

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

data
object | null

エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。