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
示例:
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

domain_search_id_list
string[]

要包含的公司标识符(domain_search_id UUID)。

示例:
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[]

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

示例:
is_include_established
boolean

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

示例:

false

select_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
any