> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Personensuche > Durchsuchen Sie die Pubrio-Datenbank nach Personen, die bestimmten Kriterien wie Jobtitel, Standort, Unternehmen und Seniorität entsprechen. ## OpenAPI ````yaml de-openapi POST /people/search openapi: 3.0.0 info: description: >- Die Pubrio API liefert Market-Expansion-Intelligence – Echtzeit-Signale, die anzeigen, wenn ein Unternehmen in einen neuen Markt eintritt – zusammen mit den zugrunde liegenden Unternehmens- und Personendaten. Durchsuchen, schlagen Sie nach und reichern Sie Accounts und Kontakte an, und abonnieren Sie typisierte, datierte Bewegungssignale in über 200 Märkten. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/de/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/de/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Workspace-Profilinformationen und Nutzungsstatistiken - name: Enrichment description: >- Personen- und Unternehmensdatensätze mit detaillierten B2B-Daten anreichern - name: Lookalike description: Unternehmen finden, die einem bestimmten Unternehmen ähnlich sind - name: Search description: >- Personen, Unternehmen, Stellenanzeigen, Nachrichten und Werbeanzeigen mit Filtern durchsuchen - name: Lookup description: >- Detaillierte Informationen zu bestimmten Personen, Unternehmen, Stellenanzeigen, Nachrichten, Werbeanzeigen und Technologien nachschlagen - name: LinkedIn description: Personen- und Unternehmensdaten über LinkedIn-Profil-URLs nachschlagen - name: Redeem description: >- Credits einlösen, um Kontaktdaten von Personen freizuschalten (einzeln und im Batch) - name: Channels description: >- Outreach-Kanalvorlagen verwalten (erstellen, aktualisieren, löschen, auflisten) - name: Monitor description: >- Daten-Monitore mit Webhooks, Statistiken und Verarbeitung erstellen und verwalten - name: Filters description: >- Verfügbare Filterwerte für Suchparameter abrufen (Technologien, Standorte, Branchen usw.) - name: API Keys description: >- API-Anfrageprotokolle und Nutzungsanalysen für API-Schlüssel auflisten und einsehen - name: Insights description: >- Aggregierte Signal-Insights für Unternehmen (Stellenanzeigen, Nachrichten, Werbeanzeigen). - name: Export description: Massendatenexporte (kreditpflichtig). - name: Expansion description: >- Market-Expansion-Intelligence für Unternehmen: Signale, Phasen, Märkte und Exporte. externalDocs: description: >- Die Pubrio-API dient zum Suchen, Anzeigen einer Vorschau und Anreichern von Kontakten und Accounts. Die Pubrio-Datenbank bietet umfangreiche B2B-Kontakt- und Sales-Intelligence-Daten. url: https://docs.pubrio.com paths: /people/search: post: tags: - Search summary: Nach Personen suchen description: >- Durchsuchen Sie die Pubrio-Datenbank nach Personen, die bestimmten Kriterien wie Jobtitel, Standort, Unternehmen und Seniorität entsprechen. operationId: people_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' exclude_people_titles: $ref: '#/components/schemas/exclude_people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' exclude_departments: $ref: '#/components/schemas/exclude_departments' department_functions: $ref: '#/components/schemas/functions' exclude_department_functions: $ref: '#/components/schemas/exclude_department_functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' exclude_people_locations: $ref: '#/components/schemas/exclude_people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_exclude_locations: $ref: '#/components/schemas/company_exclude_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' query: type: string example: decision makers in marketing description: >- 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. is_include_similar_people_titles: type: boolean description: >- Wenn aktiviert, berücksichtigt `people_titles` auch eng verwandte Titel (zum Beispiel entspricht `software engineer` auch `senior software engineer`) statt nur exakter Übereinstimmungen. people_title_similarity_score: type: number format: float example: 0.9 description: >- 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. responses: '200': description: Erfolgreiche Antwort mit Details zur Personensuche. content: application/json: schema: type: object properties: metadata: type: object description: >- Anfragekontext: gespiegelte `filters` und `parameters`, ein optionaler `profile`-Credit-Block sowie `ignored_fields` (Body-Schlüssel, die der Endpunkt verworfen hat). data: $ref: '#/components/schemas/data' example: metadata: filters: management_levels: - c_suite profile: null data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 total_display_pages: 100 is_timeout: false peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. tagline: null introduction: null description: null departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club country: United States country_code: US location: United States state: Arkansas city: Bentonville wantedly_name: null rocketpunch_name: null contacts: null contact_types: [] emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon wantedly_url: null rocketpunch_url: null saved_lists: null sequences: null social_metadata: {} company: company_name: Walmart company_url: http://walmart.com is_company_url_active: true domain: walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 country: United States country_code: US location: United States phones: null emails: [] contacts: [] wantedly_name: null rocketpunch_name: null tiktok_name: null company_size_printed: 466,000 company_size: 466000 industry: Retail specialties: - Retail - E-commerce logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart x_url: null github_url: null tiktok_url: null wantedly_url: null rocketpunch_url: null social_metadata: {} - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: Eine Wortfolge, nach der die Ergebnisse gefiltert werden sollen. people_name: type: string example: king description: >- Filtert Suchergebnisse, um einen bestimmten Personennamen einzuschließen. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- 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. exclude_people_titles: type: array items: type: string example: - intern - assistant description: >- 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. peoples: type: array items: type: string format: uuid description: >- Eine Liste eindeutiger Kennungen (people_search_id) für Personensuchvorgänge. management_levels: type: array items: type: string enum: - c_suite - director - entry - founder - head - intern - manager - owner - partner - senior - vp example: - c_suite - vp description: >- Hierarchieebene der Person. Der Slug für die Geschäftsführungsebene ist `c_suite`, nicht `c_level`. Unbekannte Slugs werden verworfen, wenn weitere Personenfilter vorhanden sind, und führen zu einem Fehler `40037`, wenn dies der einzige Filter ist. Vollständige Liste über den Endpunkt `management level` im Filters-Tab. departments: type: array items: type: string example: - master_human_resources description: >- Das Feld „department“ ermöglicht die Suche nach Personen in bestimmten Fachbereichen. Weitere Informationen finden Sie über die Endpunkte `department` im Filters-Tab. exclude_departments: type: array items: type: string example: - master_human_resources description: >- Auszuschließende Abteilungs-Slugs. Gleiches Vokabular wie `departments`. Personen ohne erfasste Abteilung werden beibehalten. functions: type: array items: type: string example: - human_resources description: >- 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. exclude_department_functions: type: array items: type: string example: - software_development description: >- Auszuschließende Funktions-Slugs. Gleiches Vokabular wie `department_functions`. Personen ohne erfasste Funktion werden beibehalten. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 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. people_locations: type: array items: type: string example: - US - SG - CN description: >- Der Wohnort der Personen. Weitere Informationen finden Sie über die Endpunkte `location` im Filters-Tab. exclude_people_locations: type: array items: type: string example: - US description: >- Länder, in denen die Person **nicht** wohnen darf (ISO 3166-1 Alpha-2). Ergänzung zu `people_locations`. company_locations: type: array items: type: string example: - US - SG - CN description: >- Der Standort des Unternehmenshauptsitzes. Weitere Informationen finden Sie über die Endpunkte `location` im Filters-Tab. company_exclude_locations: type: array items: type: string example: - CN description: >- Auszuschließende Hauptsitzländer (ISO 3166-1 Alpha-2). Ergänzung zu `company_locations`; wird derselbe Code in beiden gesendet, liefert dies keine Ergebnisse. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt mit `http` und enthält `linkedin.com/company/` people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- Die vollständige URL des LinkedIn-Nutzerprofils. Die URL beginnt mit `http` und enthält `linkedin.com/in/` oder `linkedin.com/pub/` companies: type: array items: type: string format: uuid description: >- Eine Liste eindeutiger Kennungen (domain_search_id) für Unternehmens- und Personensuchvorgänge. domains: type: array items: type: string example: - pubrio.com description: >- 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. company_filters: type: object description: >- 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“. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: >- Der Filterschlüssel, der angibt, auf welche Eigenschaft der Operator angewendet wird. Die Schlüssel beziehen sich auf die einheitlichen Unternehmensfilter-Namen (verwenden Sie `places`, nicht `company_places`). operator: type: string enum: - or - and example: and description: >- Der anzuwendende logische Operator. Verwenden Sie „or“, um einen der angegebenen Werte zu finden, oder „and“, um alle angegebenen Werte zu verlangen. description: >- 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“. is_enable_similarity_search: type: boolean description: >- Bei Aktivierung können die oben aufgeführten Filter, die Ähnlichkeitssuchen unterstützen, anstelle bestimmter IDs mit Freitext befüllt werden. similarity_score: type: number format: float example: 0.7 description: >- 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. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- 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](/de/api-reference/endpoint/profile/profile). Bei Überschreitung wird **HTTP 416** mit dem Code `41676` (oder `41613` bei der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte Ergebnismenge. page: type: integer example: 1 default: 1 description: >- 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](/de/api-reference/endpoint/profile/profile). Bei Überschreitung wird **HTTP 416** zurückgegeben. data: type: object nullable: true description: Die Antwortinformationen hängen vom jeweiligen Endpunkt ab. responses: general_error: description: >- Ungültige Anfrage. Die Anfrage war fehlerhaft formatiert oder enthielt ungültige Parameter. Prüfen Sie den Fehlercode und die Meldung für Details. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Rate-Limit überschritten. Es wurden zu viele Anfragen in einem bestimmten Zeitraum gestellt. Versuchen Sie es erneut, nachdem das Rate-Limit-Fenster zurückgesetzt wurde. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Interner Serverfehler. Auf dem Server ist ein unerwarteter Fehler aufgetreten. Wenden Sie sich an den Support, falls der Fehler weiterhin besteht. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 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](https://dashboard.pubrio.com/#/settings/) erstellen. in: header ````