{"uid":"cap_we9_UXCJSPwrF-oJJpRfy","slug":"agents-pubrio-com-search-for-company-cloud-footprints-62b377ff","name":"Search for Company Cloud Footprints","description":"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).","url":"https://agents.pubrio.com/companies/cloud_footprints/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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 open-ended bound. Scoped to this footprint row — one provider in one country."},"host_count":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"Minimum and maximum hosts. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country."},"region_count":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"Minimum and maximum cloud regions. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country."},"server_count":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"string"},"example":["us-east-1","eu-central-1"],"description":"Restrict results to footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country."},"linkedin_urls":{"type":"array","items":{"type":"string"},"example":["https://www.linkedin.com/company/pubrio"],"description":"The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`"},"exclude_cities":{"type":"array","items":{"type":"string"},"example":["Ashburn","Frankfurt"],"description":"Remove footprint rows matching these cities. Scoped to this footprint row — one provider in one country."},"last_seen_dates":{"type":"array","items":{"type":"string","nullable":true},"example":["2026-01-01",null],"maxItems":2,"minItems":2,"description":"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":{"type":"string","format":"uuid","description":"A unique identifier for the company search operation."},"first_seen_dates":{"type":"array","items":{"type":"string","nullable":true},"example":["2026-01-01",null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"string"},"example":["TW","AE","NO"],"description":"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":{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information."},"exclude_providers":{"type":"array","items":{"type":"string"},"example":["AWS","Cloudflare","Hetzner"],"description":"Remove footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country."},"filter_conditions":{"type":"array","items":{"type":"object","properties":{"key":{"enum":["cloud_regions","cities"],"type":"string","example":"cloud_regions","description":"Which array filter the operator applies to."},"operator":{"enum":["or","and"],"type":"string","example":"and","description":"`or` matches rows carrying any listed value; `and` requires all of them."}}},"description":"Switches an array filter from OR (default: match any value) to AND (match all values). Applies to `cloud_regions` and `cities`."},"cloud_footprint_id":{"type":"string","format":"uuid","example":"f28215e6-f6ed-40c2-ac9b-d8e70164c0be","description":"Identifier of a single cloud footprint row."},"is_ascending_order":{"type":"boolean","default":false,"example":false,"description":"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":{"type":"array","items":{"type":"string","format":"uuid"},"example":["f28215e6-f6ed-40c2-ac9b-d8e70164c0be"],"description":"Identifiers of specific cloud footprint rows, for exporting a selection."},"shared_server_count":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"boolean","example":true,"description":"When true, return only footprint rows outside the company's home market. Rows whose company has no known headquarters are excluded."},"exclude_cloud_regions":{"type":"array","items":{"type":"string"},"example":["us-east-1","eu-central-1"],"description":"Remove footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country."},"exclude_target_locations":{"type":"array","items":{"type":"string"},"example":["IS","GB","FR","IE","ES"],"description":"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":{"type":"array","items":{"type":"string"},"example":["AWS","Cloudflare"],"description":"Companies that use any of these providers anywhere. The unprefixed `providers` narrows the rows returned; this narrows the companies."},"cloud_footprint_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 open-ended bound. Counted for the whole company, across every provider and country."},"cloud_footprint_host_count":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"string"},"example":["AWS"],"description":"Companies whose single largest provider is one of these."},"cloud_footprint_target_locations":{"type":"array","items":{"type":"string"},"example":["DE","SG"],"description":"Companies present in any of these countries anywhere in their footprint."},"cloud_footprint_shared_server_count":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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":{"type":"array","items":{"type":"integer","nullable":true},"example":[1,null],"maxItems":2,"minItems":2,"description":"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."}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_GEoqKZxS5MXk0kZyzPvXh","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.pubrio.com","brandSlug":"agents-pubrio-com-x402","brandBaseUrl":"https://agents.pubrio.com","brandDocsUrl":null,"whatItDoes":"Search and filter the public cloud and hosting infrastructure footprint of companies, returning which providers, countries, and regions they operate in.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Competitor cloud infrastructure audit","prompt":"Find all the cloud and hosting providers that stripe.com runs infrastructure on, including which countries and regions — I want to understand their full cloud footprint."},{"title":"Lead gen by cloud provider","prompt":"Search for companies that use Hetzner infrastructure in Frankfurt — give me the first page of results so I can identify potential customers for our data center services."},{"title":"Market expansion monitoring","prompt":"Which companies are running cloud infrastructure in Singapore using AWS or Google Cloud? Search Pubrio's cloud footprint data filtered to providers AWS and Google Cloud and city Singapore."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:20.720Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-search-for-company-cloud-footprints-62b377ff"}