Skip to main content
POST
Search for company cloud footprints

Authorizations

​
pubrio-api-key
string
header
required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json
​
providers
string[]

Restrict results to footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country.

Example:
​
exclude_providers
string[]

Remove footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country.

Example:
​
target_locations
string[]

Country codes the results must target. Combines with filter_conditions as OR by default — a result matches if it targets any of them.

Example:
​
exclude_target_locations
string[]

Country codes the results must not target. Combines with filter_conditions as OR by default — a result matches if it targets any of them.

Example:
​
cloud_regions
string[]

Restrict results to footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country.

Example:
​
exclude_cloud_regions
string[]

Remove footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country.

Example:
​
cities
string[]

Restrict results to footprint rows matching these cities. Scoped to this footprint row — one provider in one country.

Example:
​
exclude_cities
string[]

Remove footprint rows matching these cities. Scoped to this footprint row — one provider in one country.

Example:
​
first_seen_dates
(string | null)[]

Two ISO 8601 dates (YYYY-MM-DD) bounding when the footprint was first seen. Scoped to this footprint row — one provider in one country.

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

Two ISO 8601 dates (YYYY-MM-DD) bounding when the footprint was last seen. Scoped to this footprint row — one provider in one country.

Required array length: 2 elements
Example:
​
is_cross_border_only
boolean

When true, return only footprint rows outside the company's home market. Rows whose company has no known headquarters are excluded.

Example:

true

​
host_count
(integer | null)[]

Minimum and maximum hosts. Use null for an open-ended bound. Scoped to this footprint row — one provider in one country.

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

Minimum and maximum servers (distinct IP addresses). Use null for an open-ended bound. Scoped to this footprint row — one provider in one country.

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

Minimum and maximum servers shared with other companies. Use null for an open-ended bound. Scoped to this footprint row — one provider in one country.

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

Minimum and maximum cloud regions. Use null for an open-ended bound. Scoped to this footprint row — one provider in one country.

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

Minimum and maximum cities. Use null for an open-ended bound. Scoped to this footprint row — one provider in one country.

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

Minimum and maximum hosts. Use null for an open-ended bound. Counted for the whole company, across every provider and country.

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

Minimum and maximum servers (distinct IP addresses). Use null for an open-ended bound. Counted for the whole company, across every provider and country.

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

Minimum and maximum servers shared with other companies. Use null for an open-ended bound. Counted for the whole company, across every provider and country.

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

Minimum and maximum distinct providers used by the company. Use null for an open-ended bound. Counted for the whole company, across every provider and country.

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

Minimum and maximum countries the company hosts in. Use null for an open-ended bound. Counted for the whole company, across every provider and country.

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

Minimum and maximum countries outside the company's home market. Use null for an open-ended bound. Counted for the whole company, across every provider and country.

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

Minimum and maximum cloud regions. Use null for an open-ended bound. Counted for the whole company, across every provider and country.

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

Minimum and maximum cities. Use null for an open-ended bound. Counted for the whole company, across every provider and country.

Required array length: 2 elements
Example:
​
company_locations
string[]

The location of the company headquarters. Check out location endpoints under the Filters tab for more information.

Example:
​
cloud_footprint_id
string<uuid>

Identifier of a single cloud footprint row.

Example:

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

​
cloud_footprint_ids
string<uuid>[]

Identifiers of specific cloud footprint rows, for exporting a selection.

Example:
​
companies
string<uuid>[]

A list of unique identifiers (domain_search_id) used for company and people search operations.

​
domains
string[]

List of company domains used for company and people search operations. If we receive a URL such as www.pubrio.com or https://docs.pubrio.com/, the system will convert it to pubrio.com for processing.

Example:
​
per_page
integer
default:25

Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's max_search_per_page, returned by Profile. Exceeding it returns HTTP 416 with code 41676 (or 41613 on company and people search), not a clamped result set.

Required range: x <= 25
Example:

25

​
page
integer
default:1

Page number, starting at 1. The ceiling is your subscription's max_search_page (max_company_search_page for company search), returned by Profile. Exceeding it returns HTTP 416.

Example:

1

​
is_ascending_order
boolean
default:false

Sort direction. Results are returned newest-first by default; set true for oldest-first. There is no sort_by on this endpoint — the sort key is fixed and stated in the endpoint description.

Example:

false

​
cloud_footprint_providers
string[]

Companies that use any of these providers anywhere. The unprefixed providers narrows the rows returned; this narrows the companies.

Example:
​
cloud_footprint_target_locations
string[]

Companies present in any of these countries anywhere in their footprint.

Example:
​
cloud_footprint_primary_provider
string[]

Companies whose single largest provider is one of these.

Example:
​
domain
string

A company domain used for company search operations. If we receive a URL such as www.pubrio.com or https://docs.pubrio.com/, the system will convert it to pubrio.com for processing.

Example:

"pubrio.com"

​
domain_search_id
string<uuid>

A unique identifier for the company search operation.

​
linkedin_urls
string[]

The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/

Example:
​
filter_conditions
object[]

Switches an array filter from OR (default: match any value) to AND (match all values). Applies to cloud_regions, exclude_cloud_regions, cities and exclude_cities.

Response

Paginated cloud footprint rows.

The response is of type object.

Last modified on September 4, 2026