# Cloud Footprint Insights

> Cloud Footprint Insights is a paid API for AI agents from agents.pubrio.com, paid per call via MPP or x402, $0.03/call, status unknown (last checked 2026-10-12).

Returns a comprehensive cloud footprint summary for a single company, including totals, top providers, countries, regions, weekly new hosts, latest hosts, and actionable change flags.

## Facts

- Endpoint: POST https://agents.pubrio.com/companies/cloud_footprints/insights?utm_source=zero.xyz
- Price: $0.03/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: agents.pubrio.com
- Website: https://agents.pubrio.com
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-pubrio-com-cloud-footprint-insights-fcc7f74c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FKaoXwzTgdI79Fvy-p9DQ

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-cloud-footprint-insights-fcc7f74c -d '<json body>'
```

Example prompt: Pull the full cloud footprint insights for the company with domain search ID '3f8a2c1d-4e7b-4f1a-9c2d-1234567890ab' — I want to see their top providers, which countries they host in, any new hosts added this week, and any flags for unusual changes.

## When to prefer this

Use this endpoint when you need a complete, pre-aggregated cloud intelligence summary for a single company in one call — covering providers, geography, new hosts, and change flags — rather than paginating through raw cloud footprint search results. Prefer this over the search or individual lookup endpoints when the goal is analysis, monitoring, or briefing rather than retrieving raw records.

## Known failure modes

- Missing or invalid domain_search_id UUID returns a validation error
- Date window specified with only one of date_from/date_to causes the default window to be used instead
- Reversed or invalid date range falls back to default window; check window_days in response
- No cloud footprint data available for the company returns empty or null data fields
- Unknown company_id or domain_search_id returns a not-found error

## How this service works

Pubrio detects when companies enter new markets and returns the company and people data behind each move. Expansion signals (local hiring, new offices and entities, localized ads, news, cloud hosting) are typed, dated and tied to evidence across 200+ markets, with strong coverage of Asia-Pacific and other markets that Western-built datasets miss. The graph covers 800M+ companies and 560M+ contacts from 50+ local data sources, refreshed daily. Search companies, people, job postings, news, ads and cloud footprints with filters or a plain-language query; look up records by domain, LinkedIn URL or Pubrio id; find lookalike companies and people; read hiring, news, advertising and cloud insights for one company; and reveal verified work emails, personal emails and phone numbers. Each call costs the number of credits listed on its endpoint. This server is a pay-per-use, transparent proxy in front of Pubrio's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.

## Output

Returns a structured object with cloud footprint totals, ranked lists of top cloud providers and geographic locations, weekly newly-seen hosts, the most recently observed hosts, and flag arrays including test/staging hosts on non-primary clouds and twin hosts (duplicated infrastructure across providers or regions) — each with provider, region, country, city, and first-seen timestamp details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date_to": {
   "type": "string",
   "format": "date",
   "example": "2026-03-31",
   "description": "End of the date window (ISO 8601, YYYY-MM-DD). Ignored without date_from. If the window is invalid or reversed, the default window is used; check window_days in the response."
  },
  "date_from": {
   "type": "string",
   "format": "date",
   "example": "2026-01-01",
   "description": "Start of the date window (ISO 8601, YYYY-MM-DD). Use together with date_to to scope results to a specific range; omit both to use the default window."
  },
  "domain_search_id": {
   "type": "string",
   "format": "uuid",
   "description": "A unique identifier for the company search operation."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "flags": {
     "type": "object",
     "nullable": true,
     "properties": {
      "test_hosts": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "host": {
          "type": "string",
          "description": "Host name."
         },
         "tags": {
          "type": "array",
          "items": {
           "type": "string"
          },
          "description": "Words in the host name that mark it as non-production, such as `dev` or `staging`."
         },
         "is_poc": {
          "type": "boolean",
          "description": "`true` when the host name marks a proof of concept or pilot. These items are listed first."
         },
         "places": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "city": {
             "type": "string",
             "nullable": true,
             "description": "City; `null` when unknown."
            },
            "provider": {
             "type": "string",
             "description": "Provider name."
            },
            "region_name": {
             "type": "string",
             "nullable": true,
             "description": "Region name; `null` when unknown."
            },
            "cloud_region": {
             "type": "string",
             "nullable": true,
             "description": "Cloud region code; `null` when unknown."
            },
            "country_code": {
             "type": "string",
             "description": "ISO 3166-1 alpha-2 country code."
            }
           }
          },
          "description": "Where the host is live now."
         },
         "first_seen_at": {
          "type": "string",
          "format": "date-time",
          "description": "When the host was first seen."
         },
         "primary_provider": {
          "type": "string",
          "description": "The company's primary provider."
         }
        }
       },
       "nullable": true,
       "description": "New development, test, staging or proof-of-concept hosts on a cloud other than the company's primary one."
      },
      "twin_hosts": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "hosts": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "city": {

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-pubrio-com-cloud-footprint-insights-fcc7f74c/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)
