Skip to main content
POST
搜索公司云足迹

授权

​
pubrio-api-key
string
header
必填

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

请求体

application/json
​
providers
string[]

仅返回匹配这些云或托管服务商的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
​
exclude_providers
string[]

排除匹配这些云或托管服务商的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
​
target_locations
string[]

结果必须面向的国家代码。默认与 filter_conditions 以 OR 组合 — 命中其中任一即匹配。

示例:
​
exclude_target_locations
string[]

结果不得面向的国家代码。默认与 filter_conditions 以 OR 组合 — 命中其中任一即匹配。

示例:
​
cloud_regions
string[]

仅返回匹配这些云区域的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
​
exclude_cloud_regions
string[]

排除匹配这些云区域的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
​
cities
string[]

仅返回匹配这些城市的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
​
exclude_cities
string[]

排除匹配这些城市的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
​
first_seen_dates
(string | null)[]

两个 ISO 8601 日期（YYYY-MM-DD），限定足迹首次发现的时间范围。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
​
last_seen_dates
(string | null)[]

两个 ISO 8601 日期（YYYY-MM-DD），限定足迹最近发现的时间范围。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
​
is_cross_border_only
boolean

为 true 时仅返回公司本土市场以外的足迹记录。总部未知的公司记录会被排除。

示例:

true

​
host_count
(integer | null)[]

主机数的最小值与最大值。使用 null 表示不设该端边界。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
​
server_count
(integer | null)[]

服务器数（不同 IP）的最小值与最大值。使用 null 表示不设该端边界。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
​
shared_server_count
(integer | null)[]

与其他公司共用的服务器数的最小值与最大值。使用 null 表示不设该端边界。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
​
region_count
(integer | null)[]

云区域数的最小值与最大值。使用 null 表示不设该端边界。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
​
city_count
(integer | null)[]

城市数的最小值与最大值。使用 null 表示不设该端边界。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
​
cloud_footprint_host_count
(integer | null)[]

主机数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
cloud_footprint_server_count
(integer | null)[]

服务器数（不同 IP）的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
cloud_footprint_shared_server_count
(integer | null)[]

与其他公司共用的服务器数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
cloud_footprint_provider_count
(integer | null)[]

公司使用的不同服务商数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
cloud_footprint_country_count
(integer | null)[]

公司托管所在的国家数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
cloud_footprint_cross_border_country_count
(integer | null)[]

本土市场以外的国家数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
cloud_footprint_region_count
(integer | null)[]

云区域数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
cloud_footprint_city_count
(integer | null)[]

城市数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计，涵盖所有服务商与国家。

Required array length: 2 elements
示例:
​
company_locations
string[]

公司总部所在地。更多信息请参见筛选器标签下的 location 端点。

示例:
​
cloud_footprint_id
string<uuid>

单条云足迹记录的标识符。

示例:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

​
cloud_footprint_ids
string<uuid>[]

指定云足迹记录的标识符，用于导出所选内容。

示例:
​
companies
string<uuid>[]

用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。

​
domains
string[]

用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/，系统会自动转换为 pubrio.com 进行处理。

示例:
​
per_page
integer
默认值:25

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

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

25

​
page
integer
默认值:1

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

示例:

1

​
is_ascending_order
boolean
默认值:false

排序方向。默认按最新在前返回；设为 true 则最旧在前。此端点没有 sort_by——排序键是固定的，见端点说明。

示例:

false

​
cloud_footprint_providers
string[]

筛选在任意位置使用这些服务商的公司。不带前缀的 providers 缩小返回的记录；此项缩小公司范围。

示例:
​
cloud_footprint_target_locations
string[]

在其足迹中任意位置出现在这些国家的公司。

示例:
​
cloud_footprint_primary_provider
string[]

主要（占比最大）服务商为其中之一的公司。

示例:
​
domain
string

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

示例:

"pubrio.com"

​
domain_search_id
string<uuid>

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

​
linkedin_urls
string[]

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

示例:
​
filter_conditions
object[]

将数组筛选从 OR（默认：匹配任一值）切换为 AND（匹配全部值）。适用于 cloud_regions、exclude_cloud_regions、cities 与 exclude_cities。

响应

分页的云足迹记录。

The response is of type object.

最后修改于 2026年9月4日