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>[]

値は大文字・小文字を区別し、検証されません。認識されない値はエラーにならず黙って破棄されます。stages、freshness、scopes、momentum ではフィルター全体が破棄され絞り込まれていない結果が返り、signal_types と signal_strengths ではフィルターが適用されて何にも一致しません。いずれの場合もレスポンスは正常に見えます。有効なスラッグは Expansion Reference から取得し、結果が不自然な場合は data.pagination.total_entries をフィルターなしの呼び出しと比較してください。

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

当該市場における企業の推移。advancing は前進、steady は横ばい、pulling_back は縮小・撤退を表します。

ここで Expansion Reference の directions の値を使用しないでください。それらの値（advancing、steady、retreating、new）は stage.direction として返るレスポンス側の値であり、フィルターとして受け付けられるのは上記の 3 つだけです。retreating や new を指定するとフィルターが黙って無効化され、絞り込まれていない結果が返ります。

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

値は大文字・小文字を区別し、検証されません。認識されない値はエラーにならず黙って破棄されます。stages、freshness、scopes、momentum ではフィルター全体が破棄され絞り込まれていない結果が返り、signal_types と signal_strengths ではフィルターが適用されて何にも一致しません。いずれの場合もレスポンスは正常に見えます。有効なスラッグは Expansion Reference から取得し、結果が不自然な場合は data.pagination.total_entries をフィルターなしの呼び出しと比較してください。

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

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

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

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

例:

false

​
signal_types
enum<string>[]

値は大文字・小文字を区別し、検証されません。認識されない値はエラーにならず黙って破棄されます。stages、freshness、scopes、momentum ではフィルター全体が破棄され絞り込まれていない結果が返り、signal_types と signal_strengths ではフィルターが適用されて何にも一致しません。いずれの場合もレスポンスは正常に見えます。有効なスラッグは Expansion Reference から取得し、結果が不自然な場合は data.pagination.total_entries をフィルターなしの呼び出しと比較してください。

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

値は大文字・小文字を区別し、検証されません。認識されない値はエラーにならず黙って破棄されます。stages、freshness、scopes、momentum ではフィルター全体が破棄され絞り込まれていない結果が返り、signal_types と signal_strengths ではフィルターが適用されて何にも一致しません。いずれの場合もレスポンスは正常に見えます。有効なスラッグは Expansion Reference から取得し、結果が不自然な場合は data.pagination.total_entries をフィルターなしの呼び出しと比較してください。

利用可能なオプション:
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 でない限り、model ブロック、信頼度の値（企業拡大詳細の stage.confidence、other_markets[] およびランキングの markers[] の confidence_score）、established_min / share_of_detected / has_known_office の各フィールドはいずれも省略されます。

例:

true

​
page
integer
デフォルト:1

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

例:

1

​
per_page
integer
デフォルト:25

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

必須範囲: x <= 25
例:

25

レスポンス

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

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