> ## 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
> Voyez chez quels fournisseurs cloud et d'hébergement une entreprise opère, dans quels pays et régions, et repérez les marchés où elle vient d'arriver.
[Recherche d'empreinte cloud](/fr/api-reference/endpoint/companies/cloud_footprints_search) renvoie une ligne par entreprise, fournisseur et pays. Une entreprise sur AWS en Allemagne et sur Cloudflare à Singapour, cela fait deux lignes. Chaque ligne indique l'ampleur sur place, les régions cloud et villes concernées, et les dates de première et dernière observation.
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_locations": ["DE"],
"providers": ["AWS"],
"first_seen_dates": ["2026-07-01", null],
"host_count": [100, null],
"per_page": 25
}'
```
## Quand l'utiliser
* **Repérer une entrée sur un marché.** `first_seen_dates` fait ressortir les entreprises dont l'infrastructure est apparue pour la première fois dans un pays pendant votre fenêtre.
* **Qualifier par l'échelle.** `host_count` et `server_count` distinguent une présence symbolique d'un déploiement réel.
* **Segmenter par stack.** `providers` et `cloud_regions` trouvent tous ceux qui utilisent une plateforme ou une région donnée.
* **Détecter l'expansion.** `is_cross_border_only` ne renvoie que la présence hors du marché d'origine.
## Restreindre à une entreprise
| Key | Value |
| - | - |
| `domains` | `["stripe.com"]` |
| `domain` | `"stripe.com"` |
| `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` |
| `companies` | `["db26de04-…"]` — `domain_search_id` values |
| `domain_search_id` | `"db26de04-…"` |
Une recherche sans entreprise est permise, et c'est la façon habituelle de constituer une liste — par exemple `{"target_locations": ["DE"], "providers": ["AWS"]}`.
## Filtres
### Fournisseur, région et ville
| Key | Example |
| - | - |
| `providers` | `["AWS", "Cloudflare"]` |
| `cloud_regions` | `["eu-central-1", "westeurope"]` |
| `cities` | `["Frankfurt", "Ashburn"]` |
Chaque clé accepte une liste et possède son jumeau `exclude_`. `cloud_regions` et `cities` sont des tableaux sur la ligne : ils acceptent donc aussi `filter_conditions` pour passer de OR (l'un) à AND (tous).
### Où se trouve l'infrastructure
| Key | Example |
| - | - |
| `target_locations` | `["DE", "SG"]` |
| `company_locations` | `["US"]` |
`target_locations` indique où tourne l'infrastructure, `company_locations` où se trouve le siège. Les lignes où les deux diffèrent sont précisément les plus intéressantes.
### Taille
| Key | Meaning |
| - | - |
| `host_count` | Hosts on this row |
| `server_count` | Distinct IP addresses |
| `shared_server_count` | Servers shared with other companies |
| `region_count` | Cloud regions |
| `city_count` | Cities |
Les cinq acceptent `[min, max]`, et `null` laisse une borne ouverte. Toutes décrivent uniquement cette ligne : un fournisseur dans un pays.
### Date d'apparition
| Key | Example |
| - | - |
| `first_seen_dates` | `["2026-07-01", null]` |
| `last_seen_dates` | `[null, "2026-06-30"]` |
Les deux acceptent `[from, to]` en dates ISO, et `null` ouvre l'une ou l'autre borne. `first_seen_dates` est le filtre d'entrée sur le marché ; `last_seen_dates` répond à la question inverse.
### Hors marché d'origine uniquement
Mettez `is_cross_border_only: true` pour ne garder que la présence hors du marché d'origine. Les entreprises sans siège connu sont exclues plutôt que devinées.
### L'entreprise entière
| Key | Meaning |
| - | - |
| `cloud_footprint_host_count` | Hosts everywhere |
| `cloud_footprint_provider_count` | Distinct providers used |
| `cloud_footprint_country_count` | Countries hosted in |
| `cloud_footprint_cross_border_country_count` | Countries outside the home market |
| `cloud_footprint_providers` | Uses any of these providers |
| `cloud_footprint_primary_provider` | Largest provider is one of these |
Les clés préfixées `cloud_footprint_` décrivent l'entreprise sur l'ensemble de ses lignes, pas la ligne devant vous. Utilisez-les pour qualifier l'entreprise tout en voyant toutes ses lignes.
### Pagination et tri
`per_page`, `page` et `is_ascending_order` se comportent comme sur toute recherche. Les lignes sont triées par `last_seen_at`, les plus récemment observées d'abord.
## À quoi ressemble une ligne
```json theme={null}
{
"cloud_footprint_id": "b8fcf5c3-a309-4052-ae8f-fe5706051617",
"domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee",
"provider": "Azure",
"country_code": "NL",
"company_country_code": "DK",
"is_home_market": false,
"host_count": 437,
"server_count": 8,
"shared_server_count": 0,
"region_count": 1,
"city_count": 0,
"cloud_regions": ["westeurope"],
"cities": null,
"first_seen_at": "2026-07-27T06:59:38.260Z",
"last_seen_at": "2026-09-04T12:43:28.724Z",
"evidence_url": "https://www.pubrio.com/evidence/e458a89952ed1e39e977794327939397",
"companies": {
"domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee",
"company_name": "Wonderful Sound for All - WSA",
"domain": "wsa.com",
"country_code": "DK",
"logo_url": "https://buckets.pubrio.com/company-logo/…"
}
}
```
Il s'agit d'une entreprise danoise qui exploite Azure aux Pays-Bas : `company_country_code` vaut `DK` et `country_code` vaut `NL`, d'où `is_home_market` à `false`. `evidence_url` est une page Pubrio qui étaye la ligne ; elle vaut `null` pour le marché d'origine, qui ne génère pas de signal d'expansion.
## Recettes
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_locations": ["DE"],
"first_seen_dates": ["2026-08-01", null],
"is_cross_border_only": true,
"host_count": [50, null],
"per_page": 25
}'
```
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"providers": ["AWS"],
"target_locations": ["SG", "JP", "IN"],
"server_count": [10, null],
"per_page": 25
}'
```
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"cloud_footprint_country_count": [5, null],
"target_locations": ["DE"],
"host_count": [100, null],
"per_page": 25
}'
```
Le `domain_search_id` de chaque ligne correspond à une entreprise présente dans au moins cinq pays et réellement déployée dans celui-ci.
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"is_cross_border_only": true,
"first_seen_dates": ["2026-08-01", null],
"host_count": [1, 25],
"per_page": 25
}'
```
A small, brand-new footprint in a market the company is not headquartered in — the shape of a proof of concept before it becomes a deployment.
## Vue par entreprise
[Analyse d'empreinte cloud](/fr/api-reference/endpoint/companies/cloud_footprints_insights) prend un `domain_search_id` et renvoie le tableau complet pour cette entreprise : totaux, principaux fournisseurs, pays et régions, série hebdomadaire de nouveaux hôtes, derniers hôtes, et indicateurs pour les hôtes déplacés, les nouveaux clouds, les nouvelles régions et les environnements de test. À utiliser pour une fiche entreprise ; pour bâtir une liste, utilisez la recherche. Voir le [guide Analyse d'empreinte cloud](/fr/developer-guides/search/cloud-footprint-insights).
## Surveiller les changements
Les changements d'empreinte cloud apparaissent comme des signaux d'expansion : un monitor peut donc les pousser vers un webhook ou par e-mail dès qu'ils surviennent. `DNS` est le type de signal d'empreinte cloud :
```json theme={null}
{
"signal_types": ["expansions"],
"signal_filters": [
{ "signal_type": "expansions", "filters": { "tos": ["DE"], "signal_types": ["DNS"], "window_days": 30 } }
]
}
```
Chaque livraison contient `evidence_url`. Le détail brut de l'infrastructure n'est jamais inclus. Voir [Configurer les webhooks](/fr/developer-guides/setting-up-webhooks).
## Bon à savoir
* Une entreprise présente dans deux pays compte dans les deux répartitions : la somme des répartitions peut donc dépasser les totaux. C'est la vérité par marché, pas un double comptage.
* `is_cross_border` vaut `null` quand le siège de l'entreprise est inconnu : cela signifie inconnu, pas national.
* Les plages s'écrivent `[min, max]` et acceptent `null` de chaque côté.
* Depuis la recherche d'entreprises, `cloud_footprint_country_activity` restreint les bornes à un pays (`{"country":"DE","host_count":[100,null]}`) ; le `cloud_footprint_host_count` simple est le total de l'entreprise et ne peut l'exprimer.
## Voir aussi
Tous les paramètres et champs de réponse.
Totaux, classements et indicateurs de changement pour une entreprise.
Trouver des entreprises par leur empreinte cloud dans la recherche d'entreprises.
Pousser les changements d'empreinte cloud vers un webhook ou un e-mail.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.