Skip to main content
POST
Nach Stellenanzeigen 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
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-Standortcodes (cca2), die aus den Stellenergebnissen ausgeschlossen werden sollen. Gültige Codes finden Sie in den location-Endpunkten im Filters-Tab.

Beispiel:
location_ids
integer[]

Land der Stellenanzeige nach Pubrio location_id (Endpunkt Locations; auch auf jeder Zeile vorhanden). Alternative zu locations.

Beispiel:
company_locations
string[]

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

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

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

Beispiel:
search_term
string

Eine Wortfolge, nach der die Ergebnisse gefiltert werden sollen.

Beispiel:

"pubrio"

search_terms
string[]

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.

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

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.

Beispiel:
seniority_ranks
enum<integer>[]

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).

Verfügbare Optionen:
1,
2,
3,
4,
5
Beispiel:
posted_dates
string[]

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

Beispiel:
launch_dates
string<date>[]

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.

Required array length: 1 - 2 elements
Beispiel:
created_at
string<date-time>

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.

Beispiel:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
Standard:false

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.

Beispiel:

true

is_ascending_order
boolean
Standard:false

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.

Beispiel:

false

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 Stellensuche des Unternehmens.

metadata
object

Anfragekontext.

data
object
Zuletzt geändert am 4. September 2026