中核となる次元
すべての拡大は、いくつかの独立した軸に沿って記述されます。これらを混同しないでください。
| フィールド | 何を捉えるか | 値の例 |
|---|
stage | 企業がある市場でどこまで進んだか | exploring、committing、expanding、scaling、established |
momentum | いま現在の動きの軌道 | accelerating、advancing、steady、pulling_back |
| flow（フロー） | 市場間の動きの方向。froms / tos で表現します | outbound（froms）、inbound（tos）、corridor（froms→tos） |
freshness | 証拠がどれだけ新しいか | fresh、cooling、stale、cold |
scope | 新規市場か、既存プレゼンス内での成長か | entering_new_market、expanding_within_presence、established_only |
expansion_score | 拡大の重要度を示すソート可能な 0–1 のランク | 0.72 |
段階の slug は exploring、committing、expanding、scaling、established で、それぞれ表示名 Exploring、Committing（投入中）、Expanding（展開中）、Scaling（規模拡大中）、Established に対応します。
フロー（動きの方向）と momentum（軌道）は別物です。「前進中の企業」でフィルタするのは momentum: ["advancing"]、「米国へ拡大している企業」でフィルタするのは tos: ["US"] です。独立した direction リクエストフィールドはありません——フローは froms / tos だけで決まります。
リクエストフィルタ
市場（froms / tos）
地理は有向の関係です：企業は出発地から到達地へと拡大します。2 つのリストであらゆるケースを表現でき、独立した方向フラグは不要です。
| パラメータ | 型 | 意味 |
|---|
froms | string[]（ISO alpha-2） | 出発市場——企業がどこから拡大しているか（本拠地 / 本社）。 |
tos | string[]（ISO alpha-2） | 到達市場——企業がどこへ拡大しているか。 |
exclude_froms | string[]（ISO alpha-2） | 除外する出発市場。 |
exclude_tos | string[]（ISO alpha-2） | 除外する到達市場。 |
| 送信する内容 | 得られる結果 |
|---|
tos: ["US"] | 米国へ参入するすべての企業（inbound）。 |
froms: ["CN"] | 中国企業がどこへでも拡大（outbound）。 |
froms: ["CN"]、tos: ["US"] | CN → US コリドーのみ。 |
| どちらも指定なし | 世界中のすべての拡大。 |
拡大シグナルのフィルタ
| パラメータ | 型 | 意味 |
|---|
stages | string[] | 1 つ以上の拡大段階に絞り込みます。 |
momentum | string[] | 軌道でフィルタします（accelerating/advancing/steady/pulling_back）。 |
freshness | string[] | 証拠の新しさでフィルタします（fresh/cooling/stale/cold）。 |
scopes | string[] | entering_new_market / expanding_within_presence でフィルタします。 |
signal_types | string[] | 特定のシグナルタイプに限定します（HIRE、OFFICE、AD、NEWS……）。 |
signal_strengths | string[] | 証拠の強度バケットでフィルタします（例：high、very_high）。 |
min_signal_count | integer | 拡大シグナルの最小数——足跡の大きい動き手を浮かび上がらせます。 |
ahead_of_pace | boolean | その市場の典型的なペースより速く動いている企業のみ。 |
only_contraction | boolean | リスクのある / 縮小中の市場のみ。 |
min_markets | integer | 企業がその期間内に参入した、異なる新規市場の最小数。 |
ファーモグラフィクス
| パラメータ | 型 | 意味 |
|---|
verticals、technologies | string[] | 企業の業界 / テックスタックのフィルタ。 |
employees | number[][] | 従業員数のレンジ、例：[[50, 200]]。 |
founded_dates | number[] | 設立年のレンジ [from, to]。 |
revenues | number[] | 売上高のレンジ（USD）[from, to]。 |
keywords | string[] | フリーテキストのテーマによるスコープ指定。 |
companies | string[] | domain_search_id、ドメイン、または LinkedIn URL の任意の組み合わせで特定企業に絞り込み（ドメイン / URL は最も上位の企業に解決されます）。 |
期間ウィンドウと検索
| パラメータ | 型 | 意味 |
|---|
transitioned_dates | string[] | シグナル / 遷移のウィンドウを ISO [from, to] レンジで指定。 |
window_days | integer | 日単位のローリングウィンドウ。transitioned_dates が指定されていない場合に使用。 |
query | string | 自然言語検索——Pubrio がフィルタに解釈します（filters に反映されて返されます）。 |
is_explain_match | boolean | 各企業に、その実際のシグナルに基づいた AI の match_summary を追加します。引用されるシグナルの件数とバッチサイズはいずれも per_page に応じて変化します。求人情報や広告キャンペーンなど発生頻度の高いソースは、個別に列挙せず件数としてまとめて表示されます。 |
sort_by | string | 結果の並び順：expansion_score、signal_count、または company_ranking。省略した場合はデフォルト（直近の遷移が新しい順）が適用されます。 |
レスポンスフィールド
企業単位 / 市場単位の stage
| フィールド | 意味 |
|---|
stage.slug | 現在の段階（exploring … scaling）。 |
stage.expansion_score | ソート可能な 0–1 の重要度ランク。 |
stage.scope | 新規市場 vs プレゼンス内。 |
stage.direction | その段階の軌道：advancing、steady、retreating、または new。これは軌道という軸のレスポンス側の表現で、momentum リクエストパラメータでフィルタするのと同じ軸です——値の集合が異なるため、対応づけてください。 |
stage.freshness | 最新の証拠の新しさバケット。 |
stage.signal_count | この市場でアクティブな拡大シグナルの数。 |
stage.first_signal_at / latest_signal_at / last_transition_at | 主要なタイムスタンプ。 |
シグナル、プレゼンス、説明
| フィールド | 意味 |
|---|
signals[] | 基礎となる証拠：signal_type、signal_subtype、signal_strength、polarity、event_date、source_type、display_label、evidence_url。 |
presence[] | 既知の市場内フットプリント（オフィス / 法人）：presence_type、presence_strength、address、known_since。 |
timeline[] | 段階遷移の履歴：stage_slug、transitioned_at、transition_kind。 |
other_markets[] | その企業の他のアクティブな市場。それぞれに段階 + カウントが付随します。 |
match_summary | （is_explain_match: true の場合） { text, citations }——AI による「なぜ一致するのか」。その企業の実際のシグナルを引用します。各引用には count フィールドがあります。実際の個別シグナルの場合は null、求人情報や広告キャンペーンなど期間内の件数集計を示す引用の場合は整数になります。 |
expansion_score はソート可能なランクです（企業間で比較可能）。これは内部モデルの信頼度とは別物であり、公開 API はその信頼度を返しません。
