> ## 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 のタスク別エンドポイントガイド — 発見、企業詳細、シグナルフィード、比較、マップ、参照値のそれぞれに、どのエンドポイントを呼べばよいか。

Expansion API は少数のエンドポイントで構成され、それぞれが企業の新市場への成長について異なる問いに答えます。このガイドは **何をしたいか** を **どのエンドポイントを呼ぶか** に対応づけ、推測する必要をなくします。

<Info>
  概念(ステージ、シグナル、モメンタム、鮮度)が初めてですか? まずは [エクスパンションシグナルとは?](/jp/knowledge-base/concepts/expansion-signals) から始めてください — このガイドはそれらを理解している前提で、エンドポイントの選択に焦点を当てています。
</Info>

## タスクで選ぶ

| やりたいこと                                                                                     | 呼ぶもの                                                                          |
| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- |
| ある市場へ拡大している **企業を見つける**(フィルターまたは自然言語クエリで)                                                  | [エクスパンション検索](/jp/api-reference/endpoint/expansions/market_lookup)             |
| **市場レベルの KPI とフロー** を見る(ステージごとの件数、主要なコリドー)                                                 | [エクスパンション概要](/jp/api-reference/endpoint/expansions/dashboard)                 |
| **ある市場における 1 社のステータス** を取得する — ステージ、プレゼンス、履歴、そしてその裏付けとなるシグナル                               | [企業エクスパンション詳細](/jp/api-reference/endpoint/expansions/company_lookup)          |
| ある企業のシグナルイベントの **エンリッチ済み・期間指定のフィード** を取得する                                                 | [企業シグナルイベント](/jp/api-reference/endpoint/expansions/company_pulse_events)      |
| 対象企業からシードして、複数企業の拡大状況を並べて **比較する**                                                         | [企業エクスパンション比較](/jp/api-reference/endpoint/expansions/company_compare)         |
| すでに持っている企業セット(ドメイン、LinkedIn URL、または ID)について **そのまま表示に使える比較指標**(市場数、モメンタム、エクスパンションスコア)を取得する | [企業エクスパンションのバッチサマリー](/jp/api-reference/endpoint/expansions/company_summaries) |
| **スコア順の企業/市場のポイント** をマップやヒートマップにプロットする                                                     | [エクスパンションランキング](/jp/api-reference/endpoint/expansions/company_markers)        |
| **フィルターと enum の値** を解決する(ステージ、シグナルタイプ、鮮度…)                                                 | [エクスパンションリファレンス](/jp/api-reference/endpoint/expansions/types)                 |

## エンドポイント早見表

<CardGroup cols={2}>
  <Card title="エクスパンション検索" icon="magnifying-glass" href="/jp/api-reference/endpoint/expansions/market_lookup">
    発見用のエンドポイントです。拡大ステージ、鮮度、市場、そして企業ファーモグラフィックの全スイートで企業を絞り込む — あるいは自然言語の `query` を渡します。ページネーション付きの企業リストを返します。
  </Card>

  <Card title="エクスパンション概要" icon="chart-simple" href="/jp/api-reference/endpoint/expansions/dashboard">
    市場レベルの集計値: ステージごとの件数、主要なクロスボーダーフロー、ウォッチ中企業のアクティビティ。ページネーションなし — ダッシュボードのスナップショットです。
  </Card>

  <Card title="企業エクスパンション詳細" icon="building-magnifying-glass" href="/jp/api-reference/endpoint/expansions/company_lookup">
    1 つの市場における 1 社: 現在のステージ、スコア、プレゼンス、遷移履歴、そして裏付けとなるシグナル。市場ごとのスナップショットです。
  </Card>

  <Card title="企業シグナルイベント" icon="timeline" href="/jp/api-reference/endpoint/expansions/company_pulse_events">
    シグナルタイプと期間をまたいだ、ある企業のシグナルイベントのエンリッチ済み・ページネーション付きフィード。アクティビティのドリルダウンです。
  </Card>

  <Card title="企業エクスパンション比較" icon="scale-balanced" href="/jp/api-reference/endpoint/expansions/company_compare">
    1 回の呼び出しで複数企業を並べて表示。週次のシグナル系列とオプションのピアシーディング付き。比較グリッド向けに作られています。
  </Card>

  <Card title="企業エクスパンションのバッチサマリー" icon="table" href="/jp/api-reference/endpoint/expansions/company_summaries">
    domain\_search\_id、ドメイン、LinkedIn URL の任意の組み合わせを解決し、比較と同じデータに加えて計算済みのサマリーブロックを返します — 対象企業もピアシーディングもありません。
  </Card>

  <Card title="エクスパンションランキング" icon="map-location-dot" href="/jp/api-reference/endpoint/expansions/company_markers">
    軽量でスコア順にランク付けされた企業/市場ペアのリスト — 最小限のフィールド、ページネーションなし — 高速なマップとヒートマップのレンダリング用です。
  </Card>
</CardGroup>

## 「詳細」と「シグナルイベント」 — どちらを使う?

これは最もよくある混乱ポイントです。**どちらもシグナルを扱う** からです。違いは *スナップショットかフィードか* にあります:

