Skip to main content
POST
扩张概览

授权

pubrio-api-key
string
header
必填

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

请求体

application/json
froms
string[]

来源市场(ISO 3166-1 alpha-2)。公司从哪些市场向外扩张 —— 即其总部 / 母国。单独使用可查找从这些市场向外扩张的公司;与 tos 组合可指定具体的 来源→目标 走廊。

示例:
tos
string[]

目标市场(ISO 3166-1 alpha-2)。公司正在向哪些市场扩张。单独使用可查找进入这些市场的所有公司;与 froms 组合可指定具体的 来源→目标 走廊。

示例:
exclude_froms
string[]

要排除的来源市场(ISO 3166-1 alpha-2)。

示例:
exclude_tos
string[]

要排除的目标市场(ISO 3166-1 alpha-2)。

示例:
stages
enum<string>[]

取值区分大小写,且不会被校验。无法识别的取值会被静默丢弃而非报错:在 stagesfreshnessscopesmomentum 上,整个筛选条件会被丢弃,你将得到未经筛选的结果;而在 signal_typessignal_strengths 上,筛选条件会被应用但不匹配任何内容。两种情况下响应看起来都很正常。请通过 Expansion Reference 获取有效的标识值;若结果集看起来异常,请将 data.pagination.total_entries 与未加筛选的调用进行对比。

可用选项:
exploring,
committing,
expanding,
scaling,
established
示例:
momentum
enum<string>[]

公司在该市场中的走势。advancing 表示正在推进,steady 表示保持稳定,pulling_back 涵盖收缩与撤退。

不要在此处使用 Expansion Referencedirections 的取值。那些取值(advancingsteadyretreatingnew)是你在 stage.direction 中收到的响应值;作为筛选条件仅接受上面列出的三个。传入 retreatingnew 会静默禁用该筛选条件并返回未经筛选的结果。

可用选项:
accelerating,
advancing,
steady,
pulling_back
示例:
freshness
enum<string>[]

取值区分大小写,且不会被校验。无法识别的取值会被静默丢弃而非报错:在 stagesfreshnessscopesmomentum 上,整个筛选条件会被丢弃,你将得到未经筛选的结果;而在 signal_typessignal_strengths 上,筛选条件会被应用但不匹配任何内容。两种情况下响应看起来都很正常。请通过 Expansion Reference 获取有效的标识值;若结果集看起来异常,请将 data.pagination.total_entries 与未加筛选的调用进行对比。

可用选项:
fresh,
cooling,
stale,
cold
示例:
scopes
enum<string>[]

按市场进入范围筛选。

可用选项:
entering_new_market,
expanding_within_presence,
established_only
示例:
ahead_of_pace
boolean

仅限扩张速度快于该市场典型速度的公司/市场组合。

示例:

false

signal_types
enum<string>[]

取值区分大小写,且不会被校验。无法识别的取值会被静默丢弃而非报错:在 stagesfreshnessscopesmomentum 上,整个筛选条件会被丢弃,你将得到未经筛选的结果;而在 signal_typessignal_strengths 上,筛选条件会被应用但不匹配任何内容。两种情况下响应看起来都很正常。请通过 Expansion Reference 获取有效的标识值;若结果集看起来异常,请将 data.pagination.total_entries 与未加筛选的调用进行对比。

可用选项:
AD,
NEWS,
DNS,
INFRA,
PARTNER,
EVENT_PLUS,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
示例:
signal_strengths
enum<string>[]

取值区分大小写,且不会被校验。无法识别的取值会被静默丢弃而非报错:在 stagesfreshnessscopesmomentum 上,整个筛选条件会被丢弃,你将得到未经筛选的结果;而在 signal_typessignal_strengths 上,筛选条件会被应用但不匹配任何内容。两种情况下响应看起来都很正常。请通过 Expansion Reference 获取有效的标识值;若结果集看起来异常,请将 data.pagination.total_entries 与未加筛选的调用进行对比。

可用选项:
low,
medium,
high
示例:
min_signal_count
integer

公司在该时间窗口内所需的最少扩张信号数量——用于筛选“非常活跃 / 足迹密集”的公司。

示例:

3

only_contraction
boolean

