对相关概念(阶段、信号、势头、新鲜度)还不熟悉?请先阅读 什么是扩张信号? — 本指南假定你已了解这些概念,并专注于端点的选择。
按任务选择
端点一览
扩张搜索
发现端点。按扩张阶段、新鲜度、市场以及完整的公司画像维度筛选公司 — 或传入自然语言
query。返回分页的公司列表。扩张概览
市场级聚合数据:各阶段计数、热门跨境流向、关注公司的动态。无分页 — 一份仪表板快照。
公司扩张详情
某家公司在某个市场的情况:当前阶段、评分、存在情况、流转历史,以及支撑这些结论的信号。单市场快照。
公司信号事件
跨信号类型、按日期窗口划分的某公司信号事件的富化、分页信号流。活动深入分析。
对比公司扩张
一次调用即可并排呈现多家公司,附带每周信号序列和可选的同类公司种子填充。专为对比网格而设计。
批量获取公司扩张摘要
支持 domain_search_id、域名或 LinkedIn URL 的任意组合,解析后返回与「对比」相同的数据,并附加已计算好的摘要块——不涉及目标公司,也不做同类公司种子填充。
扩张排名
一份轻量、按评分排名的公司/市场配对列表 — 字段极简、无分页 — 用于快速渲染地图和热力图。
“详情” vs “信号事件” — 该用哪个?
这是最常见的困惑点,因为两者都涉及信号。区别在于快照 vs 信号流:| 公司扩张详情 | 公司信号事件 | |
|---|---|---|
| 范围 | 一家公司 × 一个市场 | 一家公司,跨其所有海外市场 |
| 市场 | 通过 country_code 指定单个市场,或通过 is_all_markets 一次性覆盖整家公司 | 默认返回所有海外市场(排除本土市场);可用 country_codes(数组)缩小到特定市场 |
| 返回 | 阶段、评分、存在情况、历史 + 支撑信号 | 富化的信号事件(证据 URL、招聘名单、标签) |
| 时间 | 当前状态 | 你自行选定的日期窗口(window_days — 默认 90 — 或 transitioned_dates) |
| 形态 | 结构化的快照对象 | 分页的事件信号流(“加载更多”) |
| 何时使用 | ”这家公司在某一个市场的状态如何,原因是什么?" | "展示驱动这家公司扩张的每个市场的完整动态流” |
“对比” vs “摘要” — 该用哪个?
两者都会并排返回相同的单公司扩张数据。区别在于标识符与使用场景:| 对比公司扩张 | 批量获取公司扩张摘要 | |
|---|---|---|
| 输入 | 仅支持 domain_search_id | domain_search_id、domain、linkedin_url 任意组合 |
| 同类公司种子填充 | 可选,通过 seed_target | 无 — 每家公司相互独立 |
| 已计算的汇总 | 无(需自行计算市场数/动量/评分) | 每家公司均附带 summary 汇总块(活跃/新增市场数、动量、扩张评分、阶段分布) |
| 何时使用 | 你已有解析好的 ID,并想为某个目标公司种子填充同类公司 | 你拿到的是按域名或 LinkedIn URL 给出的公司,并希望一次调用即可获得可直接渲染的对比指标 |
典型工作流
共享筛选器
发现类端点(扩张搜索、扩张概览、扩张排名)接受相同的筛选器词汇 — 扩张筛选器(阶段、走势、新鲜度、范围、信号类型)、有向地理对(froms / tos)以及完整的公司画像维度(行业、技术、员工规模、收入、已保存列表)。在 筛选器概览 中一次性学会这些筛选器;有效值参见 扩张参考 以及 扩张信号的工作原理 目录。
使用扩张 API
认证、你的首批调用、分页,以及如何读取评分。
实战示例
一个从市场到信号的完整演练。