Skip to main content
L’API Expansion est un ensemble restreint de points de terminaison, chacun répondant à une question différente sur la manière dont les entreprises se développent sur de nouveaux marchés. Ce guide fait correspondre ce que vous voulez faire avec le point de terminaison à appeler, afin que vous n’ayez jamais à deviner.
Nouveau sur les concepts (étapes, signaux, dynamique, fraîcheur) ? Commencez par Que sont les signaux d’expansion ? — ce guide suppose que vous les connaissez déjà et se concentre sur le choix du point de terminaison.

Choisir par tâche

Les points de terminaison en un coup d’œil

Expansion Search

Le point de terminaison de découverte. Filtrez les entreprises par étape d’expansion, fraîcheur, marché, et l’ensemble complet des données firmographiques — ou passez une query en langage naturel. Liste d’entreprises paginée.

Expansion Overview

Agrégats au niveau du marché : comptes par étape, principaux flux transfrontaliers, activité des entreprises suivies. Pas de pagination — un instantané de dashboard.

Company Expansion Detail

Une entreprise sur un marché : étape actuelle, score, présence, historique de transitions et signaux à l’appui. L’instantané par marché.

Company Signal Events

Le flux enrichi et paginé des événements de signal d’une entreprise, à travers les types de signal et une fenêtre de dates. Le détail de l’activité.

Compare Company Expansions

Plusieurs entreprises côte à côte en un seul appel, avec des séries de signaux hebdomadaires et un choix optionnel de pairs. Conçu pour les grilles de comparaison.

Batch Company Expansion Summaries

N’importe quel mélange de domain_search_id, de domaine ou d’URL LinkedIn, résolu et renvoyé avec les mêmes données que Compare, plus un bloc de résumé calculé — pas d’entreprise cible, pas de choix de pairs.

Expansion Rankings

Une liste légère, classée par score, de paires entreprise/marché — champs minimaux, pas de pagination — pour un rendu rapide de cartes et de heatmaps.

Expansion Signal Search

Interrogez directement les lignes de signal — type, sous-type, force, polarité, événement daté, source et URL de preuve — à travers les entreprises et les marchés. Paginé, filtrable, sans agrégation par entreprise.

« Detail » contre « Signal Events » — lequel choisir ?

C’est la source de confusion la plus fréquente, car les deux impliquent des signaux. La différence tient à l’instantané contre le flux :
La plupart des intégrations n’ont besoin que de Company Expansion Detail — il renvoie déjà les signaux derrière l’étape d’une entreprise sur un marché. Utilisez Company Signal Events lorsque vous voulez spécifiquement le flux d’événements riche, filtrable et fenêtré dans le temps (par exemple pour construire une interface de chronologie d’activité).

« Compare » contre « Summaries » — lequel choisir ?

Les deux renvoient les mêmes données d’expansion par entreprise, côte à côte. La différence tient aux identifiants et au cadrage :
Vous construisez une grille de benchmarking concurrentiel autour d’une entreprise cible ? Utilisez Compare avec seed_target pour sélectionner automatiquement des pairs. Vous avez déjà un ensemble d’entreprises (une liste de surveillance, un import CRM, une liste de domaines) et voulez simplement les chiffres ? Utilisez Batch Company Expansion Summaries — cela vous évite de réimplémenter le calcul de dynamique/score côté client.

Compare Company Expansions, présenté sous forme de grille — marchés, dynamique, score d'expansion et principales nouvelles entrées, côte à côte.

Un flux de travail typique

Découvrir

Appelez Expansion Search avec vos filtres (ou une query en langage naturel) pour obtenir les entreprises qui s’implantent sur votre marché cible. Réglez is_explain_match: true pour des résumés IA « pourquoi ça correspond ».

Approfondir sur une entreprise

Prenez un domain_search_id dans les résultats et appelez Company Expansion Detail pour la lecture complète sur un marché — étape, présence, historique et signaux.

Voir le flux d'activité (optionnel)

Pour le flux d’événements riche et fenêtré, appelez Company Signal Events avec les types de signal et la plage de dates qui vous intéressent.

Comparer ou cartographier

Utilisez Compare Company Expansions pour une grille côte à côte à partir d’une entreprise cible, Batch Company Expansion Summaries lorsque vous avez déjà un ensemble d’entreprises et voulez des métriques prêtes à l’emploi, ou Expansion Rankings pour tracer des points classés sur une carte.

Filtres partagés

Les points de terminaison de découverte (Expansion Search, Expansion Overview, Expansion Rankings) acceptent le même vocabulaire de filtres — filtres d’expansion (étape, dynamique, fraîcheur, portée, types de signal), la paire de géographie orientée (froms / tos), et l’ensemble complet des données firmographiques d’entreprise (secteur, technologies, taille d’effectif, chiffre d’affaires, listes enregistrées). Apprenez les filtres une seule fois dans la Vue d’ensemble des filtres ; les valeurs valides se trouvent dans Expansion Reference et le catalogue How Expansion Signals Work.

Utiliser l'API Expansion

Authentification, vos premiers appels, pagination et lecture des scores.

Exemple détaillé

Un tutoriel complet, du marché au signal.
Dernière modification le 4 septembre 2026