本快速入门通过几次调用，让您从零开始读取实时扩张信号。它假设您已拥有 Pubrio API 密钥——参见身份验证以创建一个。
前提条件
所有扩张端点均为POST 并接受 JSON 请求体。请按身份验证中的说明，在每个请求中包含您的凭据。
第 1 步 — 查询一家公司的扩张
从单家公司入手，列出它正在进入的每一个市场。第 2 步 — 读取结果
markets_summary 中的每一项都描述该公司活跃的一个市场：
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 步 — 探索整个市场
若要以市场为先（而非以公司为先）开展工作，请使用扩张市场详情。它通过标准的page / per_page 参数进行分页。
地理是一种有向的 from → to 关系，用两个列表表达：froms（来源 / 总部市场）与 tos（目标市场）。选择与你的问题相匹配的模式：
metadata.pagination 以翻页浏览结果：
page 请求下一页。per_page 受您的套餐限制——显式请求超出上限的数量会返回错误，而不是静默截断。
两个值得了解的默认行为：
- 排序 — 结果默认按相关性排序（获得多种信号类型相互印证的公司在前，然后按时间由近到远）。传入
sort_by: "recent"可纯按时间排序，也可使用expansion_score/signal_count/company_ranking。 - 精简响应 — API 密钥响应默认省略市场汇总（
metadata.aggregate、top origins/destinations、timeline）和模型细节。需要时传入is_include_metadata: true。
第 4 步 — 深入证据
当您想要一家公司举措背后的单条信号时，调用公司信号事件。total_entries 和 total_pages——请求第 1 页至 total_pages 页（即在 page < total_pages 时继续请求）。
筛选参考
大多数扩张端点接受以下筛选条件。其有效值列在扩张信号的工作原理中：companies 筛选接受任意组合的标识符类型——无需先解析为 ID：
后续步骤
实例演练
从市场到信号的完整演练。
扩张端点
浏览每一个扩张 API 端点。