# Search for Company Cloud Footprints

> 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.

## Facts

- Endpoint: POST https://agents.pubrio.com/companies/cloud_footprints/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: agents.pubrio.com
- Website: https://agents.pubrio.com
- Canonical page: https://www.zero.xyz/c/agents-pubrio-com-search-for-company-cloud-footprints-62b377ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_we9_UXCJSPwrF-oJJpRfy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-pubrio-com-search-for-company-cloud-footprints-62b377ff -d '<json body>'
```

Example prompt: Search Pubrio's cloud footprint data for companies using AWS or Cloudflare in Germany — filter by providers AWS and Cloudflare and country Germany, show me the first 25 results.

## When to prefer this

Use 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.

## Known failure modes

- HTTP 416 if page exceeds subscription max_search_page limit
- HTTP 416 with code 41613 if per_page exceeds subscription max_search_per_page
- Invalid domain format resolved automatically to apex domain
- Empty results if no companies match the specified provider or country filters
- Authentication failure if API credentials are missing or invalid

## How this service works

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).

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "example": 1,
   "description": "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": {
   "type": "string"
  },
  "cities": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "Ashburn",
    "Frankfurt"
   ],
   "description": "Restrict results to footprint rows matching these cities. Scoped to this footprint row — one provider in one country."
  },
  "domain": {
   "type": "string",
   "example": "pubrio.com",
   "description": "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": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "pubrio.com"
   ],
   "description": "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": {
   "type": "integer",
   "default": 25,
   "example": 25,
   "maximum": 25,
   "description": "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": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uuid"
   },
   "description": "A list of unique identifiers (domain_search_id) used for company and people search operations."
  },
  "providers": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "AWS",
    "Cloudflare",
    "Hetzner"
   ],
   "description": "Restrict results to footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country."
  },
  "city_count": {
   "type": "array",
   "items": {
    "type": "integer",
    "nullable": true
   },
   "example": [
    1,
    null
   ],
   "maxItems": 2,
   "minItems": 2,
   "description": "Minimum and maximum cities. Use `null` for an ope
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-pubrio-com-search-for-company-cloud-footprints-62b377ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.pubrio.com](https://www.zero.xyz/host/agents.pubrio.com/llms.txt)