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 den Stage-Zusammenfassungsblock zurück (data, company, markets_summary, signal_weekly_totals, recent_signals, expansion_score, summary) und überspringt die paginierte Signalliste und deren Aggregate.

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