Recherche d'empreinte cloud

Recherche d’empreinte cloud 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.

cURL

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

{
  "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

Qui vient d'arriver en Allemagne
Gros utilisateurs d'AWS en Asie
Entreprises présentes sur de nombreux marchés
Pilots worth a call

cURL

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
  }'

cURL

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
  }'

cURL

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.

cURL

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

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 :

{
  "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.

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

Référence Recherche d'empreinte cloud

Tous les paramètres et champs de réponse.

Analyse d'empreinte cloud

Totaux, classements et indicateurs de changement pour une entreprise.

Filtres d'empreinte cloud

Trouver des entreprises par leur empreinte cloud dans la recherche d’entreprises.

Configurer les webhooks

Pousser les changements d’empreinte cloud vers un webhook ou un e-mail.

Monitor

Recherche

Filtres

Personnes

Expansion

Quand l’utiliser

Restreindre à une entreprise

Filtres

Fournisseur, région et ville

Où se trouve l’infrastructure

Taille

Date d’apparition

Hors marché d’origine uniquement

L’entreprise entière

À quoi ressemble une ligne

Recettes

Vue par entreprise

Surveiller les changements

Bon à savoir

Voir aussi

Référence Recherche d'empreinte cloud

Analyse d'empreinte cloud

Filtres d'empreinte cloud

Configurer les webhooks

​Quand l’utiliser

​Restreindre à une entreprise

​Filtres

​Fournisseur, région et ville

​Où se trouve l’infrastructure

​Taille

​Date d’apparition

​Hors marché d’origine uniquement

​L’entreprise entière

​Pagination et tri

​À quoi ressemble une ligne

​Recettes

​Vue par entreprise

​Surveiller les changements

​Bon à savoir

​Voir aussi

Référence Recherche d'empreinte cloud

Analyse d'empreinte cloud

Filtres d'empreinte cloud

Configurer les webhooks

Quand l’utiliser

Restreindre à une entreprise

Filtres

Fournisseur, région et ville

Où se trouve l’infrastructure

Taille

Date d’apparition

Hors marché d’origine uniquement

L’entreprise entière

Pagination et tri

À quoi ressemble une ligne

Recettes

Vue par entreprise

Surveiller les changements

Bon à savoir

Voir aussi