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

# Búsqueda de la huella cloud de la empresa

> Busca la huella pública de cloud y hosting de las empresas: qué proveedores usan y en qué países y regiones despliegan. Cada fila es una empresa en un proveedor y un país. Consulta la [guía de búsqueda de huella cloud](/es/developer-guides/search/cloud-footprint-search).



## OpenAPI

````yaml es-openapi POST /companies/cloud_footprints/search
openapi: 3.0.0
info:
  description: >-
    La API de Pubrio ofrece inteligencia de expansión de mercado —señales en
    tiempo real que indican cuándo una empresa entra en un nuevo mercado— junto
    con los datos de empresas y personas que las respaldan. Busca, consulta y
    enriquece cuentas y contactos, y suscríbete a señales de movimiento tipadas
    y fechadas en más de 200 mercados.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/es/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/es/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: Información del perfil del espacio de trabajo y estadísticas de uso
  - name: Enrichment
    description: Enriquece registros de personas y empresas con datos B2B detallados
  - name: Lookalike
    description: Encuentra empresas similares a una empresa determinada
  - name: Search
    description: Busca personas, empresas, empleos, noticias y anuncios con filtros
  - name: Lookup
    description: >-
      Consulta información detallada de personas, empresas, empleos, noticias,
      anuncios y tecnologías específicos
  - name: LinkedIn
    description: Consulta datos de personas y empresas mediante URL de perfil de LinkedIn
  - name: Redeem
    description: >-
      Canjea créditos para desbloquear datos de contacto de personas (individual
      y por lotes)
  - name: Channels
    description: >-
      Gestiona plantillas de canales de contacto (crear, actualizar, eliminar,
      listar)
  - name: Monitor
    description: >-
      Crea y gestiona monitores de datos con webhooks, estadísticas y
      procesamiento
  - name: Filters
    description: >-
      Obtén los valores de filtro disponibles para los parámetros de búsqueda
      (tecnologías, ubicaciones, verticales, etc.)
  - name: API Keys
    description: >-
      Lista e inspecciona los registros de solicitudes a la API y las analíticas
      de uso de las claves de API
  - name: Insights
    description: >-
      Información agregada de señales para empresas (empleos, noticias,
      anuncios).
  - name: Export
    description: Exportaciones de datos masivas (sujetas a créditos).
  - name: Expansion
    description: >-
      Inteligencia de expansión de mercado de empresas: señales, etapas,
      mercados y exportaciones.
externalDocs:
  description: >-
    La API de Pubrio se utiliza para buscar, previsualizar y enriquecer
    contactos y cuentas. La base de datos de Pubrio ofrece amplios datos de
    contactos B2B e inteligencia de ventas.
  url: https://docs.pubrio.com
