Skip to main content
POST
Expansions-Suche

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
froms
string[]
erforderlich

Ursprungsmärkte (ISO 3166-1 Alpha-2). Von wo aus ein Unternehmen expandiert – seine Heimat-/Hauptsitzländer. Allein verwenden, um Unternehmen zu finden, die aus diesen Märkten heraus wachsen; mit tos kombinieren für einen bestimmten Von-nach-Korridor.

Beispiel:
tos
string[]

Zielmärkte (ISO 3166-1 Alpha-2). Wohin ein Unternehmen expandiert. Allein verwenden, um jedes Unternehmen zu finden, das in diese Märkte eintritt; mit froms kombinieren für einen bestimmten Von-nach-Korridor.

Beispiel:
exclude_froms
string[]

Auszuschließende Ursprungsmärkte (ISO 3166-1 Alpha-2).

Beispiel:
exclude_tos
string[]

Auszuschließende Zielmärkte (ISO 3166-1 Alpha-2).

Beispiel:
stages
enum<string>[]

Werte unterscheiden zwischen Groß- und Kleinschreibung und werden nicht validiert. Ein nicht erkannter Wert wird stillschweigend verworfen statt abgelehnt: Bei stages, freshness, scopes und momentum wird der gesamte Filter fallen gelassen, und Sie erhalten ungefilterte Ergebnisse, während bei signal_types und signal_strengths der Filter angewendet wird und nichts trifft. So oder so wirkt die Antwort normal. Lösen Sie gültige Slugs über die Expansion-Referenz auf und vergleichen Sie data.pagination.total_entries mit einem ungefilterten Aufruf, wenn ein Ergebnis falsch erscheint.

Verfügbare Optionen:
exploring,
committing,
expanding,
scaling
Beispiel:
momentum
enum<string>[]

Verlauf der Bewegung des Unternehmens im Markt. advancing bedeutet Fortschritt, steady bedeutet Halten, pulling_back umfasst Rückzug und Kontraktion.

Verwenden Sie hier nicht die Werte aus directions in der Expansion-Referenz. Diese (advancing, steady, retreating, new) sind die Antwort-Werte, die Sie bei stage.direction zurückerhalten; nur die drei oben genannten werden als Filter akzeptiert. Das Senden von retreating oder new deaktiviert den Filter stillschweigend und liefert ungefilterte Ergebnisse.

Verfügbare Optionen:
advancing,
steady,
pulling_back
Beispiel:
freshness
enum<string>[]

Werte unterscheiden zwischen Groß- und Kleinschreibung und werden nicht validiert. Ein nicht erkannter Wert wird stillschweigend verworfen statt abgelehnt: Bei stages, freshness, scopes und momentum wird der gesamte Filter fallen gelassen, und Sie erhalten ungefilterte Ergebnisse, während bei signal_types und signal_strengths der Filter angewendet wird und nichts trifft. So oder so wirkt die Antwort normal. Lösen Sie gültige Slugs über die Expansion-Referenz auf und vergleichen Sie data.pagination.total_entries mit einem ungefilterten Aufruf, wenn ein Ergebnis falsch erscheint.

Verfügbare Optionen:
fresh,
cooling,
stale,
cold
Beispiel:
scopes
enum<string>[]

Filtert nach Umfang des Markteintritts.

Verfügbare Optionen:
entering_new_market,
expanding_within_presence,
established_only
Beispiel:
ahead_of_pace
boolean

Beschränkung auf Paare, die sich schneller bewegen als das typische Tempo für diesen Markt.

Beispiel:

false

signal_types
enum<string>[]

Werte unterscheiden zwischen Groß- und Kleinschreibung und werden nicht validiert. Ein nicht erkannter Wert wird stillschweigend verworfen statt abgelehnt: Bei stages, freshness, scopes und momentum wird der gesamte Filter fallen gelassen, und Sie erhalten ungefilterte Ergebnisse, während bei signal_types und signal_strengths der Filter angewendet wird und nichts trifft. So oder so wirkt die Antwort normal. Lösen Sie gültige Slugs über die Expansion-Referenz auf und vergleichen Sie data.pagination.total_entries mit einem ungefilterten Aufruf, wenn ein Ergebnis falsch erscheint.

