Skip to main content
POST
Nach Personen 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
search_term
string

Eine Wortfolge, nach der die Ergebnisse gefiltert werden sollen.

Beispiel:

"pubrio"

people_name
string

Filtert Suchergebnisse, um einen bestimmten Personennamen einzuschließen.

Beispiel:

"king"

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

Auszuschließende Berufsbezeichnungen. Gleicher wortbasierter Abgleich wie bei people_titles, sodass ["senior"] jede Bezeichnung entfernt, die dieses Wort enthält. Wird nach people_titles angewendet.

Beispiel:
peoples
string<uuid>[]

Eine Liste eindeutiger Kennungen (people_search_id) für Personensuchvorgänge.

management_levels
enum<string>[]

Hierarchieebene der Person. Der Slug für die Geschäftsführungsebene ist c_suite, nicht c_level. Ein unbekannter Slug trifft auf niemanden zu. Vollständige Liste über den Endpunkt management level im Filters-Tab.

Verfügbare Optionen:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp
Beispiel:
departments
string[]

Das Feld „department“ ermöglicht die Suche nach Personen in bestimmten Fachbereichen.

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

Beispiel:
exclude_departments
string[]

Auszuschließende Abteilungs-Slugs. Gleiches Vokabular wie departments. Personen ohne erfasste Abteilung werden beibehalten.

Beispiel:
department_functions
string[]

Das Filterfeld für Job-Funktionen ermöglicht die Angabe bestimmter Rollen oder Fachbereiche bei der Personensuche.

Weitere Informationen finden Sie über die Endpunkte department functions im Filters-Tab.

Beispiel:
exclude_department_functions
string[]

Auszuschließende Funktions-Slugs. Gleiches Vokabular wie department_functions. Personen ohne erfasste Funktion werden beibehalten.

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

Der Wohnort der Personen. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:
exclude_people_locations
string[]

Länder, in denen die Person nicht wohnen darf (ISO 3166-1 Alpha-2). Ergänzung zu people_locations.

Beispiel:
company_locations
string[]

Der Standort des Unternehmenshauptsitzes. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:
company_exclude_locations
string[]

Auszuschließende Hauptsitzländer (ISO 3166-1 Alpha-2). Ergänzung zu company_locations; wird derselbe Code in beiden gesendet, liefert dies keine Ergebnisse.

Beispiel:
company_linkedin_urls
string[]

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

Beispiel:
linkedin_urls
string[]

Die vollständige URL des LinkedIn-Nutzerprofils. Die URL beginnt mit http und enthält linkedin.com/in/ oder linkedin.com/pub/

Beispiel:
companies
string<uuid>[]

Eine Liste eindeutiger Kennungen (domain_search_id) für Unternehmens- und Personensuchvorgänge.

domains
string[]

Liste von Unternehmensdomains für Unternehmens- und Personensuchvorgä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:
company_filters
object

Wrapper-Objekt für Filter auf Unternehmensebene. Empfohlene Gruppierung, die visuell trennt, welche Schlüssel die Person (oberste Ebene) filtern und welche das Unternehmen filtern. Akzeptiert dieselben Schlüssel wie die Unternehmensfilter auf oberster Ebene (z. B. technologies, verticals, vertical_categories, vertical_sub_categories, categories, keywords, founded_dates, employees, revenues, company_locations, company_exclude_locations, company_places, company_exclude_places, companies, domains, company_linkedin_urls, is_enable_similarity_search, similarity_score, sowie filter_conditions). Die Engine flacht dieses Objekt vor der Verarbeitung auf die oberste Ebene ab – bei Konflikten gewinnen die Schlüssel der obersten Ebene. Dieselbe Struktur wird bei Monitor company_filters verwendet. Beispiele finden Sie im Entwicklerleitfaden „Filters Overview“.

Beispiel:
filter_conditions
object[]

Schlüsselspezifische AND/OR-Überschreibung für Filter in /people/search. Standardmäßig OR, wenn weggelassen. Die vollständige Referenz zur Schlüsselzuordnung finden Sie im Entwicklerleitfaden „People + Company Filters“.

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

query
string

Suche in natürlicher Sprache. Wenn angegeben, interpretiert Pubrio sie in die unten stehenden Personen- und Unternehmensfilter (Jobrolle, Seniorität, Abteilung, Standort, Branche, Unternehmensgröße und mehr). Explizit übergebene Filter haben Vorrang vor den interpretierten. Leer lassen, um ausschließlich anhand der strukturierten Filter zu suchen.

Beispiel:

"decision makers in marketing"

is_include_similar_people_titles
boolean
Standard:true

Standardmäßig aktiviert. people_titles trifft auch auf nahe Varianten jedes Titels zu (zum Beispiel trifft software engineer auf senior software engineer zu). metadata.filters.people_titles gibt die vollständige Liste zurück, nach der gesucht wurde.

people_title_similarity_score
number<float>

Wird zusammen mit is_include_similar_people_titles verwendet. Steuert, wie eng ein Titel übereinstimmen muss; je höher die Zahl, desto strenger die Übereinstimmung.

Beispiel:

0.9

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

Ein Produktname, den die Technologieliste kennt, trifft dieses Produkt und seine eigenen Produkte ("Salesforce" trifft auch Salesforce Desk und Salesforce Service Cloud), nie ähnlich klingende; anderer Text wird per Ähnlichkeit zugeordnet.

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

keywords
string[]

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

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

Ortsnamen (Stadt, Region), mit denen Ergebnisse gefiltert werden. Akzeptiert lokalisierte oder englische Ortsnamen.

Beispiel:
company_exclude_places
string[]

Ortsnamen (Stadt, Region), die von den Ergebnissen ausgeschlossen werden. Akzeptiert lokalisierte oder englische Ortsnamen.

Beispiel:

Antwort

Erfolgreiche Antwort mit Details zur Personensuche.

metadata
object

Anfragekontext: gespiegelte filters und parameters, ein optionaler profile-Credit-Block sowie ignored_fields (Body-Schlüssel, die der Endpunkt verworfen hat).

data
object | null

Die Antwortinformationen hängen vom jeweiligen Endpunkt ab.

Zuletzt geändert am 4. September 2026