Skip to main content
Ce guide de démarrage rapide vous amène de zéro à la lecture de signaux d’expansion en direct en quelques appels. Il suppose que vous disposez déjà d’une clé API Pubrio — voir Authentification pour en créer une.

​
Prérequis

  • Une clé API Pubrio (voir Authentification).
  • Le domain_search_id d’une entreprise. Vous pouvez en obtenir un via le point de terminaison Company Search.
Tous les points de terminaison Expansion sont en POST et acceptent un corps JSON. Incluez vos identifiants sur chaque requête comme décrit dans Authentification.

​
Étape 1 — Consulter l’expansion d’une entreprise

Commencez par une seule entreprise et listez chaque marché sur lequel elle s’étend.

​
Étape 2 — Lire le résultat

Chaque entrée de markets_summary décrit un marché sur lequel l’entreprise est active :
  • stage_slug — jusqu’où l’entreprise a progressé sur ce marché (exploring → scaling).
  • signal_count / distinct_type_count — combien de preuves étayent le marché, sur combien de types de signaux.
  • latest_signal_at — l’ancienneté du signal le plus récent.
  • signal_velocity_30d / signal_velocity_90d — la vitesse à laquelle l’activité s’accélère.
  • rank_now — le rang actuel du marché pour cette entreprise (1 = le plus fort).
  • is_home_market — s’il s’agit du pays du siège de l’entreprise.
Pour faire ressortir les mouvements les plus récents ou filtrer par trajectoire, utilisez les points de terminaison de découverte (freshness, momentum) présentés ensuite.

​
Étape 3 — Explorer un marché entier

Pour travailler par marché plutôt que par entreprise, utilisez Expansion Market Detail. Il est paginé avec les paramètres standards page / per_page. La géographie est une relation orientée de → vers, exprimée par deux listes : froms (marchés d’origine / siège) et tos (marchés cibles). Choisissez le motif correspondant à votre question :
Lisez metadata.pagination pour parcourir les résultats page par page :
Demandez la page suivante en incrémentant page. per_page est plafonné selon votre plan — demander explicitement plus que votre plafond renvoie une erreur plutôt que de tronquer silencieusement. Deux valeurs par défaut à connaître :
  • Ordre — les résultats reviennent dans l’ordre de pertinence (entreprises corroborées par plusieurs types de signaux en premier, puis les plus récentes). Passez sort_by: "recent" pour une pure récence, ou expansion_score / signal_count / company_ranking.
  • Réponses allégées — les réponses par clé API omettent par défaut l’agrégat de marché (metadata.aggregate, principales origines/destinations, chronologie) et le détail du modèle. Passez is_include_metadata: true pour les obtenir.

​
Étape 4 — Explorer les preuves en détail

Lorsque vous voulez les signaux individuels derrière le mouvement d’une entreprise, appelez Company Signal Events.
Ce point de terminaison renvoie total_entries et total_pages — demandez les pages 1 à total_pages (c’est-à-dire continuez tant que page < total_pages).

​
Référence de filtrage

La plupart des points de terminaison Expansion acceptent ces filtres. Leurs valeurs valides sont listées dans How Expansion Signals Work : Le filtre companies accepte n’importe quel mélange de types d’identifiants — pas besoin de les résoudre en identifiants au préalable :
Ne confondez pas flux et trajectoire. Le flux (la direction du mouvement entre marchés) est défini par froms / tos — il n’existe pas de filtre de requête direction. La trajectoire (comment le mouvement progresse) est le filtre momentum, et elle apparaît dans les réponses sous le champ direction.

​
Étapes suivantes

Exemple concret

Le parcours complet du marché au signal.

Points de terminaison Expansion

Parcourez tous les points de terminaison de l’Expansion API.