> ## 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 的任务到端点指南 — 在发现、公司详情、信号流、对比、地图和参考值等场景下,该调用哪个端点。

扩张 API 是一组精简的端点,每个都回答关于公司如何进入新市场的不同问题。本指南把**你想做什么**映射到**该调用哪个端点**,让你无需再去猜测。

<Info>
  对相关概念(阶段、信号、势头、新鲜度)还不熟悉?请先阅读 [什么是扩张信号?](/cn/knowledge-base/concepts/expansion-signals) — 本指南假定你已了解这些概念,并专注于端点的选择。
</Info>

## 按任务选择

| 你想要…                                                           | 调用                                                                    |
| -------------------------------------------------------------- | --------------------------------------------------------------------- |
| **查找正在进入某市场的公司**(通过筛选器或自然语言查询)                                 | [扩张搜索](/cn/api-reference/endpoint/expansions/market_lookup)           |
| 查看**市场级 KPI 与流向**(各阶段计数、热门走廊)                                  | [扩张概览](/cn/api-reference/endpoint/expansions/dashboard)               |
| 获取**某家公司在某市场的状态** — 阶段、存在情况、历史,以及背后的信号                         | [公司扩张详情](/cn/api-reference/endpoint/expansions/company_lookup)        |
| 获取某公司信号事件的**富化、按时间窗口划分的信号流**                                   | [公司信号事件](/cn/api-reference/endpoint/expansions/company_pulse_events)  |
| 以某个目标公司为种子,将多家公司的扩张情况**并排对比**                                  | [对比公司扩张](/cn/api-reference/endpoint/expansions/company_compare)       |
| 为你已有的一组公司(通过域名、LinkedIn URL 或 ID)获取**可直接渲染的对比指标**(市场数、动量、扩张评分) | [批量获取公司扩张摘要](/cn/api-reference/endpoint/expansions/company_summaries) |
| 在地图或热力图上绘制**经排名的公司/市场坐标点**                                     | [扩张排名](/cn/api-reference/endpoint/expansions/company_markers)         |
| 解析**筛选器和枚举值**(阶段、信号类型、新鲜度……)                                   | [扩张参考](/cn/api-reference/endpoint/expansions/types)                   |

## 端点一览

<CardGroup cols={2}>
  <Card title="扩张搜索" icon="magnifying-glass" href="/cn/api-reference/endpoint/expansions/market_lookup">
    发现端点。按扩张阶段、新鲜度、市场以及完整的公司画像维度筛选公司 — 或传入自然语言 `query`。返回分页的公司列表。
  </Card>

  <Card title="扩张概览" icon="chart-simple" href="/cn/api-reference/endpoint/expansions/dashboard">
    市场级聚合数据:各阶段计数、热门跨境流向、关注公司的动态。无分页 — 一份仪表板快照。
  </Card>

  <Card title="公司扩张详情" icon="building-magnifying-glass" href="/cn/api-reference/endpoint/expansions/company_lookup">
    某家公司在某个市场的情况:当前阶段、评分、存在情况、流转历史,以及支撑这些结论的信号。单市场快照。
  </Card>

  <Card title="公司信号事件" icon="timeline" href="/cn/api-reference/endpoint/expansions/company_pulse_events">
    跨信号类型、按日期窗口划分的某公司信号事件的富化、分页信号流。活动深入分析。
  </Card>

  <Card title="对比公司扩张" icon="scale-balanced" href="/cn/api-reference/endpoint/expansions/company_compare">
    一次调用即可并排呈现多家公司,附带每周信号序列和可选的同类公司种子填充。专为对比网格而设计。
  </Card>

  <Card title="批量获取公司扩张摘要" icon="table" href="/cn/api-reference/endpoint/expansions/company_summaries">
    支持 domain\_search\_id、域名或 LinkedIn URL 的任意组合,解析后返回与「对比」相同的数据,并附加已计算好的摘要块——不涉及目标公司,也不做同类公司种子填充。
  </Card>

  <Card title="扩张排名" icon="map-location-dot" href="/cn/api-reference/endpoint/expansions/company_markers">
    一份轻量、按评分排名的公司/市场配对列表 — 字段极简、无分页 — 用于快速渲染地图和热力图。
  </Card>
