Skip to main content
POST
Unternehmensexpansionsdetail

Autorisierungen

pubrio-api-key
string
header
erforderlich

Ein eindeutiges API-Token, das die von Ihnen über die API durchgeführten Aktionen sowie die zugehörigen Berechtigungen und Vorgänge repräsentiert. Sie können es über den Bereich Settings erstellen.

Body

application/json
domain_search_id
string<uuid>
erforderlich

Eine eindeutige Kennung für den Unternehmenssuchvorgang.

country_code
string

Zielmarkt als ISO-3166-1-Alpha-2-(cca2)-Ländercode. Weglassen, damit automatisch der aktivste Markt des Unternehmens ausgewählt wird; setzen Sie is_all_markets für eine marktübergreifende Ansicht aller Märkte.

Beispiel:

"US"

is_all_markets
boolean

Gibt den gesamten Expansions-Footprint des Unternehmens über ALLE Märkte in einem Aufruf zurück, statt für einen einzelnen Markt. Bei true wird country_code ignoriert, der Heimatmarkt wird aus den Signal-Aggregaten ausgeschlossen, sofern er identifizierbar ist, data wird zu einer unternehmensweiten Zusammenfassung (dominante Stufe, Gesamtsignale, Zeitspanne, höchster Expansionswert), und markets_summary listet jeden Markt auf. Standardmäßig false.

Beispiel:

false

signal_type
enum<string>

Beschränkt die zurückgegebenen Signale auf einen einzelnen Typ.

Verfügbare Optionen:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Beispiel:

"EXEC"

query
string

Beschreibung in natürlicher Sprache dessen, was Sie verkaufen, oder des Käuferprofils, gegen das Sie dieses Unternehmen bewerten. Wird nur verwendet, um die KI-summary zu fundieren (siehe is_explain_match); anders als bei der Unternehmenssuche wird sie hier NICHT in Filter interpretiert.

Beispiel:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

Wenn true und eine query angegeben wird, gibt summary eine einzelne KI-Zusammenfassung der Expansionsaktivität dieses Unternehmens im aktuellen Umfang zurück (der ausgewählte Markt oder alle ausländischen Märkte, wenn is_all_markets true ist), gelesen im Abgleich mit Ihrer query und fundiert auf den tatsächlichen Signalen des Unternehmens mit [n]-Zitaten.

Beispiel:

true

window_days
integer
Standard:90

Optional. Gleitendes Fenster (in Tagen), das den KI-summary-Feed begrenzt. Standardmäßig 90, wenn weder dies noch transitioned_dates angegeben wird. Beeinflusst nicht die paginierte signals-Liste (vollständiger Verlauf).

Beispiel:

90

transitioned_dates
string<date>[]

ISO-[from, to]-Datumsbereich für das Signal-/Übergangsfenster. Hat Vorrang vor window_days, wenn beide angegeben werden.

Beispiel:
domain
string

Eine Unternehmensdomain für Unternehmenssuchvorgänge. Erhalten wir eine URL wie www.pubrio.com oder https://docs.pubrio.com/, wandelt das System diese zur Verarbeitung in pubrio.com um.

Beispiel:

"pubrio.com"

linkedin_url
string

Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt mit http und enthält linkedin.com/company/

Beispiel:

"https://www.linkedin.com/company/pubrio"

is_include_established
boolean

Schließt die Stufe established ein (langjährige Anbieter ohne aktive Expansionssignale). Standardmäßig false.

Beispiel:

false

page
integer
Standard:1

Seitenzahl, beginnend bei 1. Die Obergrenze ist der max_search_page-Wert Ihres Abonnements (max_company_search_page für die Unternehmenssuche), zurückgegeben von Profile. Bei Überschreitung wird HTTP 416 zurückgegeben.

Beispiel:

1

per_page
integer
Standard:25

Datensätze pro Seite. Standardmäßig 25, was bei den meisten Tarifen auch die Obergrenze ist — das Limit ist der max_search_per_page-Wert Ihres Abonnements, zurückgegeben von Profile. Bei Überschreitung wird HTTP 416 mit dem Code 41676 (oder 41613 bei der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte Ergebnismenge.

Erforderlicher Bereich: x <= 25
Beispiel:

25

is_include_metadata
boolean

Gibt die vollständige Detail-Payload zurück. API-Schlüssel-Traffic ist standardmäßig schlank: Der model-Block, die Konfidenzwerte (stage.confidence bei Company Expansion Detail, confidence_score bei other_markets[] und bei Rankings markers[]) sowie die Felder established_min / share_of_detected / has_known_office werden alle weggelassen, sofern dies nicht true ist.

Beispiel:

true

summary_only
boolean

Gibt nur den Stage-Zusammenfassungsblock zurück (data, company, markets_summary, signal_weekly_totals, recent_signals, expansion_score, summary) und überspringt die Signalliste und deren Aggregate. Deutlich günstiger für Hero-/Header-Ansichten.

Beispiel:

true

markets_summary_full
boolean

Bezieht die vollständige eingestufte Marktmenge als markets_summary neben der begrenzten other_markets-Liste ein.

Beispiel:

true

Antwort

Detail zu Unternehmen im Markt.

metadata
object
data
object

Ergebnis-Container.

signals
object[]

Die paginierten Signalzeilen hinter diesem Unternehmen/Markt-Paar — die Evidenzliste. Seitengröße und Gesamtwerte stammen aus metadata.pagination.

summary
object

Einzeilige Stage-Zusammenfassung für das Paar. Nur auf der ersten Seite.

company
object

Unternehmens-Chrome — Name, Domain, Logo und Social-URLs. Nur auf der ersten Seite.

signal_group_totals
object[]

Signalzählungen pro Typ, gruppiert nach Tag in Ihrer Zeitzone. Nur auf der ersten Seite.

signal_type_totals
object[]

Signalgesamtwerte aller Zeiten pro Signaltyp. Nur auf der ersten Seite.

signal_type_recent_totals
object[]

Signalgesamtwerte pro Typ über die letzten 12 Wochen. Nur auf der ersten Seite.

signal_weekly_totals
object[]

Wöchentliche Signalzählungen für die Heatmap, derselbe Zeitraum wie signal_type_recent_totals. Nur auf der ersten Seite.

evidence_breakdown
object

Evidenz-Rollup nach Quelltyp, berechnet aus den zurückgegebenen (redigierten) Signalen. Nur auf der ersten Seite.

presence
object

Beobachtete physische und digitale Präsenz des Unternehmens in diesem Markt. Nur auf der ersten Seite.

suppressions
object[]

Signale, die von der Stufenberechnung ausgeschlossen wurden, jeweils mit Begründung. Nur erste Seite.

timeline
object[]

Verlauf der Stufenübergänge für dieses Unternehmen/Markt-Paar. Nur erste Seite.

other_markets
object[]

Die weiteren aktiven Märkte des Unternehmens. Bei eingeschränkten Tarifen begrenzt – siehe other_markets_locked_count. Nur erste Seite.

other_markets_locked_count
integer

Wie viele zusätzliche Märkte Ihr Tarif nicht in other_markets zurückgegeben hat. 0, wenn nichts zurückgehalten wurde.

markets_summary
object[]

Vollständige, gerankte Marktmenge für dieses Unternehmen. Wird nur zurückgegeben, wenn markets_summary_full den Wert true hat, auf der ersten Seite.

Zuletzt geändert am 4. September 2026