> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 拡大フィールドリファレンス

> Expansion API のフィールド別ディクショナリ——すべてのリクエストフィルタとレスポンスフィールド、その型、許容値、意味。

<Info>
  本ページは Expansion API の**フィールドディクショナリ**です。各リクエストフィルタが何をするのか、各レスポンスフィールドが何を意味するのかを解説します。モデルの背後にある*理由*については [拡大シグナルの仕組み](/jp/knowledge-base/concepts/how-expansion-signals-work) を、値のカタログについては [エクスパンションシグナルの仕組み](/jp/knowledge-base/concepts/how-expansion-signals-work) をご覧ください。常に最新の許容値リストを得るには、[Expansion Taxonomy](/jp/api-reference/endpoint/expansions/types) エンドポイントを呼び出してください。
</Info>

## 中核となる次元

すべての拡大は、いくつかの独立した軸に沿って記述されます。これらを混同しないでください。

| フィールド             | 何を捉えるか                               | 値の例                                                                  |
| ----------------- | ------------------------------------ | -------------------------------------------------------------------- |
| `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`                                                               |

<Note>
  段階の slug は `exploring`、`committing`、`expanding`、`scaling`、`established` で、それぞれ表示名 Exploring、Committing（投入中）、Expanding（展開中）、Scaling（規模拡大中）、Established に対応します。
</Note>

<Warning>
  **フロー**（動きの方向）と `momentum`（軌道）は別物です。「前進中の企業」でフィルタするのは `momentum: ["advancing"]`、「*米国へ*拡大している企業」でフィルタするのは `tos: ["US"]` です。独立した `direction` リクエストフィールドはありません——フローは `froms` / `tos` だけで決まります。
</Warning>

## リクエストフィルタ

### 市場（`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`、求人情報や広告キャンペーンなど期間内の件数集計を示す引用の場合は整数になります。 |

<Note>
  `expansion_score` は**ソート可能なランク**です（企業間で比較可能）。これは内部モデルの信頼度とは別物であり、公開 API はその信頼度を返しません。
</Note>