为 true 时,仅返回标记为收缩的扩张记录(正在收缩规模的公司)。

示例:

false

verticals
integer[]

vertical_id 列表,用于搜索特定垂直行业或领域的公司。要获取ID,请调用筛选器标签下的 vertical 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["AI"]

vertical_categories
integer[]

vertical_category_id 列表,用于搜索特定垂直行业类别的公司。要获取ID,请调用筛选器标签下的 vertical category 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["Information Technology"]

vertical_sub_categories
integer[]

vertical_sub_category_id 列表,用于搜索特定垂直行业子类别的公司。要获取ID,请调用筛选器标签下的 vertical sub category 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["Software"]

technologies
integer[]

tag_id 列表,用于搜索公司所用的特定技术。要获取ID,请调用筛选器标签下的 technology 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["Shopify"]

employees
string[][]

公司员工人数范围。可根据员工总数筛选公司,并可添加多个范围以扩展搜索结果。

更多信息请参见筛选器标签下的 company size 端点。

示例:
revenues
integer[]

公司收入的最小值和最大值范围。

示例:
founded_dates
integer[]

公司成立年份范围。最大值为当前年份。

示例:
keywords
string[]

用于按相关性、专业或描述对公司进行关键词筛选的列表。

示例:
companies
string[]

通过 domain_search_id、公司域名或公司社交媒体主页链接的任意组合来指定公司。域名和链接会解析为排名最高的公司。

示例:
job_locations
string[]

ISO 3166-1 alpha-2(cca2)用于筛选地区。更多信息请参见筛选器标签下的 location 端点。

示例:
job_exclude_locations
string[]

从职位发布结果中排除的地理位置。

示例:
job_posted_dates
string[]

发布日期的时间范围。最大值为当天。

示例:
job_titles
string[]

与目标人员相关的职位名称。

结果还将包含包含类似术语的职位,即使不完全匹配。例如,搜索 software engineer 也可能返回职位为 senior software engineer 的人员。

示例:
advertisement_target_locations
string[]

广告的目标地理位置。

示例:
advertisement_exclude_target_locations
string[]

从广告定位中排除的地理位置。

示例:
advertisement_search_terms
string[]

用于在广告内容或标题中搜索的关键词。

示例:
advertisement_start_dates
string<date>[]

用于广告筛选的起始日期范围。

示例:
advertisement_end_dates
string<date>[]

用于广告筛选的结束日期范围。

示例:
news_categories
string[]

category slugs 列表,用于搜索特定新闻类别。要获取 slug,请调用筛选器标签下的 news categories 端点。

示例:
news_published_dates
string[]

发布时间的时间范围。最大值为当天。

示例:
transitioned_dates
string<date>[]

显示窗口(地图、流向和关注列表时间线)的 ISO 日期范围 [start, end]。默认为最近 90 天。new_transitions_30d 这一 KPI 始终使用其固定的 30 天窗口,不受此范围影响。

示例:
window_days
integer

可选。滚动时间窗口的天数。在未提供明确的 transitioned_dates 范围时使用;若两者均未提供,则使用默认时间窗口。

示例:

90

min_markets
integer

公司在该时间窗口内必须进入的新市场最少数量(用于筛选广泛扩张者)。

示例:

3

home_country_code
string[]

按公司总部所在国家筛选(ISO 3166-1 alpha-2)。与 froms 同时提供时取交集。

示例:
industries
string[]

按行业名称筛选(自由文本匹配)。

示例:
exclude_industries
string[]

要排除的行业(自由文本匹配)。

示例:
select_size
integer

最多返回的市场数量(受套餐上限约束)。

示例:

250

flows_size
integer

最多返回的跨境流向数量(受套餐上限约束)。

示例:

50

is_include_metadata
boolean

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

示例:

true

响应

200 - application/json

市场仪表板聚合数据。

metadata
object
data
object

仪表板数据容器:经排名的市场,以及热门跨境走廊流向。 已弃用的遗留镜像。为兼容旧客户端,data 内的每个容器同时也会在顶层输出(countriestop_flowspicks_aggregatewatchlist_marketswatchlist_timeline)。请从 data 中读取 —— 顶层副本将被移除。