> ## 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.

# 扩张信号：实例演练

> 跟随一家公司从市场视图深入到单条信号，端到端地使用扩张 API。

<Info>
  本演练围绕一个问题展开——*"此刻有哪些公司正在向英国扩张，原因是什么？"*——从市场仪表盘一路深入到一家公司举措背后的单条信号。下文中的每一个请求和响应都使用真实的扩张 API 结构。
</Info>

## 场景

您向正在英国设立业务的公司销售产品。您想要最新的入境行动者（inbound movers），然后想理解其中一家公司扩张的*原因*，以便把握外联时机。

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

该公司在英国处于拓展中阶段，在德国处于投入中阶段——这是为正确地区排定优先级的有用背景信息。

## 第 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" }
  ]
}
```

拓展中阶段由一名英国地区高管聘任和一处伦敦办公室作为支撑——是具体证据，而非猜测。

## 第 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`，来驱动"加载更多"控件。

## 您刚刚做了什么

您从*一个市场* → *一份排序后的行动者名单* → *一家公司的完整足迹* → *其在英国扩张背后的确切信号*。这就是扩张 API 的核心循环：从宽泛入手，收窄到一家公司，然后读取证据。

<CardGroup cols={2}>
  <Card title="使用扩张 API" href="/cn/knowledge-base/concepts/expansion-api-quickstart">
    身份验证、分页以及您的首批调用。
  </Card>

  <Card title="扩张信号的工作原理" href="/cn/knowledge-base/concepts/how-expansion-signals-work">
    上文所用各值的完整目录。
  </Card>
</CardGroup>