> ## 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. # Den richtigen Expansion-Endpunkt wählen > Eine Aufgabe-zu-Endpunkt-Anleitung für die Expansion API — welchen Endpunkt Sie für Discovery, Unternehmensdetails, den Signal-Feed, Vergleiche, Karten und Referenzwerte aufrufen. 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?](/de/knowledge-base/concepts/expansion-signals) — diese Anleitung setzt diese Kenntnisse voraus und konzentriert sich auf die Endpunktauswahl. ## Nach Aufgabe auswählen | Sie möchten… | Aufrufen | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | **Unternehmen finden**, die in einen Markt expandieren (per Filter oder Freitext-Query) | [Expansion Search](/de/api-reference/endpoint/expansions/market_lookup) | | **Markt-KPIs und -Ströme** sehen (Anzahl pro Phase, Top-Korridore) | [Expansion Overview](/de/api-reference/endpoint/expansions/dashboard) | | Den **Status eines einzelnen Unternehmens in einem Markt** abrufen — Phase, Präsenz, Verlauf und die zugrunde liegenden Signale | [Company Expansion Detail](/de/api-reference/endpoint/expansions/company_lookup) | | Den **angereicherten, zeitfenster-basierten Feed** der Signalereignisse eines Unternehmens abrufen | [Company Signal Events](/de/api-reference/endpoint/expansions/company_pulse_events) | | Die Expansion mehrerer Unternehmen **vergleichen**, ausgehend von einem Zielunternehmen | [Compare Company Expansions](/de/api-reference/endpoint/expansions/company_compare) | | **Direkt darstellbare Vergleichskennzahlen** (Märkte, Momentum, Expansion Score) für eine bereits vorhandene Unternehmensmenge abrufen — per Domain, LinkedIn-URL oder ID | [Batch Company Expansion Summaries](/de/api-reference/endpoint/expansions/company_summaries) | | **Rangierte Unternehmens-/Marktpunkte** auf einer Karte oder Heatmap darstellen | [Expansion Rankings](/de/api-reference/endpoint/expansions/company_markers) | | Die **rohen Signalzeilen** hinter einer Phase lesen — Belege prüfen oder eigenes Scoring aufbauen | [Expansion Signal Search](/de/api-reference/endpoint/expansions/signal_search) | | **Filter- und Enum-Werte** auflösen (Phasen, Signaltypen, Aktualität …) | [Expansion Reference](/de/api-reference/endpoint/expansions/types) | ## Die Endpunkte im Überblick Der Discovery-Endpunkt. Filtert Unternehmen nach Expansionsphase, Aktualität, Markt und der vollständigen firmografischen Suite — oder übergibt eine Freitext-`query`. Paginierte Unternehmensliste. Aggregierte Marktdaten: Anzahl je Phase, wichtigste grenzüberschreitende Ströme, Aktivität beobachteter Unternehmen. Keine Paginierung — eine Dashboard-Momentaufnahme. Ein Unternehmen in einem Markt: aktuelle Phase, Score, Präsenz, Übergangsverlauf und die stützenden Signale. Die marktbezogene Momentaufnahme. Der angereicherte, paginierte Feed der Signalereignisse eines Unternehmens über Signaltypen und ein Datumsfenster hinweg. Der Aktivitäts-Drilldown. Mehrere Unternehmen nebeneinander in einem Aufruf, mit wöchentlichen Signalreihen und optionaler Peer-Auswahl. Gebaut für Vergleichsraster. 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. Eine leichtgewichtige, nach Score sortierte Liste von Unternehmens-/Marktpaaren — minimale Felder, keine Paginierung — für schnelle Karten- und Heatmap-Darstellung. 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*: | | Company Expansion Detail | Company Signal Events | | ------------------ | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | **Umfang** | ein Unternehmen × **ein Markt** | ein Unternehmen, über **alle seine ausländischen Märkte** | | **Märkte** | ein **einzelner Markt** über `country_code`, oder das gesamte Unternehmen auf einmal über `is_all_markets` | standardmäßig **alle ausländischen Märkte** (Heimatmarkt ausgeschlossen); mit `country_codes` (Array) auf bestimmte einschränkbar | | **Rückgabe** | Phase, Score, Präsenz, Verlauf **+ stützende Signale** | **angereicherte Signalereignisse** (Beleg-URLs, Einstellungslisten, Labels) | | **Zeit** | aktueller Stand | ein von Ihnen gewähltes **Datumsfenster** (`window_days` — Standard 90 — oder `transitioned_dates`) | | **Form** | ein strukturiertes Momentaufnahme-Objekt | ein paginierter Ereignis-Feed („mehr laden") | | **Verwenden wenn** | „Wie ist der Status dieses Unternehmens in **einem** Markt, und warum?" | „Zeig mir den vollständigen Strom über **jeden** Markt, der die Expansion dieses Unternehmens antreibt" | **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*: | | Compare Company Expansions | Batch Company Expansion Summaries | | ---------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | **Eingabe** | beliebige Mischung aus `domain_search_id`, `domain` oder `linkedin_url` | beliebige Mischung aus `domain_search_id`, `domain` oder `linkedin_url` | | **Peer-Auswahl** | optional, über `seed_target` | keine — jedes Unternehmen ist unabhängig | | **Berechnetes Rollup** | keines (Märkte/Momentum/Score selbst berechnen) | pro Unternehmen enthaltener `summary`-Block (aktive/neue Märkte, Momentum, Expansion Score, Phasenverteilung) | | **Verwenden wenn** | Sie bereits aufgelöste IDs haben und für ein Zielunternehmen vergleichbare Peers auswählen möchten | Ihnen Unternehmen per Domain oder LinkedIn-URL vorliegen und Sie in einem Aufruf direkt darstellbare Vergleichskennzahlen möchten | **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. Wettbewerbsvergleichstabelle mit Märkten, neuen Märkten, Momentum, Aktivität, Expansion Score und wichtigstem Expansionsmarkt für ein Zielunternehmen und seine Mitbewerber ## Ein typischer Ablauf 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. 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. Für den reichhaltigen, zeitfenster-basierten Ereignisstrom rufen Sie **Company Signal Events** mit den Signaltypen und dem Datumsbereich auf, die Sie interessieren. 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](/de/developer-guides/filters/overview); die gültigen Werte finden Sie in [Expansion Reference](/de/api-reference/endpoint/expansions/types) und im Katalog [How Expansion Signals Work](/de/knowledge-base/concepts/how-expansion-signals-work). Authentifizierung, Ihre ersten Aufrufe, Paginierung und das Lesen von Scores. Eine vollständige Markt-zu-Signal-Anleitung.