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

​
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 日付範囲 [start, end] です。デフォルトは直近 90 日間です。new_transitions_30d KPI はこの範囲に関わらず常に固定の 30 日間ウィンドウを使用します。

例:
​
window_days
integer

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

例:

90

​
min_markets
integer

対象期間内に企業が参入した新規市場の最小数（展開の広い企業の絞り込み）。

例:

3

​
home_country_code
string[]

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

例:
​
industries
string[]

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

例:
​
exclude_industries
string[]

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

例:
​
select_size
integer

返却する市場数の上限です(プランによる上限あり)。

例:

250

​
flows_size
integer

返却するクロスボーダーフロー数の上限です(プランによる上限あり)。

例:

50

​
is_include_metadata
boolean

詳細ペイロード全体を返します。API キーによるリクエストは既定で軽量です。これが true でない限り、model ブロック、信頼度の値（企業拡大詳細の stage.confidence、other_markets[] およびランキングの markers[] の confidence_score）、established_min / share_of_detected / has_known_office の各フィールドはいずれも省略されます。

例:

true

レスポンス

200 - application/json

市場ダッシュボードの集計データです。

​
metadata
object
​
data
object

ダッシュボードのコンテナ: ランク付けされた市場と、主要なコリドーフローです。 非推奨のレガシーミラー。data 内の各コンテナは、旧クライアント向けにトップレベルにも出力されます（countries、top_flows、picks_aggregate、watchlist_markets、watchlist_timeline）。data から読み取ってください。トップレベルの複製は今後削除されます。