> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Choisir un point de terminaison d'expansion
> Un guide tâche-vers-point de terminaison pour l'API Expansion — quel point de terminaison appeler pour la découverte, le détail d'entreprise, le flux de signaux, la comparaison, les cartes et les valeurs de référence.
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 ?](/fr/knowledge-base/concepts/expansion-signals) — ce guide suppose que vous les connaissez déjà et se concentre sur le choix du point de terminaison.
## Choisir par tâche
| Vous voulez… | Appelez |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Trouver des entreprises** qui s'implantent sur un marché (par filtres ou requête en langage naturel) | [Expansion Search](/fr/api-reference/endpoint/expansions/market_lookup) |
| Voir les **KPI et flux au niveau du marché** (comptes par étape, principaux corridors) | [Expansion Overview](/fr/api-reference/endpoint/expansions/dashboard) |
| Obtenir le **statut d'une entreprise sur un marché** — étape, présence, historique et les signaux qui les sous-tendent | [Company Expansion Detail](/fr/api-reference/endpoint/expansions/company_lookup) |
| Obtenir le **flux enrichi et fenêtré dans le temps** des événements de signal d'une entreprise | [Company Signal Events](/fr/api-reference/endpoint/expansions/company_pulse_events) |
| **Comparer** l'expansion de plusieurs entreprises côte à côte, à partir d'une entreprise cible | [Compare Company Expansions](/fr/api-reference/endpoint/expansions/company_compare) |
| Obtenir des **métriques de comparaison prêtes à afficher** (marchés, dynamique, score d'expansion) pour un ensemble d'entreprises que vous avez déjà — par domaine, URL LinkedIn ou id | [Batch Company Expansion Summaries](/fr/api-reference/endpoint/expansions/company_summaries) |
| Tracer des **points d'entreprise/marché classés** sur une carte ou une heatmap | [Expansion Rankings](/fr/api-reference/endpoint/expansions/company_markers) |
| Lire les **lignes de signal brutes** derrière une étape — auditer les preuves, ou construire votre propre notation | [Expansion Signal Search](/fr/api-reference/endpoint/expansions/signal_search) |
| Résoudre les **valeurs de filtre et d'énumération** (étapes, types de signal, fraîcheur…) | [Expansion Reference](/fr/api-reference/endpoint/expansions/types) |
## Les points de terminaison en un coup d'œil
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.
Agrégats au niveau du marché : comptes par étape, principaux flux transfrontaliers, activité des entreprises suivies. Pas de pagination — un instantané de dashboard.
Une entreprise sur un marché : étape actuelle, score, présence, historique de transitions et signaux à l'appui. L'instantané par marché.
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é.
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.
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.
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.
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* :
| | Company Expansion Detail | Company Signal Events |
| -------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Portée** | une entreprise × **un marché** | une entreprise, sur **tous ses marchés étrangers** |
| **Marchés** | un **marché unique** via `country_code`, ou l'entreprise entière en une fois via `is_all_markets` | **tous les marchés étrangers** par défaut (marché domestique exclu) ; restreignez à des marchés spécifiques avec `country_codes` (tableau) |
| **Renvoie** | étape, score, présence, historique **+ signaux à l'appui** | **événements de signal enrichis** (URL de preuve, effectifs recrutés, libellés) |
| **Temps** | situation actuelle | une **fenêtre de dates** de votre choix (`window_days` — par défaut 90 — ou `transitioned_dates`) |
| **Forme** | un objet instantané structuré | un flux d'événements paginé (« charger plus ») |
| **À utiliser quand** | « Quel est le statut de cette entreprise sur **un** marché, et pourquoi ? » | « Montrez-moi le flux complet à travers **chaque** marché qui pilote l'expansion de cette entreprise » |
**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* :
| | Compare Company Expansions | Batch Company Expansion Summaries |
| ----------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Entrée** | tout mélange de `domain_search_id`, `domain` ou `linkedin_url` | tout mélange de `domain_search_id`, `domain` ou `linkedin_url` |
| **Choix de pairs** | optionnel, via `seed_target` | aucun — chaque entreprise est indépendante |
| **Agrégation calculée** | aucune (calculez vous-même marchés/dynamique/score) | bloc `summary` inclus par entreprise (marchés actifs/nouveaux, dynamique, score d'expansion, répartition des étapes) |
| **À utiliser quand** | vous avez déjà des id résolus et voulez choisir des pairs comparables pour une cible | on vous donne des entreprises par domaine ou URL LinkedIn et vous voulez des métriques de comparaison prêtes à afficher en un seul appel |
**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.
## Un flux de travail typique
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 ».
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.
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.
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](/fr/developer-guides/filters/overview) ; les valeurs valides se trouvent dans [Expansion Reference](/fr/api-reference/endpoint/expansions/types) et le catalogue [How Expansion Signals Work](/fr/knowledge-base/concepts/how-expansion-signals-work).
Authentification, vos premiers appels, pagination et lecture des scores.
Un tutoriel complet, du marché au signal.