Skip to main content
POST
Nach Lookalike-Unternehmen suchen

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.

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:
exclude_locations
string[]

ISO 3166-1 Alpha-2 (cca2) wird verwendet, um Standorte auszuschließen, die nicht zurückgegeben werden sollen. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:
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"].

categories
integer[]

Eine Liste von category_id, mit der nach bestimmten Technologiekategorien gesucht wird, die von Unternehmen eingesetzt werden. Die ID finden Sie über den Endpunkt category im Filters-Tab.

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

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"].

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"

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:
founded_dates
integer[]

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

Beispiel:
revenues
integer[]

Minimal- und Maximalbereich des Unternehmensumsatzes.

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_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:
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:

Bei Aktivierung können die oben aufgeführten Filter, die Ähnlichkeitssuchen unterstützen, anstelle bestimmter IDs mit Freitext befüllt werden.

similarity_score
number<float>

Wird in Verbindung mit is_enable_similarity_search verwendet. Diese Zahl dient dazu, zu analysieren, ob ein bestimmter Slug (z. B. Branche, Technologie) der Nutzereingabe ähnelt; je höher die Zahl, desto strenger ist die Prüfung.

Beispiel:

0.7

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

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

Antwort

Erfolgreiche Antwort mit Details zur Unternehmenssuche.

metadata
object

Anfragekontext. Enthält die gespiegelten filters und parameters sowie einen profile-Block mit credit, topup_credit und total_credit_cost — die einzige Credit-Abrechnung pro Aufruf, die die API zurückgibt.

data
object | null

Die Antwortinformationen hängen vom jeweiligen Endpunkt ab.