> ## 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>
  このクイックスタートは、数回の呼び出しでゼロから実際のエクスパンションシグナルを読み取れる状態まで導きます。すでに Pubrio API キーをお持ちであることを前提としています——キーの作成については[認証](/jp/api-reference/authentication)を参照してください。
</Info>

## 前提条件

* Pubrio API キー（[認証](/jp/api-reference/authentication)を参照）。
* 企業の `domain_search_id`。[企業検索](/jp/api-reference/endpoint/companies/search)エンドポイントから取得できます。

すべての Expansion エンドポイントは `POST` であり、JSON ボディを受け付けます。[認証](/jp/api-reference/authentication)で説明されているとおり、すべてのリクエストに認証情報を含めてください。

## ステップ 1 — 企業の拡大を調べる

まず 1 社から始め、その企業が拡大しているすべての市場を一覧します。

```bash theme={null}
POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "is_all_markets": true }
```

```json theme={null}
{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "home_country_code": "US" },
  "data": { "market_count": 2, "dominant_stage_slug": "expanding", "total_signal_count": 194 },
  "markets_summary": [
    { "country_code": "GB", "stage_slug": "expanding", "is_home_market": false, "signal_count": 140, "distinct_type_count": 6, "latest_signal_at": "2026-07-08T02:42:23.544Z", "rank_now": 1 },
    { "country_code": "DE", "stage_slug": "committing", "is_home_market": false, "signal_count": 54, "distinct_type_count": 3, "latest_signal_at": "2026-06-20T00:00:00.000Z", "rank_now": 2 }
  ]
}
```

## ステップ 2 — 結果を読む

`markets_summary` の各エントリは、その企業が活動している 1 つの市場を表します：

* **`stage_slug`** — その市場で企業がどこまで進んだか（`exploring` → `scaling`）。
* **`signal_count`** / **`distinct_type_count`** — その市場を裏付ける証拠量と、シグナルタイプの数。
* **`latest_signal_at`** — 最新シグナルの新しさ。
* **`signal_velocity_30d`** / **`signal_velocity_90d`** — 活動が加速している速さ。
* **`rank_now`** — その企業にとってのその市場の現在の順位（`1` = 最強）。
* **`is_home_market`** — その企業の本社所在国かどうか。

最も新しい動き手を見つけたり軌道でフィルタしたりするには、次に紹介する発見系エンドポイント（`freshness`、`momentum`）を使用します。

## ステップ 3 — 市場全体を探索する

企業を起点にする代わりに市場を起点に作業するには、[エクスパンション市場詳細](/jp/api-reference/endpoint/expansions/market_lookup)を使用します。標準の `page` / `per_page` パラメータでページ分割されています。

地理は有向の **from → to** 関係で、2 つのリストで表現します：`froms`（出発 / 本社の市場）と `tos`（到達市場）。目的に合ったパターンを選んでください：

<CodeGroup>
  ```bash Inbound（GB へ） theme={null}
  POST /expansions/lookup
  {
    "tos": ["GB"],
    "freshness": ["fresh", "cooling"],
    "page": 1,
    "per_page": 25
  }
  ```

  ```bash Outbound（CN から） theme={null}
  POST /expansions/lookup
  {
    "froms": ["CN"],
    "freshness": ["fresh", "cooling"],
    "page": 1,
    "per_page": 25
  }
  ```

  ```bash Corridor（CN → GB） theme={null}
  POST /expansions/lookup
  {
    "froms": ["CN"],
    "tos": ["GB"],
    "page": 1,
    "per_page": 25
  }
  ```
</CodeGroup>

`metadata.pagination` を読んで結果をページ送りします。

```json theme={null}
{
  "metadata": {
    "filters": { "tos": ["GB"], "freshness": ["fresh", "cooling"] }
  },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 64, "total_pages": 3 },
    "companies": [ /* ... */ ]
  }
}
```

`page` をインクリメントして次のページをリクエストします。`per_page` はあなたのプランによって上限が設定されています。

## ステップ 4 — 証拠を掘り下げる

企業の動きの背後にある個々のシグナルが必要なときは、[企業シグナルイベント](/jp/api-reference/endpoint/expansions/company_pulse_events)を呼び出します。

```bash theme={null}
POST /expansions/companies/pulse_events
{
  "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
  "signal_types": ["HIRE", "EXEC", "NEWS"],
  "window_days": 90,
  "page": 1
}
```

このエンドポイントは `total_entries` と `total_pages` を返します——`1` ページ目から `total_pages` ページ目までリクエストしてください（`page` \< `total_pages` の間は続行）。

## フィルタリファレンス

ほとんどの Expansion エンドポイントは、これらのフィルタを受け付けます。有効な値は[エクスパンションシグナルの仕組み](/jp/knowledge-base/concepts/how-expansion-signals-work)に一覧されています。

| フィルタ           | 目的                                                            |
| -------------- | ------------------------------------------------------------- |
| `stages`       | 1 つ以上の拡大段階に限定します。                                             |
| `freshness`    | 証拠の新しさで限定します。                                                 |
| `momentum`     | 軌道（`accelerating`/`advancing`/`steady`/`pulling_back`）で限定します。 |
| `scopes`       | 市場参入のスコープで限定します。                                              |
| `signal_types` | 特定のシグナルの種類に限定します。                                             |
| `froms`        | 出発 / 本社の市場（**から**拡大）。                                         |
| `tos`          | ターゲット市場（**へ**拡大）。                                             |
| `companies`    | `domain_search_id`、ドメイン、または LinkedIn URL で特定企業に絞り込みます。        |

`companies` フィルタは識別子タイプの任意の組み合わせを受け付けます——事前に ID へ解決する必要はありません：

<CodeGroup>
  ```bash ドメインで theme={null}
  POST /expansions/lookup
  { "companies": ["stripe.com", "airbnb.com"] }
  ```

  ```bash LinkedIn URL で theme={null}
  POST /expansions/lookup
  { "companies": ["https://www.linkedin.com/company/stripe"] }
  ```

  ```bash domain_search_id で theme={null}
  POST /expansions/lookup
  { "companies": ["550e8400-e29b-41d4-a716-446655440002"] }
  ```
</CodeGroup>

<Warning>
  **フロー**と**軌道**を混同しないでください。フロー（市場間の動きの方向）は `froms` / `tos` で設定します——`direction` リクエストフィルタはありません。軌道（動きの進み方）は `momentum` フィルタで、レスポンスでは `direction` フィールドとして現れます。
</Warning>

## 次のステップ

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

  <Card title="Expansion エンドポイント" href="/jp/api-reference/endpoint/expansions/dashboard">
    すべての Expansion API エンドポイントを閲覧します。
  </Card>
</CardGroup>