Search for Company Cloud Footprints is a paid API for AI agents from agents.pubrio.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-11).
Search and filter the public cloud and hosting infrastructure footprint of companies, returning which providers, countries, and regions they operate in.
Search the public cloud and hosting footprint of companies: which providers, countries and regions they run infrastructure in. Each row is one company at one provider in one country. See the [Cloud Footprint Search guide](/en/developer-guides/search/cloud-footprint-search).
Returns paginated rows where each row represents one company at one cloud or hosting provider in one country, including provider name, country, region, cities, and company identifiers. The response also includes total count and pagination metadata.
POSThttps://agents.pubrio.com/companies/cloud_footprints/search?utm_source=zero.xyzUse this endpoint when you need to search across many companies' cloud footprints with filters like provider, country, city, or a plain-language query. Prefer this over the single-company cloud footprint insights endpoint when you want to discover multiple companies based on their infrastructure presence rather than analyze one known company in depth.
| Field | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**. |
| query | string | |
| cities | array | Restrict results to footprint rows matching these cities. Scoped to this footprint row — one provider in one country. |
| 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. |
| domains | array | 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. |
| per_page | integer | 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](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set. |
| companies | array | A list of unique identifiers (domain_search_id) used for company and people search operations. |
| providers | array | Restrict results to footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country. |
| city_count | array | Minimum and maximum cities. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country. |
| host_count | array | Minimum and maximum hosts. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country. |
| region_count | array | Minimum and maximum cloud regions. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country. |
| server_count | array | Minimum and maximum servers (distinct IP addresses). Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country. |
| cloud_regions | array | Restrict results to footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country. |
| linkedin_urls | array | The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/` |
| exclude_cities | array | Remove footprint rows matching these cities. Scoped to this footprint row — one provider in one country. |
| last_seen_dates | array | Two ISO 8601 dates (YYYY-MM-DD) bounding when the footprint was last seen. Scoped to this footprint row — one provider in one country. |
| domain_search_id | string | A unique identifier for the company search operation. |
| first_seen_dates | array | Two ISO 8601 dates (YYYY-MM-DD) bounding when the footprint was first seen. Scoped to this footprint row — one provider in one country. |
| target_locations | array | Country codes the results must target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them. |
| company_locations | array | The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information. |
| exclude_providers | array | Remove footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country. |
| filter_conditions | array | Switches an array filter from OR (default: match any value) to AND (match all values). Applies to `cloud_regions` and `cities`. |
| cloud_footprint_id | string | Identifier of a single cloud footprint row. |
| is_ascending_order | boolean | 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. |
| cloud_footprint_ids | array | Identifiers of specific cloud footprint rows, for exporting a selection. |
| shared_server_count | array | 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. |
| 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. |
| exclude_cloud_regions | array | Remove footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country. |
| exclude_target_locations | array | Country codes the results must not target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them. |
| cloud_footprint_providers | array | Companies that use any of these providers anywhere. The unprefixed `providers` narrows the rows returned; this narrows the companies. |
| cloud_footprint_city_count | array | Minimum and maximum cities. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country. |
| cloud_footprint_host_count | array | Minimum and maximum hosts. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country. |
| cloud_footprint_region_count | array | Minimum and maximum cloud regions. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country. |
| cloud_footprint_server_count | array | Minimum and maximum servers (distinct IP addresses). Use `null` for an open-ended bound. Counted for the whole company, across every provider and country. |
| cloud_footprint_country_count | array | 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. |
| cloud_footprint_provider_count | array | 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. |
| cloud_footprint_primary_provider | array | Companies whose single largest provider is one of these. |
| cloud_footprint_target_locations | array | Companies present in any of these countries anywhere in their footprint. |
| cloud_footprint_shared_server_count | array | 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. |
| cloud_footprint_cross_border_country_count | array | 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. |
{
"type": "object"
}No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"