Verfügbare Optionen:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Beispiel:
signal_strengths
enum<string>[]

Werte unterscheiden zwischen Groß- und Kleinschreibung und werden nicht validiert. Ein nicht erkannter Wert wird stillschweigend verworfen statt abgelehnt: Bei stages, freshness, scopes und momentum wird der gesamte Filter fallen gelassen, und Sie erhalten ungefilterte Ergebnisse, während bei signal_types und signal_strengths der Filter angewendet wird und nichts trifft. So oder so wirkt die Antwort normal. Lösen Sie gültige Slugs über die Expansion-Referenz auf und vergleichen Sie data.pagination.total_entries mit einem ungefilterten Aufruf, wenn ein Ergebnis falsch erscheint.

Verfügbare Optionen:
low,
medium,
high,
very_high
Beispiel:
min_signal_count
integer

Mindestanzahl an Expansionssignalen, die ein Unternehmen im Zeitraum aufweisen muss — "sehr aktiv / starke Präsenz".

Beispiel:

3

only_contraction
boolean

Bei true werden nur als Kontraktion gekennzeichnete Expansionen zurückgegeben (Unternehmen, die sich zurückziehen).

Beispiel:

false

min_markets
integer

Mindestanzahl neuer Märkte, die ein Unternehmen im Zeitraum betreten haben muss.

Beispiel:

3

home_country_code
string[]

Nach Heimatland des Unternehmens filtern (ISO 3166-1 Alpha-2). Überschneidet sich mit froms, wenn beide angegeben werden.

Beispiel:
industries
string[]

Filtert nach Branchenname (Freitext-Abgleich).

Beispiel:
exclude_industries
string[]

Auszuschließende Branchen (Freitext-Abgleich).

Beispiel:
verticals
integer[]

Eine Liste von vertical_id, mit der nach Unternehmen in einer bestimmten Branche oder einem bestimmten Vertical gesucht wird. Die ID finden Sie über den Endpunkt vertical im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["AI"].

vertical_categories
integer[]

Eine Liste von vertical_category_id, mit der nach Unternehmen in einer bestimmten Vertical-Kategorie gesucht wird. Die ID finden Sie über den Endpunkt vertical category im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Information Technology"].

vertical_sub_categories
integer[]

Eine Liste von vertical_sub_category_id, mit der nach Unternehmen in einer bestimmten Vertical-Unterkategorie gesucht wird. Die ID finden Sie über den Endpunkt vertical sub category im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Software"].

technologies
integer[]

Eine Liste von tag_id, mit der nach bestimmten von Unternehmen eingesetzten Technologien gesucht wird. Die ID finden Sie über den Endpunkt technology im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Shopify"].

employees
string[][]

Der Zahlenbereich der für das Unternehmen tätigen Mitarbeiter. Damit können Sie Unternehmen anhand der Mitarbeiterzahl finden. Sie können mehrere Bereiche hinzufügen, um Ihre Suchergebnisse zu erweitern.

Weitere Informationen finden Sie über die Endpunkte company size im Filters-Tab.

Beispiel:
revenues
integer[]

Minimal- und Maximalbereich des Unternehmensumsatzes.

Beispiel:
founded_dates
integer[]

Zeitraum der Unternehmensgründung in Jahren. Der maximale Gründungswert ist das aktuelle Jahr.

Beispiel:
keywords
string[]

Eine Liste von Stichwörtern, mit der Unternehmen nach Relevanz, Spezialisierung oder Beschreibung gefiltert werden.

Beispiel:
companies
string[]

Beschränkt auf bestimmte Unternehmen durch eine beliebige Kombination aus domain_search_id, Unternehmensdomain oder einer URL zum Social-Media-Profil eines Unternehmens. Domains und URLs werden auf das bestplatzierte Unternehmen aufgelöst.

Beispiel:
job_locations
string[]

ISO 3166-1 Alpha-2 (cca2) wird zum Filtern von Standorten verwendet. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:
job_exclude_locations
string[]

Geografische Standorte, die von den Stellenanzeigen-Ergebnissen ausgeschlossen werden.

Beispiel:
job_posted_dates
string[]

Datumsbereich des Veröffentlichungsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace.

Beispiel:
job_titles
string[]

Berufsbezeichnungen der Personen, die Sie finden möchten.

