> ## 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 を端から端まで使い、1 社を市場ビューから個々のシグナルまで追っていきます。

<Info>
  このウォークスルーでは、1 つの問い——*「今まさにイギリスへ拡大している企業はどこで、その理由は何か？」*——を、市場ダッシュボードから、ある 1 社の動きの背後にある個々のシグナルまで追っていきます。以下のすべてのリクエストとレスポンスは、実際の Expansion API の形式を使用しています。
</Info>

## シナリオ

あなたは**イギリス**で事業を立ち上げる企業に販売しています。最も新しいインバウンドの動きを把握したうえで、そのうちの 1 社が*なぜ*拡大しているのかを理解し、アプローチのタイミングを合わせたいと考えています。

## ステップ 1 — イギリスへの新しいインバウンドの動きを見つける

`tos: ["GB"]` を指定して英国へ**参入する**すべての企業を見つけ、鮮度フィルタを加えることで、実際に参入してきている企業だけを表示します。

```bash theme={null}
POST /expansions/lookup
{
  "tos": ["GB"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}
```

レスポンスは市場を要約し、そこへ拡大している企業を一覧します。

```json theme={null}
{
  "metadata": {
    "filters": { "tos": ["GB"], "freshness": ["fresh", "cooling"] },
    "aggregate": { "total_companies_with_signals": 64, "committing_count": 22, "expanding_count": 15 },
    "top_origins": [{ "home_country_code": "CN", "company_count": 18 }],
    "top_industries": [{ "industry": "Consumer Electronics", "count": 9 }]
  },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 64, "total_pages": 3 },
    "companies": [
      {
        "expansion_id": "6845525",
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "company_name": "Example Corp",
        "domain": "example.com",
        "home_country_code": "CN",
        "country_code": "GB",
        "industry": "Consumer Electronics",
        "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 7 }
      }
    ]
  }
}
```

`expansion_score` で並べ替えて、最も決定的に動いている企業を先頭に表示します。ここでは、中国を本拠とする企業（`home_country_code: "CN"`）が GB で **展開中**（`expanding`）の段階にあり、**advancing** の推移を示しています——強く新しいインバウンドの動きです。

## ステップ 2 — その企業の完全な市場マップを見る

`domain_search_id` を取得し、その企業が拡大しているすべての市場を一覧します。

```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 }
  ]
}
```

この企業はイギリスでは展開中（`expanding`）、ドイツでは投入中（`committing`）の段階にあります——適切な地域を優先するうえで有用な文脈です。

## ステップ 3 — イギリスでの動きを深く理解する

「企業と市場」の詳細を掘り下げ、現在の段階、根底にあるシグナル、把握済みのプレゼンス、そして段階遷移のタイムラインを確認します。

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

```json theme={null}
{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB" },
  "data": {
    "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
    "country_code": "GB",
    "country_name": "United Kingdom",
    "stage_rank": 3,
    "stage_name": "Expanding",
    "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 27 }
  },
  "signals": [
    {
      "signal_type_slug": "EXEC",
      "display_label": "Hired Regional VP for UK & Ireland",
      "polarity": "expansion",
      "event_date": "2026-06-20T14:00:00.000Z"
    }
  ],
  "presence": [
    { "presence_type": "office", "address": "London, UK", "known_since": "2026-03-15T00:00:00.000Z" }
  ]
}
```

展開中（`expanding`）の段階は、イギリスでのシニア採用とロンドンのオフィスによって裏付けられています——推測ではなく、具体的な証拠です。

## ステップ 4 — 個々のイベントを読む

その動きを推進している完全なページ分割済みイベントリストを得るには、関心のあるシグナルの種類を指定してシグナルイベントエンドポイントを呼び出します。

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

```json theme={null}
{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002" },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 42, "total_pages": 2, "total_display_pages": 2, "is_timeout": false },
    "events": [
      {
        "signal_type_slug": "EXEC",
        "country_code": "GB",
        "display_label": "Hired Regional VP for UK & Ireland",
        "evidence_url": "https://www.linkedin.com/company/example-corp",
        "event_date": "2026-06-20T14:00:00.000Z"
      }
    ]
  }
}
```

`page` が `total_pages` に達するまで `page` をインクリメントして、「さらに読み込む」コントロールを動かします。

## あなたが今行ったこと

あなたは、*ある市場* → *動いている企業のランク付けされたリスト* → *1 社の完全な足跡* → *そのイギリスでの展開（`expanding`）の背後にある正確なシグナル* へと進みました。これが Expansion API の中心となるループです。広く始め、1 社へ絞り込み、そして証拠を読む。

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

  <Card title="エクスパンションシグナルの仕組み" href="/jp/knowledge-base/concepts/how-expansion-signals-work">
    上記で使用した値の完全なカタログ。
  </Card>
</CardGroup>