> ## 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.
# Expansion-Signale: Ein durchgerechnetes Beispiel
> Verfolgen Sie ein Unternehmen von der Marktansicht bis zu den einzelnen Signalen, mithilfe der Expansion API von Anfang bis Ende.
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.
```bash theme={null}
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:
```json theme={null}
{
"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.
## 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.
```bash theme={null}
POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "is_all_markets": true }
```
```json theme={null}
{
"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.
## 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.
```bash theme={null}
POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB" }
```
```json theme={null}
{
"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.
```bash theme={null}
POST /expansions/companies/pulse_events
{
"domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
"signal_types": ["HIRE", "EXEC"],
"window_days": 90,
"page": 1
}
```
```json theme={null}
{
"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.
## 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.
Authentifizierung, Paginierung und Ihre ersten Aufrufe.
Der vollständige Katalog der oben verwendeten Werte.