Geändert am: 16 Aug, 2026

Diese Anleitung bietet eine Dokumentation für die Integration mit der Jooble REST API. Unten finden Sie Informationen zur Generierung von API-Keys, zu Endpunkten, Anfrageparametern, JSON-Formaten und gängigen Antwortcodes. Wenn Sie die Integration noch nicht gestartet haben, lesen Sie bitte unsere Schritt-für-Schritt-Anleitung unter So verbinden Sie sich nach Erhalt des Schlüssels mit der Jooble REST API.

Wichtige regionale Einschränkungen:
Jede Jooble-Domain (Land) erfordert einen eigenen, eindeutigen REST-API-Key. Beispielsweise bietet ein auf jooble.org generierter Key ausschließlich Zugriff auf US-Stellenanzeigen. Um Stellenangebote für andere Länder abzufragen, registrieren Sie sich bitte und fordern Sie einen API-Key auf der entsprechenden regionalen Domain an (z. B. uk.jooble.org/api/about für Großbritannien oder de.jooble.org/api/about für Deutschland).
API-Nutzungslimits:
Der kostenlose REST-API-Tarif enthält ein Gesamtlimit von 500 Anfragen pro Key für die gesamte Laufzeit (dies ist ein absolutes Lifetime-Kontingent, kein monatliches Limit).

So erhalten Sie einen Jooble REST API Key

  1. Registrieren Sie ein Konto auf dem Jooble-API-Portal für Ihr Zielland (z. B. de.jooble.org/api/about).
  2. Kopieren Sie den generierten API-Key nach der Registrierung und bewahren Sie ihn sicher auf.

Anfrageparameter (JSON-Body)

Die Nutzlast der Anfrage (Payload) muss im Format application/json mit den folgenden Parametern gesendet werden:

  • keywords(String, erforderlich): Keywords oder Stellenbezeichnungen, nach denen gesucht werden soll.
  • location(String, erforderlich): Name des Standorts (Stadt, Region oder Land).
  • radius(String, optional): Suchradius in Kilometern. Zulässige Werte: 0, 4, 8, 16, 26, 40, 80.
  • salary(Integer, optional): Mindestlohn.
  • page(Integer, optional): Seitennummer der Suchergebnisse (Standardwert ist 1).
  • ResultOnPage(Integer, optional): Anzahl der pro Seite zurückgegebenen Stellenanzeigen.
  • SearchMode(Integer, optional): Suchalgorithmus-Modus (Standardwert ist 0).
  • companysearch(Boolean, optional):
    • true – Keywords gezielt in Unternehmensnamen suchen.
    • false – Keywords in Stellenbezeichnungen und Beschreibungen suchen.

Antwortparameter

Nach einer erfolgreichen Anfrage gibt der Server ein JSON-Objekt zurück, das Folgendes enthält:

  • totalCount(Integer): Gesamtzahl der gefundenen passenden Stellenanzeigen.
  • jobs(Array): Liste von Stellenanzeigen-Objekten, die Folgendes enthalten:
    • id(Integer): Eindeutige Kennung der Stellenanzeige.
    • title(String): Stellenbezeichnung.
    • location(String): Standort der Stelle.
    • snippet(String): Kurze Beschreibung (Snippet), die in den Suchergebnissen angezeigt wird.
    • salary(String): Lohnspanne, formatiert als {min} – {max} {currency}.
    • source(String): Quelle der Veröffentlichung des Stellenangebots.
    • type(String): Beschäftigungsart (z. B. Vollzeit, Teilzeit).
    • link(String): Direkter Link zur Stellenanzeige auf Jooble.
    • company(String): Name des Unternehmens.
    • updated(String): ISO-Zeitstempel der letzten Aktualisierung des Stellenangebots.

Beispiele für JSON-Anfragen und -Antworten

Beispiel für eine Anfrage-Payload:

POST https://de.jooble.org/api/{api_Key} Content-Type: application/json { "keywords": "Sales Manager, Administrator", "location": "Kyiv", "radius": "80", "page": "1", "companysearch": "false" }

Beispiel für eine erfolgreiche Antwort (200 OK):

{ "totalCount": 1, "jobs": [ { "id": 1234567890, "title": "Sales Manager", "location": "Kyiv", "snippet": "Dies ist eine großartige Gelegenheit, unserem Team beizutreten...", "salary": "17.600 UAH", "source": "jooble", "type": "Full-time", "link": "https://ua.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000" } ] }

HTTP-Antwort- und Fehlercodes

  • 200 OK: Die Anfrage war erfolgreich und hat Daten zurückgegeben
  • 403 Access Denied: Ungültiger oder fehlender API-Key
  • 404 Not Found: Der angeforderte Endpunkt oder die Ressource existiert nicht

Code-Implementierungsbeispiele

Sie können die Jooble REST API mit Programmiersprachen wie PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby und anderen integrieren. Gebrauchsfertige Code-Snippets und Implementierungsleitfäden finden Sie auf unserer Jooble-API-Dokumentationsseite.