{"uid":"cap_FKaoXwzTgdI79Fvy-p9DQ","slug":"agents-pubrio-com-cloud-footprint-insights-fcc7f74c","name":"Cloud Footprint Insights","description":"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.","url":"https://agents.pubrio.com/companies/cloud_footprints/insights?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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":{"type":"string","nullable":true,"description":"City; `null` when unknown."},"host":{"type":"string","description":"Host name."},"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."},"first_seen_at":{"type":"string","format":"date-time","description":"When the host was first seen."}}},"description":"One live host per cloud, up to 3."},"service":{"type":"string","description":"The service name the hosts share."},"providers":{"type":"array","items":{"type":"string"},"description":"Clouds the service is live on, newest first."},"new_provider":{"type":"string","description":"The most recently added cloud."},"first_seen_at":{"type":"string","format":"date-time","description":"When the service was first seen on any of these clouds."},"new_provider_first_seen_at":{"type":"string","format":"date-time","description":"When the service was first seen on `new_provider`."}}},"nullable":true,"description":"One service live on two or more clouds at once, with the newest cloud added inside the date window."},"moved_hosts":{"type":"array","items":{"type":"object","properties":{"to":{"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."},"last_seen_at":{"type":"string","format":"date-time","description":"When the host was last seen at this place."},"first_seen_at":{"type":"string","format":"date-time","description":"When the host was first seen at this place."}},"description":"Where the host answers now."},"from":{"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."},"last_seen_at":{"type":"string","format":"date-time","description":"When the host was last seen at this place."},"first_seen_at":{"type":"string","format":"date-time","description":"When the host was first seen at this place."}},"description":"Where the host answered before."},"host":{"type":"string","description":"Host name."},"is_live_confirmed":{"type":"boolean","description":"`true` when the host answers from `to` right now; `false` when it has left `from` but its new place could not be confirmed."},"is_provider_change":{"type":"boolean","description":"`true` when the provider changed; `false` when only the country or region changed."}}},"nullable":true,"description":"Hosts that now answer from a different provider, country or region."},"new_regions":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","nullable":true,"description":"City; `null` when unknown."},"hosts":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","nullable":true,"description":"City; `null` when unknown."},"host":{"type":"string","description":"Host name."},"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."},"first_seen_at":{"type":"string","format":"date-time","description":"When the host was first seen."}}},"description":"Up to 3 live hosts as proof."},"provider":{"type":"string","description":"Provider name."},"host_count":{"type":"integer","description":"Hosts the company has in this region now."},"region_name":{"type":"string","nullable":true,"description":"Region name; `null` when unknown."},"cloud_region":{"type":"string","nullable":true,"description":"Cloud region code; `null` when the flag is a new country on this provider."},"country_code":{"type":"string","description":"ISO 3166-1 alpha-2 country code."},"first_seen_at":{"type":"string","format":"date-time","description":"When the company was first seen in this region."}}},"nullable":true,"description":"New regions, or new countries, on a provider the company used before the date window."},"is_spam_flood":{"type":"boolean","description":"`true` when the company's host names are too noisy to flag; every list is then empty."},"new_providers":{"type":"array","items":{"type":"object","properties":{"hosts":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","nullable":true,"description":"City; `null` when unknown."},"host":{"type":"string","description":"Host name."},"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."},"first_seen_at":{"type":"string","format":"date-time","description":"When the host was first seen."}}},"description":"Up to 3 live hosts as proof."},"provider":{"type":"string","description":"Provider name."},"host_count":{"type":"integer","description":"Hosts the company has on this provider now."},"first_seen_at":{"type":"string","format":"date-time","description":"When the company was first seen on this provider."}}},"nullable":true,"description":"Providers the company started using inside the date window."}},"description":"Changes worth acting on. Each list holds up to 8 items, newest first. `null` when flags are not ready for this company yet; a single list is `null` when it could not be built on this call."},"totals":{"type":"object","properties":{"hosts":{"type":"integer","description":"Hosts across every provider and country."},"regions":{"type":"integer","description":"Distinct cloud regions."},"servers":{"type":"integer","description":"Distinct IP addresses behind those hosts."},"countries":{"type":"integer","description":"Countries the company hosts in."},"new_hosts":{"type":"integer","description":"Hosts first seen inside the date window."},"providers":{"type":"integer","description":"Distinct providers."},"cross_border_countries":{"type":"integer","description":"Countries outside the company's home market."}},"description":"Totals for the whole footprint. Only `new_hosts` follows the date window."},"regions":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","nullable":true,"description":"City; `null` when unknown."},"hosts":{"type":"integer","description":"Hosts in this region."},"servers":{"type":"integer","description":"Distinct IP addresses in this region."},"provider":{"type":"string","description":"Provider name."},"region_code":{"type":"string","description":"The provider's region code, such as `us-east-1`."},"region_name":{"type":"string","nullable":true,"description":"Region name; `null` when unknown."},"country_code":{"type":"string","description":"ISO 3166-1 alpha-2 country code."}}},"description":"Top 8 cloud regions, sorted by servers, then hosts."},"countries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"ISO 3166-1 alpha-2 country code."},"name":{"type":"string","description":"Country name."},"hosts":{"type":"integer","description":"Hosts in this country."},"servers":{"type":"integer","description":"Distinct IP addresses in this country."},"providers":{"type":"integer","description":"Providers used in this country."},"evidence_url":{"type":"string","format":"uri","nullable":true,"description":"Pubrio evidence page for this market; `null` for the home market."},"is_cross_border":{"type":"boolean","nullable":true,"description":"`true` when the country is outside the company's home market; `null` when the headquarters is unknown."}}},"description":"Top 8 countries, sorted by servers, then hosts."},"providers":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"Provider name."},"hosts":{"type":"integer","description":"Hosts on this provider."},"servers":{"type":"integer","description":"Distinct IP addresses on this provider."},"countries":{"type":"integer","description":"Countries this provider is used in."}}},"description":"Top 8 providers, sorted by servers, then hosts."},"window_days":{"type":"integer","description":"Days in the date window, counting both ends."},"recent_hosts":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","nullable":true,"description":"City; `null` when unknown."},"provider":{"type":"string","description":"Provider name."},"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."},"last_seen_at":{"type":"string","format":"date-time","description":"When the host was last seen."},"first_seen_at":{"type":"string","format":"date-time","description":"When the host was first seen."},"is_cross_border":{"type":"boolean","nullable":true,"description":"`true` when the country is outside the company's home market; `null` when the headquarters is unknown."}}},"description":"Up to 12 hosts first seen inside the date window, newest first, one entry per host."},"weekly_series":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer","description":"Hosts first seen that week."},"week_start":{"type":"string","format":"date","description":"First day of the week (YYYY-MM-DD)."}}},"description":"Hosts first seen each week inside the date window. Weeks start on Monday in your workspace timezone."}},"description":"Cloud footprint insights for the company."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I23N3TGJa5xUGtFm7IqWn","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_60Twwu3jcn8d_gStQ-N7V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.pubrio.com","brandSlug":"agents-pubrio-com-x402","brandBaseUrl":"https://agents.pubrio.com","brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-sales cloud stack research","prompt":"Before my call with Acme Corp tomorrow, can you pull their cloud footprint insights using domain search ID '3f8a2c1d-4e7b-4f1a-9c2d-1234567890ab'? I want to know their top cloud providers, which regions they operate in, and whether they've added any new hosts recently."},{"title":"Detecting shadow IT or test environment exposure","prompt":"Run a cloud footprint insights lookup for domain search ID 'a1b2c3d4-e5f6-7890-abcd-ef1234567890' and flag any test, staging, or proof-of-concept hosts that are running on clouds other than their primary provider."},{"title":"Monitoring competitor infrastructure expansion","prompt":"I want to track whether our competitor has expanded their cloud footprint — fetch insights for domain search ID 'b9e8d7c6-f5a4-3210-9876-fedcba098765' covering the date range from 2025-01-01 to 2025-03-31 and highlight any new weekly hosts or provider changes."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T21:42:09.672Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-cloud-footprint-insights-fcc7f74c"}