Signaux d'expansion : un exemple concret

Ce parcours suit une seule question — « Quelles entreprises s’étendent actuellement vers le Royaume-Uni, et pourquoi ? » — depuis le tableau de bord de marché jusqu’aux signaux individuels derrière le mouvement d’une entreprise. Chaque requête et réponse ci-dessous utilise les formats en direct de l’Expansion API.

Le scénario

Vous vendez à des entreprises qui s’implantent au Royaume-Uni. Vous voulez repérer les mouvements entrants les plus récents, puis comprendre pourquoi l’une de ces entreprises s’étend, afin de bien synchroniser votre approche commerciale.

Étape 1 — Repérer les mouvements entrants récents vers le Royaume-Uni

Définissez tos: ["GB"] pour trouver chaque entreprise s’étendant vers le Royaume-Uni, ainsi qu’un filtre de fraîcheur pour ne voir que les entreprises activement en train d’arriver.

POST /expansions/search
{
  "tos": ["GB"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}

La réponse résume le marché et liste les entreprises qui s’y étendent :

{
  "metadata": {
    "filters": { "tos": ["GB"], "freshness": ["fresh", "cooling"] },
    "aggregate": { "total_companies_with_signals": 64, "committing_count": 22, "expanding_count": 15 },
    "top_origins": [{ "home_country_code": "CN", "company_count": 18 }],
    "top_industries": [{ "industry": "Consumer Electronics", "count": 9 }]
  },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 64, "total_pages": 3 },
    "companies": [
      {
        "expansion_id": "6845525",
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "company_name": "Example Corp",
        "domain": "example.com",
        "home_country_code": "CN",
        "country_code": "GB",
        "industry": "Consumer Electronics",
        "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 7 }
      }
    ]
  }
}

Triez par expansion_score pour faire remonter les mouvements les plus décisifs. Ici, une entreprise basée en Chine (home_country_code: "CN") est à l’étape Expansion (expanding) au Royaume-Uni, avec une trajectoire advancing — un mouvement entrant fort et récent.

Liste classée d'entreprises s'implantant sur un marché, chacune affichant son étape, sa flèche de dynamique, sa fraîcheur et son nombre de signaux — La même liste classée, dans le produit — étape, dynamique et fraîcheur en un coup d'œil, pour chaque entreprise correspondant à vos filtres.

Étape 2 — Consulter la carte de marché complète de l’entreprise

Prenez le domain_search_id et listez chaque marché sur lequel cette entreprise s’étend.

POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "is_all_markets": true }

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "home_country_code": "US" },
  "data": { "market_count": 2, "dominant_stage_slug": "expanding", "total_signal_count": 194 },
  "markets_summary": [
    { "country_code": "GB", "stage_slug": "expanding", "is_home_market": false, "signal_count": 140, "distinct_type_count": 6, "latest_signal_at": "2026-07-08T02:42:23.544Z", "rank_now": 1 },
    { "country_code": "DE", "stage_slug": "committing", "is_home_market": false, "signal_count": 54, "distinct_type_count": 3, "latest_signal_at": "2026-06-20T00:00:00.000Z", "rank_now": 2 }
  ]
}

L’entreprise s’étend au Royaume-Uni et engage des ressources en Allemagne — un contexte utile pour prioriser la bonne région.

Les marchés d'une seule entreprise représentés sur une carte du monde, colorés par étape, avec une légende des étapes et un flux d'activité récente — Une seule entreprise, tous les marchés qu'elle investit, représentés — les deux mêmes lignes que le JSON ci-dessus décrivait.

Étape 3 — Comprendre le mouvement au Royaume-Uni en détail

Approfondissez le détail entreprise-et-marché pour voir l’étape actuelle, les signaux sous-jacents, la présence connue, et la chronologie des transitions.

POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB" }

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB" },
  "data": {
    "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
    "country_code": "GB",
    "country_name": "United Kingdom",
    "stage_rank": 3,
    "stage_name": "Expanding",
    "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 27 }
  },
  "signals": [
    {
      "signal_type_slug": "EXEC",
      "display_label": "Hired Regional VP for UK & Ireland",
      "polarity": "expansion",
      "event_date": "2026-06-20T14:00:00.000Z"
    }
  ],
  "presence": [
    { "presence_type": "office", "address": "London, UK", "known_since": "2026-03-15T00:00:00.000Z" }
  ]
}

L’étape Expansion s’appuie sur une embauche senior au Royaume-Uni et un bureau à Londres — une preuve concrète, pas une supposition.

Étape 4 — Lire les événements individuels

Pour obtenir la liste complète et paginée des événements à l’origine du mouvement, appelez le point de terminaison des événements de signal avec les types de signaux qui vous intéressent.

POST /expansions/companies/pulse_events
{
  "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
  "signal_types": ["HIRE", "EXEC"],
  "window_days": 90,
  "page": 1
}

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002" },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 42, "total_pages": 2, "total_display_pages": 2, "is_timeout": false },
    "events": [
      {
        "signal_type_slug": "EXEC",
        "country_code": "GB",
        "display_label": "Hired Regional VP for UK & Ireland",
        "evidence_url": "https://www.linkedin.com/company/example-corp",
        "event_date": "2026-06-20T14:00:00.000Z"
      }
    ]
  }
}

Utilisez total_pages pour piloter un contrôle « charger plus » en incrémentant page jusqu’à atteindre total_pages.

Flux de signaux d'expansion individuels pour une entreprise sur un marché, chacun avec un type de signal, un lien de preuve et une date — Les événements eux-mêmes, chacun avec sa preuve — une empreinte cloud détectée, une embauche de dirigeant, une série de publicités géociblées.

Ce que vous venez de faire

Vous êtes passé de un marché → une liste classée de mouvements → l’empreinte complète d’une entreprise → les signaux exacts derrière son expansion au Royaume-Uni. C’est la boucle centrale de l’Expansion API : commencer large, restreindre à une entreprise, puis lire les preuves.

Utiliser l'Expansion API

Authentification, pagination, et vos premiers appels.

Comment fonctionnent les signaux d'expansion

Le catalogue complet des valeurs utilisées ci-dessus.

Base de connaissances

Guides

Concepts

Études de cas

Signaux d'expansion : un exemple concret

Le scénario

Étape 1 — Repérer les mouvements entrants récents vers le Royaume-Uni

Étape 2 — Consulter la carte de marché complète de l’entreprise

Étape 3 — Comprendre le mouvement au Royaume-Uni en détail

Étape 4 — Lire les événements individuels

Ce que vous venez de faire

Utiliser l'Expansion API

Comment fonctionnent les signaux d'expansion

​Le scénario

​Étape 1 — Repérer les mouvements entrants récents vers le Royaume-Uni

​Étape 2 — Consulter la carte de marché complète de l’entreprise

​Étape 3 — Comprendre le mouvement au Royaume-Uni en détail

​Étape 4 — Lire les événements individuels

​Ce que vous venez de faire

Utiliser l'Expansion API

Comment fonctionnent les signaux d'expansion

Le scénario

Étape 1 — Repérer les mouvements entrants récents vers le Royaume-Uni

Étape 2 — Consulter la carte de marché complète de l’entreprise

Étape 3 — Comprendre le mouvement au Royaume-Uni en détail

Étape 4 — Lire les événements individuels

Ce que vous venez de faire