> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Busca de Pegada Cloud de Empresas > Pesquise a pegada pública de cloud e alojamento das empresas: que fornecedores usam e em que países e regiões implementam. Cada linha é uma empresa num fornecedor e num país. Consulte o [guia de pesquisa de pegada cloud](/pt/developer-guides/search/cloud-footprint-search). ## OpenAPI ````yaml pt-openapi POST /companies/cloud_footprints/search openapi: 3.0.0 info: description: >- A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo real que indicam quando uma empresa entra em um novo mercado — além dos dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e enriqueça contas e contatos, e assine sinais de movimentação tipados e datados em mais de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/pt-BR/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/pt-BR/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Informações do perfil da equipe e estatísticas de uso - name: Enrichment description: Enriqueça registros de pessoas e empresas com dados B2B detalhados - name: Lookalike description: Encontre empresas semelhantes a uma empresa específica - name: Search description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros - name: Lookup description: >- Consulte informações detalhadas de pessoas, empresas, vagas, notícias, anúncios e tecnologias específicas - name: LinkedIn description: >- Consulte dados de pessoas e empresas por meio de URLs de perfil do LinkedIn - name: Redeem description: >- Resgate créditos para desbloquear detalhes de contato de pessoas (individual e em lote) - name: Channels description: >- Gerencie templates de canais de outreach (criar, atualizar, excluir, listar) - name: Monitor description: >- Crie e gerencie monitores de dados com webhooks, estatísticas e processamento - name: Filters description: >- Obtenha os valores de filtro disponíveis para os parâmetros de busca (tecnologias, localizações, verticais etc.) - name: API Keys description: >- Liste e inspecione logs de requisições da API e análises de uso das chaves de API - name: Insights description: Insights agregados de sinais para empresas (vagas, notícias, anúncios). - name: Export description: Exportações de dados em massa (consomem créditos). - name: Expansion description: >- Inteligência de expansão de mercado de empresas: sinais, estágios, mercados e exportações. externalDocs: description: >- A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e inteligência de vendas. url: https://docs.pubrio.com paths: /companies/cloud_footprints/search: post: tags: - Search summary: Pesquisar a pegada cloud de empresas description: >- Pesquise a pegada pública de cloud e alojamento das empresas: que fornecedores usam e em que países e regiões implementam. Cada linha é uma empresa num fornecedor e num país. Consulte o [guia de pesquisa de pegada cloud](/pt/developer-guides/search/cloud-footprint-search). operationId: companies_search_cloud_footprints parameters: [] requestBody: required: true content: application/json: schema: type: object properties: providers: $ref: '#/components/schemas/providers' exclude_providers: $ref: '#/components/schemas/exclude_providers' target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' cloud_regions: $ref: '#/components/schemas/cloud_regions' exclude_cloud_regions: $ref: '#/components/schemas/exclude_cloud_regions' cities: $ref: '#/components/schemas/cities' exclude_cities: $ref: '#/components/schemas/exclude_cities' first_seen_dates: $ref: '#/components/schemas/first_seen_dates' last_seen_dates: $ref: '#/components/schemas/last_seen_dates' is_cross_border_only: $ref: '#/components/schemas/is_cross_border_only' host_count: $ref: '#/components/schemas/host_count' server_count: $ref: '#/components/schemas/server_count' shared_server_count: $ref: '#/components/schemas/shared_server_count' region_count: $ref: '#/components/schemas/region_count' city_count: $ref: '#/components/schemas/city_count' cloud_footprint_host_count: $ref: '#/components/schemas/cloud_footprint_host_count' cloud_footprint_server_count: $ref: '#/components/schemas/cloud_footprint_server_count' cloud_footprint_shared_server_count: $ref: '#/components/schemas/cloud_footprint_shared_server_count' cloud_footprint_provider_count: $ref: '#/components/schemas/cloud_footprint_provider_count' cloud_footprint_country_count: $ref: '#/components/schemas/cloud_footprint_country_count' cloud_footprint_cross_border_country_count: $ref: >- #/components/schemas/cloud_footprint_cross_border_country_count cloud_footprint_region_count: $ref: '#/components/schemas/cloud_footprint_region_count' cloud_footprint_city_count: $ref: '#/components/schemas/cloud_footprint_city_count' company_locations: $ref: '#/components/schemas/company_locations' cloud_footprint_id: $ref: '#/components/schemas/cloud_footprint_id' cloud_footprint_ids: $ref: '#/components/schemas/cloud_footprint_ids' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' cloud_footprint_providers: $ref: '#/components/schemas/cloud_footprint_providers' cloud_footprint_target_locations: $ref: '#/components/schemas/cloud_footprint_target_locations' cloud_footprint_primary_provider: $ref: '#/components/schemas/cloud_footprint_primary_provider' domain: $ref: '#/components/schemas/domain' domain_search_id: $ref: '#/components/schemas/domain_search_id' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' filter_conditions: $ref: '#/components/schemas/cloud_footprint_filter_conditions' responses: '200': description: Linhas de pegada cloud paginadas. content: application/json: schema: type: object example: metadata: profile: null filters: page: 1 per_page: 1 is_cross_border_only: true language: en ignored_fields: [] data: pagination: page: 1 per_page: 1 total_entries: 48700 total_pages: 48700 total_display_pages: 250 is_timeout: false cloud_footprints: - cloud_footprint_id: 042fee02-5121-4f23-a166-69bc48e9dfe8 domain_search_id: 2ebd09b1-3bdf-4bf0-9732-c2ed6a734f77 provider: AWS country_code: US company_country_code: CL is_home_market: false host_count: 232 server_count: 3 shared_server_count: 0 region_count: 1 city_count: 0 cloud_regions: - us-east-1 cities: null first_seen_at: '2026-07-26T16:57:20.362Z' last_seen_at: '2026-09-04T10:07:09.799Z' last_modified: '2026-09-04T10:26:52.183Z' companies: logo_url: >- https://buckets.pubrio.com/company-logo/MTc4ODM0MDY5Nmlsajlzc25qMXJ0aWFwLmNvbWxpbmtlZGluXzQ3Njc2Nzkw.jpg domain_search_id: 2ebd09b1-3bdf-4bf0-9732-c2ed6a734f77 company_name: RTIAP Soluciones Tecnológicas SpA linkedin_name: rtiap country_code: CL company_url: http://www.rtiap.com domain: rtiap.com evidence_url: >- https://www.pubrio.com/evidence/84c941ea04a8fa9ed1bbeabc8ff496a7 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: providers: type: array items: type: string example: - AWS - Cloudflare - Hetzner description: >- Limitar aos resultados que correspondam a estes fornecedores cloud ou de alojamento. Limitado a esta linha de pegada: um fornecedor num país. exclude_providers: type: array items: type: string example: - AWS - Cloudflare - Hetzner description: >- Excluir as linhas que correspondam a estes fornecedores cloud ou de alojamento. Limitado a esta linha de pegada: um fornecedor num país. target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Códigos de país que os resultados devem visar. Combina-se com `filter_conditions` como OR por predefinição — basta um corresponder. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Códigos de país que os resultados não devem visar. Combina-se com `filter_conditions` como OR por predefinição — basta um corresponder. cloud_regions: type: array items: type: string example: - us-east-1 - eu-central-1 description: >- Limitar aos resultados que correspondam a estes regiões cloud. Limitado a esta linha de pegada: um fornecedor num país. exclude_cloud_regions: type: array items: type: string example: - us-east-1 - eu-central-1 description: >- Excluir as linhas que correspondam a estes regiões cloud. Limitado a esta linha de pegada: um fornecedor num país. cities: type: array items: type: string example: - Ashburn - Frankfurt description: >- Limitar aos resultados que correspondam a estes cidades. Limitado a esta linha de pegada: um fornecedor num país. exclude_cities: type: array items: type: string example: - Ashburn - Frankfurt description: >- Excluir as linhas que correspondam a estes cidades. Limitado a esta linha de pegada: um fornecedor num país. first_seen_dates: type: array items: type: string nullable: true minItems: 2 maxItems: 2 example: - '2026-01-01' - null description: >- Duas datas ISO 8601 (AAAA-MM-DD) que delimitam quando a pegada foi vista pela primeira vez. Limitado a esta linha de pegada: um fornecedor num país. last_seen_dates: type: array items: type: string nullable: true minItems: 2 maxItems: 2 example: - '2026-01-01' - null description: >- Duas datas ISO 8601 (AAAA-MM-DD) que delimitam quando a pegada foi vista pela última vez. Limitado a esta linha de pegada: um fornecedor num país. is_cross_border_only: type: boolean example: true description: >- Se true, devolve apenas linhas fora do mercado de origem da empresa. Empresas sem sede conhecida são excluídas. host_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de hosts. Use `null` para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país. server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de servidores (IP distintos). Use `null` para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país. shared_server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de servidores partilhados com outras empresas. Use `null` para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país. region_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de regiões cloud. Use `null` para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país. city_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de cidades. Use `null` para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país. cloud_footprint_host_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de hosts. Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. cloud_footprint_server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de servidores (IP distintos). Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. cloud_footprint_shared_server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de servidores partilhados com outras empresas. Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. cloud_footprint_provider_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de fornecedores distintos usados pela empresa. Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. cloud_footprint_country_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de países onde a empresa aloja. Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. cloud_footprint_cross_border_country_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de países fora do mercado de origem. Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. cloud_footprint_region_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de regiões cloud. Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. cloud_footprint_city_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Mínimo e máximo de cidades. Use `null` para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países. company_locations: type: array items: type: string example: - US - SG - CN description: >- A localização da sede da empresa. Consulte os endpoints de `location` na aba Filters para mais informações. cloud_footprint_id: type: string format: uuid example: f28215e6-f6ed-40c2-ac9b-d8e70164c0be description: Identificador de uma linha de pegada cloud. cloud_footprint_ids: type: array items: type: string format: uuid example: - f28215e6-f6ed-40c2-ac9b-d8e70164c0be description: Identificadores de linhas específicas, para exportar uma seleção. companies: type: array items: type: string format: uuid description: >- Uma lista de identificadores únicos (domain_search_id) usada para operações de busca de empresas e pessoas. domains: type: array items: type: string example: - pubrio.com description: >- Lista de domínios de empresas usada para operações de busca de empresas e pessoas. Se recebermos uma URL como `www.pubrio.com` ou `https://docs.pubrio.com/`, o sistema a converterá para `pubrio.com` para processamento. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o `max_search_per_page` da sua assinatura, retornado por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo retorna **HTTP 416** com o código `41676` (ou `41613` na busca de empresas e pessoas), não um conjunto de resultados limitado. page: type: integer example: 1 default: 1 description: >- Número da página, começando em 1. O teto é o `max_search_page` da sua assinatura (`max_company_search_page` para busca de empresas), retornado por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo retorna **HTTP 416**. is_ascending_order: type: boolean default: false example: false description: >- Direção da ordenação. Por padrão, os resultados são retornados do mais recente para o mais antigo; defina `true` para do mais antigo para o mais recente. Não há `sort_by` neste endpoint — a chave de ordenação é fixa e está indicada na descrição do endpoint. cloud_footprint_providers: type: array items: type: string example: - AWS - Cloudflare description: >- Empresas que usam algum destes fornecedores em qualquer lugar. `providers` sem prefixo restringe as linhas; este restringe as empresas. cloud_footprint_target_locations: type: array items: type: string example: - DE - SG description: >- Empresas presentes em algum destes países em qualquer parte da sua pegada. cloud_footprint_primary_provider: type: array items: type: string example: - AWS description: Empresas cujo maior fornecedor é um destes. domain: type: string example: pubrio.com description: >- Um domínio de empresa usado para operações de busca de empresas. Se recebermos uma URL como `www.pubrio.com` ou `https://docs.pubrio.com/`, o sistema a converterá para `pubrio.com` para processamento. domain_search_id: type: string format: uuid description: Um identificador único para a operação de busca de empresas. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- A URL completa do perfil da empresa no LinkedIn. A URL começa com `http` e contém `linkedin.com/company/` cloud_footprint_filter_conditions: type: array items: type: object properties: key: type: string enum: - cloud_regions - exclude_cloud_regions - cities - exclude_cities example: cloud_regions description: A que filtro de array se aplica o operador. operator: type: string enum: - or - and example: and description: >- `or` corresponde a linhas com qualquer um dos valores; `and` exige todos. description: >- Muda um filtro de array de OR (predefinição: corresponde a qualquer valor) para AND (corresponde a todos). Aplica-se a `cloud_regions`, `exclude_cloud_regions`, `cities` e `exclude_cities`. responses: general_error: description: >- Requisição inválida. A requisição estava malformada ou continha parâmetros inválidos. Verifique o código de erro e a mensagem para mais detalhes. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações. type: string details: type: object rate_limit_error: description: >- Limite de requisições excedido. Foram feitas requisições em excesso em um determinado período de tempo. Tente novamente após a janela do limite de requisições ser reiniciada. content: application/json: schema: required: - error type: object properties: error: example: >- Limite de requisições excedido. Aguarde e tente novamente mais tarde. type: string server_error: description: >- Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre em contato com o suporte caso o erro persista. content: application/json: schema: required: - error type: object properties: error: example: Ocorreu um erro inesperado no servidor. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção [Configurações](https://dashboard.pubrio.com/#/settings/). in: header ````