> ## 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. # Stellenausschreibungen von Unternehmen durchsuchen > Stellenanzeigen durchsuchen. Siehe den [Job-Search-Leitfaden](/de/developer-guides/search/job-search). ## OpenAPI ````yaml de-openapi POST /companies/jobs/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: /companies/jobs/search: post: tags: - Search summary: Nach Stellenanzeigen suchen description: >- Stellenanzeigen durchsuchen. Siehe den [Job-Search-Leitfaden](/de/developer-guides/search/job-search). operationId: companies_search_jobs parameters: [] requestBody: required: true content: application/json: schema: type: object properties: locations: $ref: '#/components/schemas/locations' exclude_locations: type: array items: type: string example: - TW description: >- ISO-3166-1-Alpha-2-Standortcodes (cca2), die aus den Stellenergebnissen ausgeschlossen werden sollen. Gültige Codes finden Sie in den `location`-Endpunkten im Filters-Tab. location_ids: $ref: '#/components/schemas/job_location_ids' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' search_term: $ref: '#/components/schemas/search_term' search_terms: type: array items: type: string example: - Software Developer description: >- Array von Schlüsselwort-Zeichenfolgen zum Filtern von Stellenanzeigen. Jeder Begriff wird mit dem Inhalt der Stellenanzeige abgeglichen. Verwenden Sie `search_term` für eine einzelne Zeichenfolge oder `search_terms` für mehrere Schlüsselwörter. titles: $ref: '#/components/schemas/people_titles' functions: $ref: '#/components/schemas/job_functions' seniority_ranks: $ref: '#/components/schemas/job_seniority_ranks' posted_dates: $ref: '#/components/schemas/posted_dates' launch_dates: $ref: '#/components/schemas/job_launch_dates' created_at: $ref: '#/components/schemas/search_created_at' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' responses: '200': description: Erfolgreiche Antwort mit Details zur Stellensuche des Unternehmens. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' jobs: type: array items: $ref: '#/components/schemas/job_search_result' example: metadata: profile: null filters: domains: - google.com per_page: 25 language: en ignored_fields: [] data: pagination: page: 1 per_page: 25 total_entries: 2228628 total_pages: 89146 is_timeout: false total_display_pages: 250 jobs: - job_id: 371d0c44-4c56-4c9c-98e2-ef6dd986b848 job_search_id: 371d0c44-4c56-4c9c-98e2-ef6dd986b848 last_modified: '2025-05-31T20:41:27.894Z' companies: logo_url: >- https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: 539e2c34-de6b-4613-8f5b-e3aa18b4ef47 company_name: Google linkedin_name: google country_code: US domain: google.com location: Seoul, Seoul, South Korea job_url: >- https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D posting_date: '2025-05-31' country_code: KR location_id: 491 title: >- Software Engineer, gReach Program for People with Disabilities (장애인 채용) country: South Korea created_at: '2025-05-10T14:30:58.348Z' source_type: linkedin functions: null seniority_rank: 0 base_salary: null experience_requirement: null education_requirement: null employment_type: null - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: locations: type: array items: type: string example: - US - SG - CN description: >- ISO 3166-1 Alpha-2 (cca2) wird zum Filtern von Standorten verwendet. Weitere Informationen finden Sie über die Endpunkte `location` im Filters-Tab. job_location_ids: type: array items: type: integer example: - 357 - 419 description: >- Land der Stellenanzeige nach Pubrio `location_id` (Endpunkt Locations; auch auf jeder Zeile vorhanden). Alternative zu `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. 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_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/` search_term: type: string example: pubrio description: Eine Wortfolge, nach der die Ergebnisse gefiltert werden sollen. 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. job_functions: type: array items: type: string example: - engineering - product_management description: >- Aus der Berufsbezeichnung abgeleitete Funktions-Slugs, z. B. `engineering`, `sales`, `marketing`, `finance`, `product_management` – dieselben Werte, die Zeilen in `functions` zurückgeben. Unbekannte Slugs liefern keine Treffer. Vollständige Liste: [Enums & Constants](/de/api-reference/enums#job-functions). job_seniority_ranks: type: array items: type: integer enum: - 1 - 2 - 3 - 4 - 5 example: - 4 - 5 description: >- Erfahrungsstufe aus der Berufsbezeichnung: `1` Junior, `2` Senior, `3` Manager, `4` Director, `5` Executive. Werte außerhalb von 1–5 werden ignoriert und der Filter verworfen. Zeilen geben ihre Stufe in `seniority_rank` zurück (`0` = nicht klassifiziert). posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Datumsbereich des Veröffentlichungsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace. job_launch_dates: type: array items: type: string format: date minItems: 1 maxItems: 2 example: - '2026-08-01' - '2026-08-31' description: >- Einschließendes Zeitfenster `[from, to]` (UTC) für das Startdatum: `posting_date`, oder bei Fehlen der Erfassungstag. Entspricht der Zählweise von Job Insights. Ein einzelnes Datum trifft auf diesen Tag zu. search_created_at: type: string format: date-time example: '2026-09-02T12:00:00Z' description: >- Erfasst zu oder nach diesem Zeitpunkt (UTC). Datum oder ISO-Zeitstempel. Für inkrementelle Synchronisierungen übergeben Sie den `created_at`-Wert Ihrer neuesten gespeicherten Zeile. is_realtime_enrichment: type: boolean default: false example: true description: >- Aktiviert die Echtzeit-Anreicherung für eine einzelne, unternehmensbezogene Abfrage (gefiltert nach `domain_search_id`, `domains` oder `linkedin_urls`). Liefert die erste Suche null Ergebnisse, scrapt der Endpunkt die Quelle, speichert die Datensätze dauerhaft und führt die Suche vor der Antwort erneut aus. Unterliegt einer routenspezifischen Zeitbegrenzung. is_ascending_order: type: boolean default: false example: false description: >- Sortierrichtung. Ergebnisse werden standardmäßig neueste zuerst zurückgegeben; setzen Sie `true` für älteste zuerst. Dieser Endpunkt kennt kein `sort_by` – der Sortierschlüssel ist fest und in der Endpunktbeschreibung angegeben. 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. search_metadata: type: object description: Anfragekontext. properties: profile: type: object nullable: true description: >- Credit-Block (`credit`, `topup_credit`, `total_credit_cost`), wenn eine Credit-Abrechnung angefordert wird; `null` bei reinem API-Key-Traffic. filters: type: object description: >- Rückgabe des Request-Bodys so, wie der Endpunkt ihn angewendet hat, einschließlich Standardwerten wie `per_page` und `language`. ignored_fields: type: array items: type: string description: >- Body-Schlüssel, die der Endpunkt nicht erkannt und verworfen hat. Leer bedeutet, dass jeder Schlüssel angewendet wurde – ein falsch geschriebener Filter erweitert die Suche, statt fehlzuschlagen. search_pagination: type: object description: Paginierung für die Ergebnismenge. properties: page: type: integer description: Aktuelle Seitenzahl. per_page: type: integer description: Datensätze pro Seite. total_entries: type: integer description: >- Gesamtzahl der passenden Datensätze. Bei breiten, unternehmensunabhängigen Suchen handelt es sich um eine Schätzung. total_pages: type: integer description: '`total_entries` geteilt durch `per_page`.' total_display_pages: type: integer description: >- Seiten, die Sie tatsächlich anfordern können, begrenzt durch `max_search_page` Ihres Tarifs. is_timeout: type: boolean description: >- `true`, wenn die Zählabfrage ein Timeout hatte und `total_entries` eine teilweise Schätzung ist. job_search_result: type: object description: Eine Stellenanzeige. properties: job_id: type: string format: uuid description: Kennung der Stellenanzeige. job_search_id: type: string format: uuid description: Derselbe Wert wie `job_id`. Übergeben Sie ihn an Job Lookup. created_at: type: string format: date-time description: >- Wann Pubrio die Stellenanzeige erstmals erfasst hat. Dies ist der Standard-Sortierschlüssel. last_modified: type: string format: date-time description: Wann der Datensatz zuletzt aktualisiert wurde. title: type: string description: Berufsbezeichnung wie veröffentlicht. job_url: type: string description: Link zur Stellenanzeige bei der Quelle. location: type: string description: Freitext-Standort wie veröffentlicht. nullable: true location_id: type: integer nullable: true description: >- Pubrio `location_id` des Landes der Stellenanzeige. Gleiches Vokabular wie der Filter `location_ids`. country: type: string description: Ländername der Stellenanzeige. nullable: true country_code: type: string description: >- ISO-3166-1-Alpha-2-Code des Landes der Stellenanzeige. Gleiches Vokabular wie der Filter `locations`. nullable: true posting_date: type: string format: date nullable: true description: >- Veröffentlichungsdatum des Publishers. `launch_dates` filtert danach und greift bei Fehlen auf `created_at` zurück. source_type: type: string description: Quelle, aus der die Stellenanzeige erfasst wurde, z. B. `linkedin`. functions: type: array nullable: true items: type: string description: >- Aus der Berufsbezeichnung aufgelöste Job-Funktions-Slugs; `null`, wenn nicht klassifiziert. Gleiches Vokabular wie der Filter `functions`. seniority_rank: type: integer enum: - 0 - 1 - 2 - 3 - 4 - 5 description: >- Erfahrungsstufe `1`–`5` wie im Filter `seniority_ranks` definiert; `0`, wenn die Berufsbezeichnung nicht klassifiziert werden konnte. base_salary: type: string description: >- Gehaltsangabe wie veröffentlicht, sofern von der Quelle bereitgestellt. nullable: true experience_requirement: type: string description: >- Erfahrungsanforderung wie veröffentlicht, sofern von der Quelle bereitgestellt. nullable: true education_requirement: type: string description: >- Ausbildungsanforderung wie veröffentlicht, sofern von der Quelle bereitgestellt. nullable: true employment_type: type: string description: >- Beschäftigungsart wie veröffentlicht (z. B. `Full-time`), sofern von der Quelle bereitgestellt. nullable: true companies: $ref: '#/components/schemas/search_result_company' search_result_company: type: object description: Das Unternehmen, mit dem der Datensatz verknüpft ist. properties: domain_search_id: type: string format: uuid description: >- Pubrio-Unternehmenskennung. Übergeben Sie sie an `companies` bei jeder Suche oder an Company Lookup. company_name: type: string description: Unternehmensname. linkedin_name: type: string nullable: true description: LinkedIn-Unternehmens-Slug (der Teil nach `linkedin.com/company/`). country_code: type: string nullable: true description: ISO-3166-1-Alpha-2-Code des Unternehmenshauptsitzes. company_url: type: string nullable: true description: URL der Unternehmenswebsite. domain: type: string description: Unternehmensdomain, normalisiert (`stripe.com`). logo_url: type: string nullable: true description: URL des Unternehmenslogos. 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 ````