|          | 企業エクスパンション詳細                                            | 企業シグナルイベント                                                      |
| -------- | ------------------------------------------------------- | --------------------------------------------------------------- |
| **スコープ** | 1 社 × **1 市場**                                          | 1 社、**その全ての海外市場** をまたぐ                                          |
| **市場**   | `country_code` で**単一市場**、または `is_all_markets` で企業全体を一度に | 既定で**全ての海外市場**(本国市場は除外);`country_codes`(配列)で特定市場に絞り込み           |
| **返すもの** | ステージ、スコア、プレゼンス、履歴 **+ 裏付けシグナル**                         | **エンリッチ済みシグナルイベント**(根拠 URL、採用ロスター、ラベル)                          |
| **時間軸**  | 現在の状況                                                   | 任意に選んだ **期間**(`window_days` — 既定 90 — または `transitioned_dates`) |
| **形状**   | 構造化されたスナップショットオブジェクト                                    | ページネーション付きのイベントフィード(「もっと読み込む」)                                  |
| **使うとき** | 「この企業の**ある 1 つの**市場でのステータスは? その理由は?」                    | 「この企業の拡大を推進している**全ての**市場の全ストリームを見せて」                            |

<Tip>
  **ほとんどの統合は企業エクスパンション詳細だけで十分です** — ある市場における企業のステージの裏付けとなるシグナルを既に返します。リッチでフィルター可能・期間指定可能なイベントストリームが特に必要なとき(例: アクティビティのタイムライン UI を構築する場合)に **企業シグナルイベント** を使ってください。
</Tip>

## 「比較」と「バッチサマリー」 — どちらを使う?

どちらも同じ企業ごとのエクスパンションデータを並べて返します。違いは *識別子と使い方* です:

|              | 企業エクスパンション比較                         | 企業エクスパンションのバッチサマリー                                            |
| ------------ | ------------------------------------ | ------------------------------------------------------------- |
| **入力**       | `domain_search_id` のみ                | `domain_search_id`、`domain`、`linkedin_url` の任意の組み合わせ          |
| **ピアシーディング** | オプション、`seed_target` 経由               | なし — 各企業は独立しています                                              |
| **計算済みの集計**  | なし(市場数/モメンタム/スコアは自分で計算)              | 企業ごとに `summary` ブロックを含む(アクティブ/新規市場数、モメンタム、エクスパンションスコア、ステージ構成) |
| **使うとき**     | 解決済みの ID があり、1 社を対象に比較可能なピアをシードしたいとき | ドメインや LinkedIn URL で企業が与えられており、1 回の呼び出しでそのまま表示できる比較指標が欲しいとき   |

<Tip>
  **対象企業を中心に競合ベンチマークのグリッドを作りたいですか?** **比較** に `seed_target` を渡してピアを自動選択してください。**すでに企業セット**(ウォッチリスト、CRM インポート、ドメインのリスト)**があり、数値だけが欲しいですか?** **企業エクスパンションのバッチサマリー** を使えば、モメンタム/スコアの計算をクライアント側で再実装する必要がありません。
</Tip>

## 典型的なワークフロー

<Steps>
  <Step title="発見する" icon="magnifying-glass">
    フィルター(または自然言語の `query`)を付けて **エクスパンション検索** を呼び、対象市場へ拡大している企業を取得します。AI による「なぜ一致するか」のサマリーが欲しい場合は `is_explain_match: true` を設定します。
  </Step>

  <Step title="企業を深掘りする" icon="building-magnifying-glass">
    結果から `domain_search_id` を取り、**企業エクスパンション詳細** を呼んで市場での全情報を読み取ります — ステージ、プレゼンス、履歴、シグナル。
  </Step>

  <Step title="アクティビティフィードを見る(任意)" icon="timeline">
    リッチで期間指定されたイベントストリームを得るには、関心のあるシグナルタイプと期間を指定して **企業シグナルイベント** を呼びます。
  </Step>

  <Step title="比較またはマップ化する" icon="scale-balanced">
    対象企業からシードした並列グリッドには **企業エクスパンション比較** を、企業セットが既にあり出来合いの指標が欲しい場合は **企業エクスパンションのバッチサマリー** を、ランク付けされたポイントをマップにプロットするには **エクスパンションランキング** を使います。
  </Step>
</Steps>

## 共有フィルター

発見系のエンドポイント(**エクスパンション検索**、**エクスパンション概要**、**エクスパンションランキング**)は同じフィルター語彙を受け付けます — 拡大フィルター(ステージ、軌道、鮮度、スコープ、シグナルタイプ)、有向地理ペア(`froms` / `tos`)**および** 企業ファーモグラフィックの全スイート(業種、テクノロジー、従業員規模、売上、保存済みリスト)です。フィルターは [フィルター概要](/jp/developer-guides/filters/overview) で一度学べば十分です。有効な値は [エクスパンションリファレンス](/jp/api-reference/endpoint/expansions/types) と [エクスパンションシグナルの仕組み](/jp/knowledge-base/concepts/how-expansion-signals-work) のカタログにあります。

<CardGroup cols={2}>
  <Card title="Expansion API を使う" icon="code" href="/jp/knowledge-base/concepts/expansion-api-quickstart">
    認証、最初の呼び出し、ページネーション、スコアの読み方。
  </Card>

  <Card title="実践例" icon="route" href="/jp/knowledge-base/concepts/expansion-signals-example">
    市場からシグナルまでの完全なウォークスルー。
  </Card>
</CardGroup>