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
例:
​
momentum
enum<string>[]

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

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

利用可能なオプション:
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,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
例:
​
signal_strengths
enum<string>[]

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

利用可能なオプション:
low,
medium,
high,
very_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"] のような自由テキスト入力も可能になります。

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

​
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

​
is_enable_similarity_search
boolean

verticals、vertical_categories、vertical_sub_categories、technologies の自由テキストマッチングを有効にします。有効にしない場合、これらのフィルターに指定した自由テキストの値は何にも一致しません。

例:

true

​
filter_conditions
object[]

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

レスポンス

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

​
metadata
object

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

​
data
object

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

最終更新日 2026年8月28日