Skip to main content
Die Expansion API besteht aus einer kleinen Menge von Endpunkten, von denen jeder eine andere Frage darüber beantwortet, wie Unternehmen in neue Märkte hineinwachsen. Diese Anleitung ordnet was Sie tun möchten dem aufzurufenden Endpunkt zu, damit Sie nie raten müssen.
Neu bei den Konzepten (Phasen, Signale, Momentum, Aktualität)? Beginnen Sie mit What Are Expansion Signals? — diese Anleitung setzt diese Kenntnisse voraus und konzentriert sich auf die Endpunktauswahl.

Nach Aufgabe auswählen

Die Endpunkte im Überblick

Expansion Search

Der Discovery-Endpunkt. Filtert Unternehmen nach Expansionsphase, Aktualität, Markt und der vollständigen firmografischen Suite — oder übergibt eine Freitext-query. Paginierte Unternehmensliste.

Expansion Overview

Aggregierte Marktdaten: Anzahl je Phase, wichtigste grenzüberschreitende Ströme, Aktivität beobachteter Unternehmen. Keine Paginierung — eine Dashboard-Momentaufnahme.

Company Expansion Detail

Ein Unternehmen in einem Markt: aktuelle Phase, Score, Präsenz, Übergangsverlauf und die stützenden Signale. Die marktbezogene Momentaufnahme.

Company Signal Events

Der angereicherte, paginierte Feed der Signalereignisse eines Unternehmens über Signaltypen und ein Datumsfenster hinweg. Der Aktivitäts-Drilldown.

Compare Company Expansions

Mehrere Unternehmen nebeneinander in einem Aufruf, mit wöchentlichen Signalreihen und optionaler Peer-Auswahl. Gebaut für Vergleichsraster.

Batch Company Expansion Summaries

Eine beliebige Mischung aus domain_search_id, Domain oder LinkedIn-URL, aufgelöst und mit denselben Daten wie Compare plus einem berechneten Summary-Block zurückgegeben — ohne Zielunternehmen, ohne Peer-Auswahl.

Expansion Rankings

Eine leichtgewichtige, nach Score sortierte Liste von Unternehmens-/Marktpaaren — minimale Felder, keine Paginierung — für schnelle Karten- und Heatmap-Darstellung.

Expansion Signal Search

Fragt die Signalzeilen selbst ab — Typ, Subtyp, Stärke, Polarität, datiertes Ereignis, Quelle und Beleg-URL — über Unternehmen und Märkte hinweg. Paginiert, filterbar, kein Unternehmens-Rollup.

„Detail” vs. „Signal Events” — welches davon?

Dies ist der häufigste Verwechslungspunkt, da beide Signale betreffen. Der Unterschied ist Momentaufnahme vs. Feed:
Die meisten Integrationen benötigen nur Company Expansion Detail — es liefert bereits die Signale hinter der Phase eines Unternehmens in einem Markt. Greifen Sie zu Company Signal Events, wenn Sie speziell den reichhaltigen, filterbaren, zeitfenster-basierten Ereignisstrom benötigen (z. B. beim Aufbau einer Aktivitäts-Timeline-UI).

„Compare” vs. „Summaries” — welches davon?

Beide geben dieselben unternehmensbezogenen Expansionsdaten nebeneinander zurück. Der Unterschied liegt in Identifikatoren und Rahmung:
Bauen Sie ein Wettbewerbs-Benchmarking-Raster um ein Zielunternehmen? Verwenden Sie Compare mit seed_target, um Peers automatisch auszuwählen. Haben Sie bereits eine Unternehmensmenge (eine Watchlist, einen CRM-Import, eine Liste von Domains) und möchten nur die Zahlen? Verwenden Sie Batch Company Expansion Summaries — das erspart Ihnen, die Momentum-/Score-Berechnung clientseitig neu zu implementieren.

Compare Company Expansions, dargestellt als Raster — Märkte, Momentum, Expansion Score und wichtigste neue Einträge, nebeneinander.

Ein typischer Ablauf

Entdecken

Rufen Sie Expansion Search mit Ihren Filtern (oder einer Freitext-query) auf, um die Unternehmen zu erhalten, die in Ihren Zielmarkt expandieren. Setzen Sie is_explain_match: true für KI-Zusammenfassungen zur Treffererklärung.

In ein Unternehmen eintauchen

Nehmen Sie eine domain_search_id aus den Ergebnissen und rufen Sie Company Expansion Detail für den vollständigen Überblick in einem Markt auf — Phase, Präsenz, Verlauf und Signale.

Den Aktivitäts-Feed ansehen (optional)

Für den reichhaltigen, zeitfenster-basierten Ereignisstrom rufen Sie Company Signal Events mit den Signaltypen und dem Datumsbereich auf, die Sie interessieren.

Vergleichen oder abbilden

Verwenden Sie Compare Company Expansions für ein Vergleichsraster, ausgehend von einem Zielunternehmen, Batch Company Expansion Summaries, wenn Sie bereits eine Unternehmensmenge haben und fertige Kennzahlen möchten, oder Expansion Rankings, um rangierte Punkte auf einer Karte darzustellen.

Gemeinsame Filter

Die Discovery-Endpunkte (Expansion Search, Expansion Overview, Expansion Rankings) akzeptieren dasselbe Filter-Vokabular — Expansionsfilter (Phase, Momentum, Aktualität, Geltungsbereich, Signaltypen), das gerichtete Geografie-Paar (froms / tos) und die vollständige firmografische Suite (Branche, Technologien, Mitarbeitergröße, Umsatz, gespeicherte Listen). Lernen Sie die Filter einmal in der Filters Overview; die gültigen Werte finden Sie in Expansion Reference und im Katalog How Expansion Signals Work.

Die Expansion API verwenden

Authentifizierung, Ihre ersten Aufrufe, Paginierung und das Lesen von Scores.

Durchgerechnetes Beispiel

Eine vollständige Markt-zu-Signal-Anleitung.
Zuletzt geändert am 4. September 2026