Skip to main content
POST
Rechercher l'empreinte cloud des entreprises

Autorisations

pubrio-api-key
string
header
requis

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.

Corps

application/json
providers
string[]

Ne conserver que les lignes correspondant à ces fournisseurs cloud ou d'hébergement. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
exclude_providers
string[]

Exclure les lignes correspondant à ces fournisseurs cloud ou d'hébergement. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
target_locations
string[]

Codes pays que les résultats doivent cibler. Combiné par défaut à filter_conditions en OR : il suffit qu'un seul corresponde.

Exemple:
exclude_target_locations
string[]

Codes pays que les résultats ne doivent pas cibler. Combiné par défaut à filter_conditions en OR : il suffit qu'un seul corresponde.

Exemple:
cloud_regions
string[]

Ne conserver que les lignes correspondant à ces régions cloud. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
exclude_cloud_regions
string[]

Exclure les lignes correspondant à ces régions cloud. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
cities
string[]

Ne conserver que les lignes correspondant à ces villes. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
exclude_cities
string[]

Exclure les lignes correspondant à ces villes. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
first_seen_dates
(string | null)[]

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.

Required array length: 2 elements
Exemple:
last_seen_dates
(string | null)[]

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.

Required array length: 2 elements
Exemple:
is_cross_border_only
boolean

Si true, ne renvoie que les lignes hors du marché d'origine de l'entreprise. Les entreprises sans siège connu sont exclues.

Exemple:

true

host_count
(integer | null)[]

Minimum et maximum de hôtes. Utilisez null pour laisser une borne ouverte. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Required array length: 2 elements
Exemple:
server_count
(integer | null)[]

Minimum et maximum de serveurs (IP distinctes). Utilisez null pour laisser une borne ouverte. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Required array length: 2 elements
Exemple:
shared_server_count
(integer | null)[]

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.

Required array length: 2 elements
Exemple:
region_count
(integer | null)[]

Minimum et maximum de régions cloud. Utilisez null pour laisser une borne ouverte. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Required array length: 2 elements
Exemple:
city_count
(integer | null)[]

Minimum et maximum de villes. Utilisez null pour laisser une borne ouverte. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Required array length: 2 elements
Exemple:
cloud_footprint_host_count
(integer | null)[]

Minimum et maximum de hôtes. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_server_count
(integer | null)[]

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.

Required array length: 2 elements
Exemple:
cloud_footprint_shared_server_count
(integer | null)[]

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.

Required array length: 2 elements
Exemple:
cloud_footprint_provider_count
(integer | null)[]

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.

Required array length: 2 elements
Exemple:
cloud_footprint_country_count
(integer | null)[]

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.

Required array length: 2 elements
Exemple:
cloud_footprint_cross_border_country_count
(integer | null)[]

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.

Required array length: 2 elements
Exemple:
cloud_footprint_region_count
(integer | null)[]

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.

Required array length: 2 elements
Exemple:
cloud_footprint_city_count
(integer | null)[]

Minimum et maximum de villes. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
company_locations
string[]

L'emplacement du siège social de l'entreprise. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:
cloud_footprint_id
string<uuid>

Identifiant d'une ligne d'empreinte cloud.

Exemple:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

cloud_footprint_ids
string<uuid>[]

Identifiants de lignes précises, pour exporter une sélection.

Exemple:
companies
string<uuid>[]

Une liste d'identifiants uniques (domain_search_id) utilisée pour les opérations de recherche d'entreprises et de personnes.

domains
string[]

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.

Exemple:
per_page
integer
défaut:25

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

Plage requise: x <= 25
Exemple:

25

page
integer
défaut:1

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. Le dépasser renvoie HTTP 416.

Exemple:

1

is_ascending_order
boolean
défaut:false

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.

Exemple:

false

cloud_footprint_providers
string[]

Entreprises utilisant l'un de ces fournisseurs où que ce soit. providers sans préfixe restreint les lignes ; celui-ci restreint les entreprises.

Exemple:
cloud_footprint_target_locations
string[]

Entreprises présentes dans l'un de ces pays, où que ce soit dans leur empreinte.

Exemple:
cloud_footprint_primary_provider
string[]

Entreprises dont le principal fournisseur est l'un de ceux-ci.

Exemple:
domain
string

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.

Exemple:

"pubrio.com"

domain_search_id
string<uuid>

Un identifiant unique pour l'opération de recherche d'entreprise.

linkedin_urls
string[]

L'URL complète du profil d'entreprise LinkedIn. L'URL commence par http et contient linkedin.com/company/

Exemple:
filter_conditions
object[]

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.

Réponse

Lignes d'empreinte cloud paginées.

The response is of type object.

Dernière modification le 4 septembre 2026