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

# Recherche d'empreinte cloud d'entreprise

> Recherchez l'empreinte cloud et d'hébergement publique des entreprises : quels fournisseurs elles utilisent, dans quels pays et régions elles déploient. Chaque ligne correspond à une entreprise chez un fournisseur dans un pays. Consultez le [guide Cloud Footprint Search](/fr/developer-guides/search/cloud-footprint-search).



## OpenAPI

````yaml fr-openapi POST /companies/cloud_footprints/search
openapi: 3.0.0
info:
  description: >-
    L'API Pubrio fournit une intelligence d'expansion de marché — des signaux en
    temps réel qui indiquent quand une entreprise entre sur un nouveau marché —
    ainsi que les données d'entreprises et de personnes qui les sous-tendent.
    Recherchez, consultez et enrichissez des comptes et des contacts, et
    abonnez-vous à des signaux de mouvement typés et datés sur plus de 200
    marchés.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/fr/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/fr/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: >-
      Informations de profil de l'espace de travail et statistiques
      d'utilisation
  - name: Enrichment
    description: >-
      Enrichissez les fiches de personnes et d'entreprises avec des données B2B
      détaillées
  - name: Lookalike
    description: Trouvez des entreprises similaires à une entreprise donnée
  - name: Search
    description: >-
      Recherchez des personnes, des entreprises, des offres d'emploi, des
      actualités et des publicités à l'aide de filtres
  - name: Lookup
    description: >-
      Consultez des informations détaillées sur des personnes, entreprises,
      offres d'emploi, actualités, publicités et technologies spécifiques
  - name: LinkedIn
    description: >-
      Consultez les données de personnes et d'entreprises via des URL de profil
      LinkedIn
  - name: Redeem
    description: >-
      Utilisez des crédits pour débloquer les coordonnées de personnes (unitaire
      et par lot)
  - name: Channels
    description: >-
      Gérez les modèles de canaux de prospection (création, mise à jour,
      suppression, liste)
  - name: Monitor
    description: >-
      Créez et gérez des moniteurs de données avec webhooks, statistiques et
      traitement
  - name: Filters
    description: >-
      Récupérez les valeurs de filtre disponibles pour les paramètres de
      recherche (technologies, localisations, secteurs verticaux, etc.)
  - name: API Keys
    description: >-
      Listez et inspectez les journaux de requêtes API et les statistiques
      d'utilisation des clés API
  - name: Insights
    description: >-
      Informations agrégées sur les signaux des entreprises (offres d'emploi,
      actualités, publicités).
  - name: Export
    description: Exports de données en masse (soumis à des crédits).
  - name: Expansion
    description: >-
      Intelligence d'expansion de marché des entreprises : signaux, étapes,
      marchés et exports.
externalDocs:
  description: >-
    L'API Pubrio permet de rechercher, prévisualiser et enrichir des contacts et
    des comptes. La base de données Pubrio fournit des données étendues de
    contacts B2B et de veille commerciale.
  url: https://docs.pubrio.com