paths:
  /companies/cloud_footprints/search:
    post:
      tags:
        - Search
      summary: Buscar la huella cloud de empresas
      description: >-
        Busca la huella pública de cloud y hosting de las empresas: qué
        proveedores usan y en qué países y regiones despliegan. Cada fila es una
        empresa en un proveedor y un país. Consulta la [guía de búsqueda de
        huella cloud](/es/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: Filas de huella 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: >-
        Limita los resultados a las filas que coincidan con proveedores cloud o
        de hosting. Limitado a esta fila de huella: un proveedor en un país.
    exclude_providers:
      type: array
      items:
        type: string
      example:
        - AWS
        - Cloudflare
        - Hetzner
      description: >-
        Excluye las filas que coincidan con proveedores cloud o de hosting.
        Limitado a esta fila de huella: un proveedor en un país.
    target_locations:
      type: array
      items:
        type: string
      example:
        - TW
        - AE
        - 'NO'
      description: >-
        Códigos de país a los que deben dirigirse los resultados. Se combina con
        `filter_conditions` como OR por defecto: basta con que coincida uno.
    exclude_target_locations:
      type: array
      items:
        type: string
      example:
        - IS
        - GB
        - FR
        - IE
        - ES
      description: >-
        Códigos de país a los que no deben dirigirse los resultados. Se combina
        con `filter_conditions` como OR por defecto: basta con que coincida uno.
    cloud_regions:
      type: array
      items:
        type: string
      example:
        - us-east-1
        - eu-central-1
      description: >-
        Limita los resultados a las filas que coincidan con regiones cloud.
        Limitado a esta fila de huella: un proveedor en un país.
    exclude_cloud_regions:
      type: array
      items:
        type: string
      example:
        - us-east-1
        - eu-central-1
      description: >-
        Excluye las filas que coincidan con regiones cloud. Limitado a esta fila
        de huella: un proveedor en un país.
    cities:
      type: array
      items:
        type: string
      example:
        - Ashburn
        - Frankfurt
      description: >-
        Limita los resultados a las filas que coincidan con ciudades. Limitado a
        esta fila de huella: un proveedor en un país.
    exclude_cities:
      type: array
      items:
        type: string
      example:
        - Ashburn
        - Frankfurt
      description: >-
        Excluye las filas que coincidan con ciudades. Limitado a esta fila de
        huella: un proveedor en un país.
    first_seen_dates:
      type: array
      items:
        type: string
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - '2026-01-01'
        - null
      description: >-
        Dos fechas ISO 8601 (AAAA-MM-DD) que acotan cuándo se detectó por
        primera vez la huella. Limitado a esta fila de huella: un proveedor en
        un país.
    last_seen_dates:
      type: array
      items:
        type: string
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - '2026-01-01'
        - null
      description: >-
        Dos fechas ISO 8601 (AAAA-MM-DD) que acotan cuándo se detectó por última
        vez la huella. Limitado a esta fila de huella: un proveedor en un país.
    is_cross_border_only:
      type: boolean
      example: true
      description: >-
        Si es true, devuelve solo filas fuera del mercado de origen de la
        empresa. Se excluyen las empresas sin sede conocida.
    host_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de hosts. Usa `null` para dejar un extremo abierto.
        Limitado a esta fila de huella: un proveedor en un país.
    server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de servidores (IP distintas). Usa `null` para dejar un
        extremo abierto. Limitado a esta fila de huella: un proveedor en un
        país.
    shared_server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de servidores compartidos con otras empresas. Usa `null`
        para dejar un extremo abierto. Limitado a esta fila de huella: un
        proveedor en un país.
    region_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de regiones cloud. Usa `null` para dejar un extremo
        abierto. Limitado a esta fila de huella: un proveedor en un país.
    city_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de ciudades. Usa `null` para dejar un extremo abierto.
        Limitado a esta fila de huella: un proveedor en un país.
    cloud_footprint_host_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de hosts. Usa `null` para dejar un extremo abierto.
        Contado para toda la empresa, en todos los proveedores y países.
    cloud_footprint_server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de servidores (IP distintas). Usa `null` para dejar un
        extremo abierto. Contado para toda la empresa, en todos los proveedores
        y países.
    cloud_footprint_shared_server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de servidores compartidos con otras empresas. Usa `null`
        para dejar un extremo abierto. Contado para toda la empresa, en todos
        los proveedores y países.
    cloud_footprint_provider_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de proveedores distintos que usa la empresa. Usa `null`
        para dejar un extremo abierto. Contado para toda la empresa, en todos
        los proveedores y países.
    cloud_footprint_country_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de países donde aloja la empresa. Usa `null` para dejar
        un extremo abierto. Contado para toda la empresa, en todos los
        proveedores y 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 y máximo de países fuera del mercado de origen. Usa `null` para
        dejar un extremo abierto. Contado para toda la empresa, en todos los
        proveedores y países.
    cloud_footprint_region_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de regiones cloud. Usa `null` para dejar un extremo
        abierto. Contado para toda la empresa, en todos los proveedores y
        países.
    cloud_footprint_city_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Mínimo y máximo de ciudades. Usa `null` para dejar un extremo abierto.
        Contado para toda la empresa, en todos los proveedores y países.
    company_locations:
      type: array
      items:
        type: string
      example:
        - US
        - SG
        - CN
      description: >-
        La ubicación de la sede de la empresa. Consulta los endpoints `location`
        en la pestaña Filters para más información.
    cloud_footprint_id:
      type: string
      format: uuid
      example: f28215e6-f6ed-40c2-ac9b-d8e70164c0be
      description: Identificador de una fila de huella cloud.
    cloud_footprint_ids:
      type: array
      items:
        type: string
        format: uuid
      example:
        - f28215e6-f6ed-40c2-ac9b-d8e70164c0be
      description: Identificadores de filas concretas para exportar una selección.
    companies:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        Una lista de identificadores únicos (domain_search_id) utilizada para
        operaciones de búsqueda de empresas y personas.
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: >-
        Lista de dominios de empresa utilizada para operaciones de búsqueda de
        empresas y personas. Si recibimos una URL como `www.pubrio.com` o
        `https://docs.pubrio.com/`, el sistema la convertirá a `pubrio.com` para
        su procesamiento.
    per_page:
      type: integer
      example: 25
      default: 25
      maximum: 25
      description: >-
        Registros por página. Por defecto es 25, que también es el límite en la
        mayoría de los planes — el límite es el `max_search_per_page` de tu
        suscripción, devuelto por
        [Perfil](/es/api-reference/endpoint/profile/profile). Superarlo devuelve
        **HTTP 416** con el código `41676` (o `41613` en la búsqueda de empresas
        y personas), no un conjunto de resultados recortado.
    page:
      type: integer
      example: 1
      default: 1
      description: >-
        Número de página, empezando en 1. El límite es el `max_search_page` de
        tu suscripción (`max_company_search_page` para la búsqueda de empresas),
        devuelto por [Perfil](/es/api-reference/endpoint/profile/profile).
        Superarlo devuelve **HTTP 416**.
    is_ascending_order:
      type: boolean
      default: false
      example: false
      description: >-
        Dirección de ordenación. Los resultados se devuelven por defecto de más
        reciente a más antiguo; establece `true` para el orden inverso (de más
        antiguo a más reciente). No existe `sort_by` en este endpoint: la clave
        de ordenación es fija y se indica en la descripción del endpoint.
    cloud_footprint_providers:
      type: array
      items:
        type: string
      example:
        - AWS
        - Cloudflare
      description: >-
        Empresas que usan alguno de estos proveedores en cualquier lugar.
        `providers` sin prefijo acota las filas; este acota las empresas.
    cloud_footprint_target_locations:
      type: array
      items:
        type: string
      example:
        - DE
        - SG
      description: >-
        Empresas presentes en alguno de estos países en cualquier parte de su
        huella.
    cloud_footprint_primary_provider:
      type: array
      items:
        type: string
      example:
        - AWS
      description: Empresas cuyo mayor proveedor es uno de estos.
    domain:
      type: string
      example: pubrio.com
      description: >-
        Un dominio de empresa utilizado para operaciones de búsqueda de
        empresas. Si recibimos una URL como `www.pubrio.com` o
        `https://docs.pubrio.com/`, el sistema la convertirá a `pubrio.com` para
        su procesamiento.
    domain_search_id:
      type: string
      format: uuid
      description: Identificador único para la operación de búsqueda de empresas.
    company_linkedin_urls:
      type: array
      items:
        type: string
      example:
        - https://www.linkedin.com/company/pubrio
      description: >-
        La URL completa del perfil de LinkedIn de la empresa. La URL debe
        empezar por `http` y contener `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 qué filtro de array se aplica el operador.
          operator:
            type: string
            enum:
              - or
              - and
            example: and
            description: >-
              `or` coincide con filas que tengan cualquiera de los valores;
              `and` exige todos.
      description: >-
        Cambia un filtro de array de OR (por defecto: coincide con cualquier
        valor) a AND (coincide con todos). Se aplica a `cloud_regions`,
        `exclude_cloud_regions`, `cities` y `exclude_cities`.
  responses:
    general_error:
      description: >-
        Solicitud incorrecta. La solicitud estaba mal formada o contenía
        parámetros no válidos. Consulta el código de error y el mensaje para más
        detalles.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        Límite de tasa excedido. Se realizaron demasiadas solicitudes en un
        período de tiempo determinado. Vuelve a intentarlo después de que se
        restablezca la ventana de límite de tasa.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        Error interno del servidor. Se produjo un error inesperado en el
        servidor. Contacta con soporte si el error persiste.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        Un token de API único que representa las acciones que realizas a través
        de la API, junto con los permisos y operaciones correspondientes. Puedes
        crearlo en la sección
        [Configuración](https://dashboard.pubrio.com/#/settings/).
      in: header

````