Die Ergebnisse umfassen auch Berufsbezeichnungen mit ähnlicher Terminologie, selbst wenn diese nicht exakt übereinstimmen. Eine Suche nach software engineer kann beispielsweise Ergebnisse für Personen mit der Bezeichnung senior software engineer liefern.

Beispiel:
advertisement_target_locations
string[]

Geografische Zielstandorte für Anzeigen.

Beispiel:
advertisement_exclude_target_locations
string[]

Geografische Standorte, die vom Anzeigen-Targeting ausgeschlossen werden.

Beispiel:
advertisement_search_terms
string[]

Stichwörter zur Suche innerhalb von Anzeigeninhalten oder -titeln.

Beispiel:
advertisement_start_dates
string<date>[]

Startdatumsbereich für die Anzeigenfilterung.

Beispiel:
advertisement_end_dates
string<date>[]

Enddatumsbereich für die Anzeigenfilterung.

Beispiel:
news_categories
string[]

Liste von category slugs zur Suche nach bestimmten News-Kategorien. Den Slug finden Sie über den Endpunkt news categories im Filters-Tab.

Beispiel:
news_published_dates
string[]

Datumsbereich des Publikationsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace.

Beispiel:
transitioned_dates
string<date>[]

ISO-Datumsbereich für das Zeitleistenfenster. Standardmäßig die letzten 90 Tage. Eine query in natürlicher Sprache kann dies auch über Kalenderausdrücke setzen ("this year", "last year", "Q2 2026").

Beispiel:
window_days
integer

Optional. Größe des gleitenden Fensters in Tagen. Wird verwendet, wenn kein expliziter transitioned_dates-Bereich angegeben wird; werden beide weggelassen, wird ein Standardfenster verwendet.

Beispiel:

90

query
string

Anfrage in natürlicher Sprache, die Pubrio in Expansions- und Unternehmensfilter interpretiert.

Beispiel:

"fintech companies expanding into the UK"

is_explain_match
boolean

Bezieht KI-generierte Begründungen ein, warum jedes Unternehmen der Suche entspricht, basierend auf den tatsächlichen Signalen des Unternehmens. Am besten kombiniert mit einer Anfrage in natürlicher Sprache. Sowohl die Anzahl der zitierten Signale als auch die Batch-Größe skalieren mit per_page; Quellen mit hohem Volumen (Stellenausschreibungen, Werbekampagnen) werden als zeitraumbezogene Zählung zusammengefasst (z. B. "12 job postings") statt einzeln aufgelistet.

Beispiel:

true

sort_by
enum<string>

Sortierung der Ergebnisse. Weglassen für die Standard-Relevanzreihenfolge: bestätigte Paare zuerst (2 oder mehr unterschiedliche Signaltypen), dann Paare mit wiederholten Belegen (3 oder mehr Signale), dann der Rest – innerhalb jeder Stufe zuletzt übergegangen zuerst. recent – reine Aktualität (zuletzt übergegangen zuerst). expansion_score – höchster Expansionswert zuerst. signal_count – meiste Signale im Paar zuerst. company_ranking – Pubrios Gesamt-Unternehmensranking (niedriger bedeutet prominenter), aufsteigend.

Verfügbare Optionen:
recent,
expansion_score,
signal_count,
company_ranking
Beispiel:

"expansion_score"

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

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

Aktiviert Freitext-Matching für verticals, vertical_categories, vertical_sub_categories und technologies; diese Filter werden fallen gelassen, sofern dies nicht true ist.

Beispiel:

true

Antwort

Paginierte Liste von Unternehmen, die in den Markt/die Märkte expandieren. filters gibt die angewendeten (oder aus natürlicher Sprache interpretierten) Kriterien wieder; jedes Unternehmen enthält eine match_summary, wenn is_explain_match true ist.

metadata
object

Such-Metadaten: die tatsächlich angewendeten Filter sowie das Markt-Rollup (Aggregat, geografischer Umfang, wichtigste Herkunfts-/Ziel-/Branchen, Zeitleiste). API-Schlüssel-Antworten enthalten das Rollup nur, wenn is_include_metadata true ist.

data
object

Ergebnis-Container (Standard-Suchumschlag): die Unternehmensliste plus Paginierung.

Zuletzt geändert am 4. September 2026