Skip to main content
POST
拡大検索

承認

​
pubrio-api-key
string
header
必須

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

ボディ

application/json
​
froms
string[]

出発市場（ISO 3166-1 alpha-2）。企業がどの市場から拡大しているか —— 本社 / 母国。単独で使うとこれらの市場から外へ拡大する企業を検索でき、tos と組み合わせると特定の 出発→到達 コリドーを指定できます。

例:
​
tos
string[]

到達市場（ISO 3166-1 alpha-2）。企業がどの市場へ拡大しているか。単独で使うとこれらの市場に参入するすべての企業を検索でき、froms と組み合わせると特定の 出発→到達 コリドーを指定できます。

例:
​
exclude_froms
string[]

除外する出発市場（ISO 3166-1 alpha-2）。

例:
​
exclude_tos
string[]

除外する到達市場（ISO 3166-1 alpha-2）。

例:
​
stages
enum<string>[]

1 つ以上のエクスパンションステージに絞り込みます。ステージの定義は Expansion Signals ナレッジベースを参照してください。

利用可能なオプション:
exploring,
committing,
expanding,
scaling,
established
例:
​
momentum
enum<string>[]

エクスパンションモメンタム(ステージ間の推移軌跡)で絞り込みます: accelerating(モード変化を伴う前進の加速)、advancing(前進)、steady(横ばい)、pulling_back(後退・縮小)。

利用可能なオプション:
accelerating,
advancing,
steady,
pulling_back
例:
​
freshness
enum<string>[]

証拠の新しさでフィルタします：fresh（約 30 日）、cooling（約 30〜60 日）、stale（約 60〜90 日）、cold（90 日超）。

利用可能なオプション:
fresh,
cooling,
stale,
cold
例:
​
scopes
enum<string>[]

市場参入のスコープでフィルタします。

利用可能なオプション:
entering_new_market,
expanding_within_presence,
established_only
例:
​
ahead_of_pace
boolean

その市場の標準的なペースより速く動いているペアに限定します。

例:

false

​
signal_types
enum<string>[]

特定のシグナルの種類に絞り込みます。定義とティアについてはナレッジベースのシグナルタイプカタログを参照してください（DNS と INFRA は Premier ティアのシグナルです）。

利用可能なオプション:
AD,
NEWS,
DNS,
INFRA,
PARTNER,
EVENT_PLUS,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
例:
​
signal_strengths
enum<string>[]

エビデンス確信度の区分で絞り込みます：low、medium、high。シグナルレコードに返されるシグナル単位の signal_strength_slug（low〜very_high の範囲）とは別物である点に注意してください。これら以外の値を指定しても何もマッチしません。

利用可能なオプション:
low,
medium,
high
例:
​
min_signal_count
integer

その期間内で企業が持つべき拡大シグナルの最小件数です — 「非常に活発 / 展開の広い」企業を絞り込みます。

例:

3

​
only_contraction
boolean

true の場合、縮小フラグの付いた拡大のみを返します（規模を縮小している企業）。

例:

false

​
min_markets
integer

対象期間内に企業が参入した新規市場の最小数。

例:

3

​
home_country_code
string[]

企業のホームカントリー（本国）で絞り込みます（ISO 3166-1 alpha-2）。froms と両方指定した場合は積集合になります。

例:
​
industries
string[]

業界名で絞り込みます（自由テキスト一致）。

例:
​
exclude_industries
string[]

除外する業界（自由テキスト一致）。

例:
​
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 を検索できます。

​
technologies
integer[]

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

​
employees
string[][]

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

例:
​
revenues
integer[]

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

例:
​
founded_dates
integer[]

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

例:
​
keywords
string[]

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

例:
​
companies
string[]

domain_search_id、会社ドメイン、または会社のソーシャルメディアプロフィール URL の任意の組み合わせで企業を指定します。ドメインと URL は最も上位の企業に解決されます。

例:
​
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 もヒット）。

例:
​
advertisement_target_locations
string[]

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

例:
​
advertisement_exclude_target_locations
string[]

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

例:
​
advertisement_search_terms
string[]

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

例:
​
advertisement_start_dates
string<date>[]

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

例:
​
advertisement_end_dates
string<date>[]

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

例:
​
news_categories
string[]

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

例:
​
news_published_dates
string[]

ニュースの公開日レンジです。最大値には当日が指定可能です。

例:
​
transitioned_dates
string<date>[]

タイムラインウィンドウ用の ISO 日付範囲です。デフォルトは直近 90 日間です。. A natural-language query may also set this from calendar phrases ("this year", "last year", "Q2 2026").

例:
​
window_days
integer

任意。ローリングウィンドウの日数。明示的な transitioned_dates 範囲が指定されていない場合に使用されます。両方とも省略した場合はデフォルトのウィンドウが使用されます。

例:

90

​
query
string

Pubrio が拡大および企業のフィルターに解釈する自然言語クエリ。

例:

"fintech companies expanding into the UK"

​
is_explain_match
boolean

各企業が検索条件に一致する理由を、その企業の実際のシグナルに基づいて AI が生成した説明として付与します。自然言語クエリと併用するのが最適です。 引用されるシグナルの件数とバッチサイズはいずれも per_page に応じて変化します。求人情報や広告キャンペーンなど発生頻度の高いソースは、個別に列挙せず、期間内の件数としてまとめて表示されます（例：「12件の求人情報」）。

例:

true

​
sort_by
enum<string>

結果の並び順。省略した場合はデフォルトの関連度順が適用されます：まず裏付けのあるペア（2 種類以上の異なるシグナルタイプ）、次に反復エビデンスのペア（3 件以上のシグナル）、その後に残り — 各ティア内では直近の遷移が新しい順。recent — 純粋な新着順（直近の遷移が新しい順）。expansion_score — 拡張スコアが高い順。signal_count — そのペアのシグナル数が多い順。company_ranking — Pubrio の総合企業ランキング順（数値が小さいほど知名度が高い）、昇順。

利用可能なオプション:
recent,
expansion_score,
signal_count,
company_ranking
例:

"expansion_score"

​
is_include_metadata
boolean

API キーのレスポンスはデフォルトで軽量です。true に設定すると、完全な metadata ブロック（集計、top origins/destinations、上位業界、タイムライン）と企業ごとのモデル詳細が含まれます。

例:

true

​
page
integer

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

例:

1

​
per_page
integer

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

例:

25

​
profile_id
integer

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

レスポンス

200 - application/json

対象市場で拡大している企業のページ分割リスト。filters は適用済み（または自然言語で解釈された）条件を反映し、is_explain_match が true の場合は各企業に match_summary が含まれます。

​
metadata
object

検索メタデータ：実際に適用されたフィルタと、市場ロールアップ（aggregate、地理スコープ、top origins/destinations/industries、timeline）。API キーのレスポンスでは、is_include_metadata が true の場合にのみロールアップが含まれます。

​
data
object

結果コンテナ（標準の検索エンベロープ）：企業リストとページネーション。