Expansion-Signale: Ein durchgerechnetes Beispiel

Dieser Durchlauf verfolgt eine einzige Frage — „Welche Unternehmen expandieren gerade ins Vereinigte Königreich, und warum?” — vom Markt-Dashboard bis zu den einzelnen Signalen hinter der Bewegung eines Unternehmens. Jede Anfrage und Antwort unten verwendet die live erfassten Formate der Expansion API.

Das Szenario

Sie verkaufen an Unternehmen, die im Vereinigten Königreich einen Betrieb aufbauen. Sie möchten die aktuellsten Zuzügler sehen und dann verstehen, warum eines von ihnen expandiert, um Ihr Outreach zeitlich passend zu planen.

Schritt 1 — Aktuelle Zuzügler ins UK finden

Setzen Sie tos: ["GB"], um jedes Unternehmen zu finden, das ins UK expandiert, plus einen Freshness-Filter, damit Sie nur Unternehmen sehen, die gerade aktiv ankommen.

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

Die Antwort fasst den Markt zusammen und listet die dorthin expandierenden Unternehmen auf:

{
  "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 }
      }
    ]
  }
}

Sortieren Sie nach expansion_score, um die entschlossensten Bewegungen zuerst anzuzeigen. Hier befindet sich ein chinesisches Unternehmen (home_country_code: "CN") in der Stufe Expanding (expanding) im UK mit einer fortschreitenden Trajektorie — eine starke, frische Zuzugsbewegung.

Rangierte Liste von Unternehmen, die in einen Markt expandieren, jeweils mit Stufe, Momentum-Pfeil, Aktualität und Signalanzahl — Dieselbe rangierte Liste, im Produkt — Stufe, Momentum und Aktualität auf einen Blick, für jedes Unternehmen, das Ihren Filtern entspricht.

Schritt 2 — Die vollständige Marktlandkarte des Unternehmens ansehen

Nehmen Sie die domain_search_id und listen Sie jeden Markt auf, in den das Unternehmen expandiert.

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 }
  ]
}

Das Unternehmen expandiert ins UK und bindet Ressourcen in Deutschland — nützlicher Kontext, um die richtige Region zu priorisieren.

Die Märkte eines einzelnen Unternehmens auf einer Weltkarte eingezeichnet, eingefärbt nach Stufe, mit Stufen-Legende und Feed der jüngsten Aktivität — Ein Unternehmen, jeder Markt, in den es vordringt, eingezeichnet — dieselben zwei Zeilen, die das JSON oben beschrieben hat.

Schritt 3 — Die UK-Bewegung im Detail verstehen

Tauchen Sie in die Unternehmens- und Marktdetails ein, um die aktuelle Stufe, die zugrunde liegenden Signale, die bekannte Präsenz und die Übergangs-Timeline zu sehen.

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" }
  ]
}

Die Stufe Expanding wird durch eine leitende UK-Neueinstellung und ein Büro in London belegt — konkrete Evidenz, keine Vermutung.

Schritt 4 — Die einzelnen Ereignisse lesen

Für die vollständige, paginierte Liste der Ereignisse hinter der Bewegung rufen Sie den Signal-Event-Endpunkt mit den Signaltypen auf, die Sie interessieren.

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"
      }
    ]
  }
}

Nutzen Sie total_pages, um eine „Mehr laden”-Steuerung anzutreiben, indem Sie page erhöhen, bis sie total_pages erreicht.

Feed einzelner Expansion-Signale für ein Unternehmen in einem Markt, jeweils mit Signaltyp, Beleg-Link und Datum — Die Ereignisse selbst, jeweils mit ihrem Beleg — ein erkannter Cloud-Fußabdruck, eine Führungskräfte-Einstellung, eine Serie geo-gezielter Anzeigen.

Was Sie gerade getan haben

Sie sind von einem Markt → einer nach Rang sortierten Liste von Bewegungen → dem vollständigen Fußabdruck eines Unternehmens → den genauen Signalen hinter dessen UK-Expansion gegangen. Das ist die Kernschleife der Expansion API: breit beginnen, auf ein Unternehmen eingrenzen, dann die Evidenz lesen.

Die Expansion API verwenden

Authentifizierung, Paginierung und Ihre ersten Aufrufe.

Wie Expansion-Signale funktionieren

Der vollständige Katalog der oben verwendeten Werte.

Wissensdatenbank

Anleitungen

Konzepte

Fallstudien

Expansion-Signale: Ein durchgerechnetes Beispiel

Das Szenario

Schritt 1 — Aktuelle Zuzügler ins UK finden

Schritt 2 — Die vollständige Marktlandkarte des Unternehmens ansehen

Schritt 3 — Die UK-Bewegung im Detail verstehen

Schritt 4 — Die einzelnen Ereignisse lesen

Was Sie gerade getan haben

Die Expansion API verwenden

Wie Expansion-Signale funktionieren

​Das Szenario

​Schritt 1 — Aktuelle Zuzügler ins UK finden

​Schritt 2 — Die vollständige Marktlandkarte des Unternehmens ansehen

​Schritt 3 — Die UK-Bewegung im Detail verstehen

​Schritt 4 — Die einzelnen Ereignisse lesen

​Was Sie gerade getan haben

Die Expansion API verwenden

Wie Expansion-Signale funktionieren

Das Szenario

Schritt 1 — Aktuelle Zuzügler ins UK finden

Schritt 2 — Die vollständige Marktlandkarte des Unternehmens ansehen

Schritt 3 — Die UK-Bewegung im Detail verstehen

Schritt 4 — Die einzelnen Ereignisse lesen

Was Sie gerade getan haben