</CardGroup>

## "详情" vs "信号事件" — 该用哪个?

这是最常见的困惑点,因为**两者都涉及信号**。区别在于*快照 vs 信号流*:

|          | 公司扩张详情                                                      | 公司信号事件                                                         |
| -------- | ----------------------------------------------------------- | -------------------------------------------------------------- |
| **范围**   | 一家公司 × **一个市场**                                             | 一家公司,跨**其所有海外市场**                                              |
| **市场**   | 通过 `country_code` 指定**单个市场**,或通过 `is_all_markets` 一次性覆盖整家公司 | 默认返回**所有海外市场**(排除本土市场);可用 `country_codes`(数组)缩小到特定市场           |
| **返回**   | 阶段、评分、存在情况、历史 **+ 支撑信号**                                    | **富化的信号事件**(证据 URL、招聘名单、标签)                                    |
| **时间**   | 当前状态                                                        | 你自行选定的**日期窗口**(`window_days` — 默认 90 — 或 `transitioned_dates`) |
| **形态**   | 结构化的快照对象                                                    | 分页的事件信号流("加载更多")                                               |
| **何时使用** | "这家公司在**某一个**市场的状态如何,原因是什么?"                                | "展示驱动这家公司扩张的**每个**市场的完整动态流"                                    |

<Tip>
  **大多数集成只需要公司扩张详情** — 它已经返回了某公司在某市场所处阶段背后的信号。当你明确需要丰富、可筛选、按时间窗口划分的事件流时(例如构建活动时间线 UI),再使用**公司信号事件**。
</Tip>

## "对比" vs "摘要" — 该用哪个?

两者都会并排返回相同的单公司扩张数据。区别在于*标识符与使用场景*:

|              | 对比公司扩张                       | 批量获取公司扩张摘要                                         |
| ------------ | ---------------------------- | -------------------------------------------------- |
| **输入**       | 仅支持 `domain_search_id`       | `domain_search_id`、`domain`、`linkedin_url` 任意组合    |
| **同类公司种子填充** | 可选,通过 `seed_target`          | 无 — 每家公司相互独立                                       |
| **已计算的汇总**   | 无(需自行计算市场数/动量/评分)            | 每家公司均附带 `summary` 汇总块(活跃/新增市场数、动量、扩张评分、阶段分布)       |
| **何时使用**     | 你已有解析好的 ID,并想为某个目标公司种子填充同类公司 | 你拿到的是按域名或 LinkedIn URL 给出的公司,并希望一次调用即可获得可直接渲染的对比指标 |

<Tip>
  **要围绕某个目标公司构建竞对对比网格?** 使用**对比**接口并传入 `seed_target`,自动挑选同类公司。**已经有一组公司**(关注列表、CRM 导入、域名列表)**只想要数据?** 使用**批量获取公司扩张摘要**——无需在客户端重新实现动量/评分的计算逻辑。
</Tip>

## 典型工作流

<Steps>
  <Step title="发现" icon="magnifying-glass">
    用你的筛选器(或自然语言 `query`)调用**扩张搜索**,获取正在进入目标市场的公司。设置 `is_explain_match: true` 以获取 AI 生成的"为何匹配"摘要。
  </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`)**以及**完整的公司画像维度(行业、技术、员工规模、收入、已保存列表)。在 [筛选器概览](/cn/developer-guides/filters/overview) 中一次性学会这些筛选器;有效值参见 [扩张参考](/cn/api-reference/endpoint/expansions/types) 以及 [扩张信号的工作原理](/cn/knowledge-base/concepts/how-expansion-signals-work) 目录。

<CardGroup cols={2}>
  <Card title="使用扩张 API" icon="code" href="/cn/knowledge-base/concepts/expansion-api-quickstart">
    认证、你的首批调用、分页,以及如何读取评分。
  </Card>

  <Card title="实战示例" icon="route" href="/cn/knowledge-base/concepts/expansion-signals-example">
    一个从市场到信号的完整演练。
  </Card>
</CardGroup>