Skip to main content
POST
公司扩张详情

授权

pubrio-api-key
string
header
必填

一个唯一的 API 令牌,用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 设置 部分创建该令牌。

请求体

application/json
domain_search_id
string<uuid>
必填

用于公司检索操作的唯一标识符。

country_code
string

目标市场,采用 ISO 3166-1 alpha-2(cca2)国家代码。省略时将自动选择该公司最活跃的单个市场;如需所有市场的跨市场视图,请设置 is_all_markets

示例:

"US"

is_all_markets
boolean

在一次调用中返回公司在所有市场的整体扩张情况,而非单一市场。设为 true 时,将忽略 country_code,在能够识别本土市场时将其从信号汇总中排除,data 变为公司级别的汇总(主导阶段、信号总数、时间跨度、最高扩张分数),并且 markets_summary 列出每个市场。默认为 false。

示例:

false

signal_type
enum<string>

将返回的信号筛选至单一类型。

可用选项:
AD,
NEWS,
DNS,
INFRA,
PARTNER,
EVENT_PLUS,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
示例:

"EXEC"

query
string

用纯文本描述你所销售的产品,或你正在评估这家公司是否契合的目标买家画像。仅用于为 AI summary 提供依据(见 is_explain_match);与公司搜索不同,此处不会将其解析为筛选条件。

示例:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

为 true 且提供了 query 时,summary 返回针对当前范围(所选市场,或当 is_all_markets 为 true 时的所有海外市场)内该公司扩张活动的单条 AI 摘要,依据你的 query 解读,并基于公司的真实信号给出 [n] 引用。

示例:

true

window_days
integer
默认值:90

可选。限定 AI summary 所依据信号流的滚动时间窗口(天)。当本参数与 transitioned_dates 均未提供时默认为 90。不影响分页的 signals 列表(完整历史)。

示例:

90

transitioned_dates
string<date>[]

信号/转换窗口的 ISO [from, to] 日期范围。如果同时提供了 window_days,则此参数优先。

示例:
domain
string

用于公司检索操作的公司域名。如果收到的地址为 www.pubrio.comhttps://docs.pubrio.com/,系统会自动转换为 pubrio.com 进行处理。

示例:

"pubrio.com"

linkedin_url
string

LinkedIn 公司主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/company/

示例:

"https://www.linkedin.com/company/pubrio"

is_include_established
boolean

包含 established 阶段(无活跃扩张信号的长期运营者)。默认为 false。

示例:

false

page
integer
默认值:1

页码,从 1 开始。上限为订阅中的 max_search_page(公司搜索为 max_company_search_page),可通过 Profile 获取。超出会返回 HTTP 416

示例:

1

per_page
integer
默认值:25

每页记录数。默认 25,在大多数套餐下这也是上限 —— 该限制即订阅中的 max_search_per_page,可通过 Profile 获取。超出会返回 HTTP 416 及错误码 41676(公司与人物搜索为 41613),而不是自动截断结果。

必填范围: x <= 25
示例:

25

is_include_metadata
boolean

返回完整的详细信息负载。API 密钥请求默认返回精简结果:除非此项为 true,否则将省略 model 区块、置信度数值(公司扩张详情中的 stage.confidence,以及 other_markets[] 和排名 markers[] 中的 confidence_score),以及 established_min / share_of_detected / has_known_office 字段。

示例:

true

summary_only
boolean

仅返回阶段摘要区块(datacompanymarkets_summarysignal_weekly_totalsrecent_signalsexpansion_scoresummary),跳过信号列表及其聚合。适用于头部概览视图,开销更低。

示例:

true

markets_summary_full
boolean

在受限的 other_markets 列表之外,额外返回完整的市场排名集合 markets_summary

示例:

true

响应

200 - application/json

公司在某市场的详情。

metadata
object
data
any
signals
object[]

该公司/市场组合背后的分页信号行,即证据列表。分页大小与总数见 metadata.pagination

summary
object

该组合的单行阶段摘要。仅在第一页返回。

company
object

公司基础信息——名称、域名、Logo 及社交链接。仅在第一页返回。

signal_group_totals
object[]

按类型统计的信号数量,按你所在时区的日期分桶。仅在第一页返回。

signal_type_totals
object[]

各信号类型的历史累计数量。仅在第一页返回。

signal_type_recent_totals
object[]

最近 12 周内各信号类型的数量。仅在第一页返回。

signal_weekly_totals
object[]

用于热力图的每周信号数量,时间窗口与 signal_type_recent_totals 一致。仅在第一页返回。

evidence_breakdown
object

按来源类型汇总的证据统计,基于返回的(已脱敏)信号计算。仅在第一页返回。

presence
object

该公司在此市场中观察到的实体与数字化存在。仅在第一页返回。

suppressions
object[]

在阶段计算中被抑制的信号及其原因。仅在第一页返回。

timeline
object[]

该公司/市场组合的阶段转换历史。仅在第一页返回。

other_markets
object[]

该公司的其他活跃市场。受套餐限制时会截断,详见 other_markets_locked_count。仅在第一页返回。

other_markets_locked_count
integer

由于套餐限制而未在 other_markets 中返回的市场数量。未被截断时为 0

markets_summary
object[]

该公司完整的市场排名集合。仅当 markets_summary_fulltrue 且在第一页时返回。