Skip to main content
POST
Détail d'expansion d'entreprise

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
domain_search_id
string<uuid>
requis

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

country_code
string

Marché cible sous forme de code pays ISO 3166-1 alpha-2 (cca2). Omettez pour sélectionner automatiquement le marché le plus actif de l'entreprise ; définissez is_all_markets pour une vue transversale de tous les marchés.

Exemple:

"US"

is_all_markets
boolean

Renvoie l'intégralité de l'empreinte d'expansion de l'entreprise sur TOUS les marchés en un seul appel, plutôt qu'un seul marché. Lorsque true, country_code est ignoré, le marché domestique est exclu des agrégats de signaux lorsqu'il peut être identifié, data devient un agrégat au niveau de l'entreprise (étape dominante, total des signaux, étendue des dates, meilleur score d'expansion), et markets_summary liste tous les marchés. Par défaut à false.

Exemple:

false

signal_type
enum<string>

Filtrer les signaux renvoyés à un seul type.

Options disponibles:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Exemple:

"EXEC"

query
string

Description en langage naturel de ce que vous vendez, ou du profil acheteur par rapport auquel vous évaluez cette entreprise. Utilisé uniquement pour ancrer le summary généré par IA (voir is_explain_match) ; contrairement à la recherche d'entreprises, ceci n'est PAS interprété en filtres ici.

Exemple:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

Si true et qu'une query est fournie, summary renvoie un unique résumé généré par IA de l'activité d'expansion de cette entreprise dans la portée actuelle (le marché sélectionné, ou tous les marchés étrangers quand is_all_markets est true), lu en fonction de votre query et ancré dans les signaux réels de l'entreprise avec des citations [n].

Exemple:

true

window_days
integer
défaut:90

Optionnel. Fenêtre glissante (en jours) qui borne le flux du summary généré par IA. Par défaut sur 90 quand ni ceci ni transitioned_dates n'est fourni. N'affecte pas la liste paginée signals (historique complet).

Exemple:

90

transitioned_dates
string<date>[]

Plage de dates ISO [from, to] pour la fenêtre de signal/transition. Prime sur window_days lorsque les deux sont fournis.

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"

linkedin_url
string

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

Exemple:

"https://www.linkedin.com/company/pubrio"

is_include_established
boolean

Inclut l'étape established (acteurs établis de longue date sans signaux d'expansion actifs). Par défaut à false.

Exemple:

false

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

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

is_include_metadata
boolean

Renvoie la charge utile de détail complète. Le trafic par clé API est allégé par défaut : le bloc model, les chiffres de confiance (stage.confidence sur Company Expansion Detail, confidence_score sur other_markets[] et sur markers[] de Rankings) et les champs established_min / share_of_detected / has_known_office sont tous omis sauf si ceci est true.

Exemple:

true

summary_only
boolean

Renvoie uniquement le bloc de résumé d'étape (data, company, markets_summary, signal_weekly_totals, recent_signals, expansion_score, summary) et ignore la liste de signaux et ses agrégats. Beaucoup plus économique pour les vues d'en-tête.

Exemple:

true

markets_summary_full
boolean

Inclut l'ensemble complet des marchés classés en tant que markets_summary, aux côtés de la liste plafonnée other_markets.

Exemple:

true

Réponse

Détail entreprise sur le marché.

metadata
object
data
object

Conteneur de résultat.

signals
object[]

Les lignes de signal paginées derrière cette paire entreprise/marché — la liste des preuves. La taille de page et les totaux proviennent de metadata.pagination.

summary
object

Résumé d'étape en une ligne pour la paire. Première page uniquement.

company
object

Habillage entreprise — nom, domaine, logo et URLs sociales. Première page uniquement.

signal_group_totals
object[]

Comptages de signaux par type, regroupés par jour dans votre fuseau horaire. Première page uniquement.

signal_type_totals
object[]

Totaux de signaux depuis toujours par type de signal. Première page uniquement.

signal_type_recent_totals
object[]

Totaux de signaux par type sur les 12 dernières semaines glissantes. Première page uniquement.

signal_weekly_totals
object[]

Comptages de signaux hebdomadaires pour la carte de chaleur, même fenêtre que signal_type_recent_totals. Première page uniquement.

evidence_breakdown
object

Agrégat de preuves par type de source, calculé à partir des signaux renvoyés (expurgés). Première page uniquement.

presence
object

Présence physique et numérique observée pour l'entreprise sur ce marché. Première page uniquement.

suppressions
object[]

Signaux supprimés du calcul de l'étape, avec la raison de chacun. Première page uniquement.

timeline
object[]

Historique des transitions d'étape pour ce couple entreprise/marché. Première page uniquement.

other_markets
object[]

Les autres marchés actifs de l'entreprise. Plafonné sur les forfaits limités — voir other_markets_locked_count. Première page uniquement.

other_markets_locked_count
integer

Nombre de marchés supplémentaires que votre forfait n'a pas renvoyés dans other_markets. 0 si rien n'a été omis.

markets_summary
object[]

Ensemble complet et classé des marchés pour cette entreprise. Renvoyé uniquement lorsque markets_summary_full vaut true, sur la première page.

Dernière modification le 4 septembre 2026