paths:
  /companies/cloud_footprints/search:
    post:
      tags:
        - Search
      summary: Rechercher l'empreinte cloud des entreprises
      description: >-
        Recherchez l'empreinte cloud et d'hébergement publique des entreprises :
        quels fournisseurs elles utilisent, dans quels pays et régions elles
        déploient. Chaque ligne correspond à une entreprise chez un fournisseur
        dans un pays. Consultez le [guide Cloud Footprint
        Search](/fr/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: Lignes d'empreinte cloud paginées.
          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: >-
        Ne conserver que les lignes correspondant à ces fournisseurs cloud ou
        d'hébergement. Limité à cette ligne d'empreinte : un fournisseur dans un
        pays.
    exclude_providers:
      type: array
      items:
        type: string
      example:
        - AWS
        - Cloudflare
        - Hetzner
      description: >-
        Exclure les lignes correspondant à ces fournisseurs cloud ou
        d'hébergement. Limité à cette ligne d'empreinte : un fournisseur dans un
        pays.
    target_locations:
      type: array
      items:
        type: string
      example:
        - TW
        - AE
        - 'NO'
      description: >-
        Codes pays que les résultats doivent cibler. Combiné par défaut à
        `filter_conditions` en OR : il suffit qu'un seul corresponde.
    exclude_target_locations:
      type: array
      items:
        type: string
      example:
        - IS
        - GB
        - FR
        - IE
        - ES
      description: >-
        Codes pays que les résultats ne doivent pas cibler. Combiné par défaut à
        `filter_conditions` en OR : il suffit qu'un seul corresponde.
    cloud_regions:
      type: array
      items:
        type: string
      example:
        - us-east-1
        - eu-central-1
      description: >-
        Ne conserver que les lignes correspondant à ces régions cloud. Limité à
        cette ligne d'empreinte : un fournisseur dans un pays.
    exclude_cloud_regions:
      type: array
      items:
        type: string
      example:
        - us-east-1
        - eu-central-1
      description: >-
        Exclure les lignes correspondant à ces régions cloud. Limité à cette
        ligne d'empreinte : un fournisseur dans un pays.
    cities:
      type: array
      items:
        type: string
      example:
        - Ashburn
        - Frankfurt
      description: >-
        Ne conserver que les lignes correspondant à ces villes. Limité à cette
        ligne d'empreinte : un fournisseur dans un pays.
    exclude_cities:
      type: array
      items:
        type: string
      example:
        - Ashburn
        - Frankfurt
      description: >-
        Exclure les lignes correspondant à ces villes. Limité à cette ligne
        d'empreinte : un fournisseur dans un pays.
    first_seen_dates:
      type: array
      items:
        type: string
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - '2026-01-01'
        - null
      description: >-
        Deux dates ISO 8601 (AAAA-MM-JJ) délimitant la période où l'empreinte a
        été vue pour la première fois. Limité à cette ligne d'empreinte : un
        fournisseur dans un pays.
    last_seen_dates:
      type: array
      items:
        type: string
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - '2026-01-01'
        - null
      description: >-
        Deux dates ISO 8601 (AAAA-MM-JJ) délimitant la période où l'empreinte a
        été vue pour la dernière fois. Limité à cette ligne d'empreinte : un
        fournisseur dans un pays.
    is_cross_border_only:
      type: boolean
      example: true
      description: >-
        Si true, ne renvoie que les lignes hors du marché d'origine de
        l'entreprise. Les entreprises sans siège connu sont exclues.
    host_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de hôtes. Utilisez `null` pour laisser une borne
        ouverte. Limité à cette ligne d'empreinte : un fournisseur dans un pays.
    server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de serveurs (IP distinctes). Utilisez `null` pour
        laisser une borne ouverte. Limité à cette ligne d'empreinte : un
        fournisseur dans un pays.
    shared_server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de serveurs partagés avec d'autres entreprises.
        Utilisez `null` pour laisser une borne ouverte. Limité à cette ligne
        d'empreinte : un fournisseur dans un pays.
    region_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de régions cloud. Utilisez `null` pour laisser une
        borne ouverte. Limité à cette ligne d'empreinte : un fournisseur dans un
        pays.
    city_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de villes. Utilisez `null` pour laisser une borne
        ouverte. Limité à cette ligne d'empreinte : un fournisseur dans un pays.
    cloud_footprint_host_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de hôtes. Utilisez `null` pour laisser une borne
        ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays
        confondus.
    cloud_footprint_server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de serveurs (IP distinctes). Utilisez `null` pour
        laisser une borne ouverte. Compté pour l'entreprise entière, tous
        fournisseurs et pays confondus.
    cloud_footprint_shared_server_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de serveurs partagés avec d'autres entreprises.
        Utilisez `null` pour laisser une borne ouverte. Compté pour l'entreprise
        entière, tous fournisseurs et pays confondus.
    cloud_footprint_provider_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de fournisseurs distincts utilisés par l'entreprise.
        Utilisez `null` pour laisser une borne ouverte. Compté pour l'entreprise
        entière, tous fournisseurs et pays confondus.
    cloud_footprint_country_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de pays où l'entreprise héberge. Utilisez `null` pour
        laisser une borne ouverte. Compté pour l'entreprise entière, tous
        fournisseurs et pays confondus.
    cloud_footprint_cross_border_country_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de pays hors du marché d'origine. Utilisez `null`
        pour laisser une borne ouverte. Compté pour l'entreprise entière, tous
        fournisseurs et pays confondus.
    cloud_footprint_region_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de régions cloud. Utilisez `null` pour laisser une
        borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et
        pays confondus.
    cloud_footprint_city_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Minimum et maximum de villes. Utilisez `null` pour laisser une borne
        ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays
        confondus.
    company_locations:
      type: array
      items:
        type: string
      example:
        - US
        - SG
        - CN
      description: >-
        L'emplacement du siège social de l'entreprise. Consultez les points de
        terminaison `location` sous l'onglet Filters pour plus d'informations.
    cloud_footprint_id:
      type: string
      format: uuid
      example: f28215e6-f6ed-40c2-ac9b-d8e70164c0be
      description: Identifiant d'une ligne d'empreinte cloud.
    cloud_footprint_ids:
      type: array
      items:
        type: string
        format: uuid
      example:
        - f28215e6-f6ed-40c2-ac9b-d8e70164c0be
      description: Identifiants de lignes précises, pour exporter une sélection.
    companies:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        Une liste d'identifiants uniques (domain_search_id) utilisée pour les
        opérations de recherche d'entreprises et de personnes.
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: >-
        Liste de domaines d'entreprise utilisée pour les opérations de recherche
        d'entreprises et de personnes. Si nous recevons une URL telle que
        `www.pubrio.com` ou `https://docs.pubrio.com/`, le système la convertira
        en `pubrio.com` pour le traitement.
    per_page:
      type: integer
      example: 25
      default: 25
      maximum: 25
      description: >-
        Enregistrements par page. Par défaut 25, ce qui constitue également le
        plafond sur la plupart des forfaits — la limite correspond au
        `max_search_per_page` de votre abonnement, renvoyé par
        [Profile](/fr/api-reference/endpoint/profile/profile). Le dépasser
        renvoie **HTTP 416** avec le code `41676` (ou `41613` pour la recherche
        d'entreprises et de personnes), et non un ensemble de résultats tronqué.
    page:
      type: integer
      example: 1
      default: 1
      description: >-
        Numéro de page, à partir de 1. Le plafond correspond au
        `max_search_page` de votre abonnement (`max_company_search_page` pour la
        recherche d'entreprises), renvoyé par
        [Profile](/fr/api-reference/endpoint/profile/profile). Le dépasser
        renvoie **HTTP 416**.
    is_ascending_order:
      type: boolean
      default: false
      example: false
      description: >-
        Sens de tri. Les résultats sont renvoyés du plus récent au plus ancien
        par défaut ; définissez `true` pour du plus ancien au plus récent. Il
        n'y a pas de `sort_by` sur cet endpoint — la clé de tri est fixe et
        indiquée dans la description de l'endpoint.
    cloud_footprint_providers:
      type: array
      items:
        type: string
      example:
        - AWS
        - Cloudflare
      description: >-
        Entreprises utilisant l'un de ces fournisseurs où que ce soit.
        `providers` sans préfixe restreint les lignes ; celui-ci restreint les
        entreprises.
    cloud_footprint_target_locations:
      type: array
      items:
        type: string
      example:
        - DE
        - SG
      description: >-
        Entreprises présentes dans l'un de ces pays, où que ce soit dans leur
        empreinte.
    cloud_footprint_primary_provider:
      type: array
      items:
        type: string
      example:
        - AWS
      description: Entreprises dont le principal fournisseur est l'un de ceux-ci.
    domain:
      type: string
      example: pubrio.com
      description: >-
        Un domaine d'entreprise utilisé pour les opérations de recherche
        d'entreprises. Si nous recevons une URL telle que `www.pubrio.com` ou
        `https://docs.pubrio.com/`, le système la convertira en `pubrio.com`
        pour le traitement.
    domain_search_id:
      type: string
      format: uuid
      description: Un identifiant unique pour l'opération de recherche d'entreprise.
    company_linkedin_urls:
      type: array
      items:
        type: string
      example:
        - https://www.linkedin.com/company/pubrio
      description: >-
        L'URL complète du profil d'entreprise LinkedIn. L'URL commence par
        `http` et contient `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: Le filtre de tableau auquel s'applique l'opérateur.
          operator:
            type: string
            enum:
              - or
              - and
            example: and
            description: >-
              `or` correspond aux lignes portant l'une des valeurs ; `and` les
              exige toutes.
      description: >-
        Bascule un filtre de tableau de OR (par défaut : n'importe quelle
        valeur) à AND (toutes les valeurs). S'applique à `cloud_regions`,
        `exclude_cloud_regions`, `cities` et `exclude_cities`.
  responses:
    general_error:
      description: >-
        Requête invalide. La requête était mal formée ou contenait des
        paramètres invalides. Consultez le code d'erreur et le message pour plus
        de détails.
      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: >-
        Limite de débit dépassée. Trop de requêtes ont été effectuées au cours
        d'une période donnée. Réessayez après la réinitialisation de la fenêtre
        de limitation de débit.
      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: >-
        Erreur interne du serveur. Une erreur inattendue s'est produite sur le
        serveur. Contactez le support si l'erreur 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 jeton API unique qui représente les actions que vous effectuez via
        l'API ainsi que les autorisations et opérations correspondantes. Vous
        pouvez le créer dans la section
        [Settings](https://dashboard.pubrio.com/#/settings/).
      in: header

````