# Die Joobs-API: Ihre Stellenanzeigen auf der eigenen Website, ohne iframe

> Ihre Stellenanzeigen als JSON, im eigenen Design auf der eigenen Domain. Die Routen, der Schlüssel, die Limits und was sich im Recruiting ändert.

- **Author:** David Verbustel
- **Category:** ETFY8wgbX6Y616hUa4Fq
- **Published:** 2026-04-20
- **Language:** de

Die Karriereseite vieler belgischer KMU zeigt die Stellenanzeigen von jemand anderem. Ein Rahmen mitten in der Website, mit eigenen Schriften, eigenem Scrollbalken und eigenem Bewerbungsbutton. Technisch funktioniert das. Die besuchende Person merkt trotzdem, dass sie gerade die Website gewechselt hat, ohne geklickt zu haben.
Es gibt jetzt einen anderen Weg. Die öffentliche API von Joobs gibt Ihnen Ihre Stellenanzeigen als Daten zurück, und Sie stellen sie selbst dar: Ihr Design, Ihre Domain, Ihr Template.
## Was der iframe wirklich kostet
Ein iframe ist eine Seite in der Seite. Diese Grenze hat vier Folgen, und keine davon steht auf einer Rechnung — genau deshalb übersieht man sie so leicht.
- Ihr Design endet am Rahmen. Schriften, Farben und Abstände überschreiten die Kante nicht. Der kommerziellste Bereich Ihrer Website ist ausgerechnet der, der nicht nach Ihnen aussieht.

- Mobil zahlt doppelt. Ein Rahmen, der innerhalb einer scrollenden Seite scrollt. Auf dem Smartphone verliert die besuchende Person den Faden — oder den Button.

- Die Sichtbarkeit wandert ab. Inhalt in einem iframe gehört nicht zu Ihrer Domain. Ihre Stellenanzeigen arbeiten für das Ranking der ausliefernden Website, nicht für Ihres.

- Sie messen nichts. Ihr Analyse-Tool endet an der Kante. Sie wissen, wie viele Menschen die Seite gesehen haben, nicht wie viele eine Anzeige gelesen haben.


## Was die API macht, in einem Satz
Sie liefert Ihre veröffentlichten Stellenanzeigen als Daten zurück, damit Ihre Website sie so darstellt wie alles andere auch.
Kein Widget zum Einbauen, kein Drittanbieter-Skript, das im Browser Ihrer Besucher lädt. Eine HTTP-Anfrage, JSON zurück, und die Darstellung gehört vollständig Ihnen.
curl -H "x-api-key: joobs_ihr_schluessel" \
  https://europe-west1-leipzig-04103.cloudfunctions.net/api/v1/jobsDie Antwort enthält Ihre aktiven Stellenanzeigen: Titel, Beschreibung, Standorte, Vertragsarten, Unternehmensgröße und die Berufsbezeichnungen in den vier Sprachen der Website — Französisch, Englisch, Niederländisch, Deutsch. Sie entscheiden, was Sie zeigen und wie.
## Die vier Routen
RouteWas sie zurückgibtWofür Sie sie nutzenGET /v1/healthDen Status des DienstesIhr MonitoringGET /v1/jobsIhre öffentlichen Anzeigen, paginiertDie Liste auf Ihrer KarriereseiteGET /v1/jobs/:idEine vollständige AnzeigeDie DetailseitePOST /v1/jobs/:id/applyDie EingangsbestätigungIhr eigenes BewerbungsformularDie Liste paginieren Sie mit limit und offset, höchstens hundert Anzeigen pro Aufruf. Jede Anzeige trägt außerdem ihre Adresse auf Joobs, falls Sie lieber verlinken als eigene Detailseiten zu bauen.
Die Bewerbungsroute nimmt eine Multipart-Übermittlung entgegen: Vorname, Name, E-Mail, Nachricht und einen Lebenslauf als PDF, DOC oder DOCX bis 10 MB. Sie antwortet mit einer Bewerbungs-ID.
## Der Schlüssel, und was er öffnet
Die Authentifizierung passt in einen Header, x-api-key. Der Schlüssel gehört zu genau einer Organisation: Er erreicht Ihre Anzeigen und sonst nichts, und kein anderer Schlüssel erreicht Ihre. Es gibt keine Organisations-ID mitzugeben, also auch keine Möglichkeit, den falschen Bereich zu treffen.
Joobs speichert den Schlüssel selbst nie, nur seinen Fingerabdruck. Der Entzug wirkt sofort: Ein deaktivierter Schlüssel scheitert beim nächsten Aufruf.
Das Standardkontingent liegt bei tausend Anfragen pro Tag. Jede Antwort sagt Ihnen, was übrig ist, in den Headern X-RateLimit-Limit und X-RateLimit-Remaining — genug, um den Verbrauch im Blick zu behalten, ohne selbst zu zählen.
Nutzen Sie den Schlüssel von Ihrem Server aus, nie aus dem Browser. Ein Schlüssel im clientseitigen JavaScript ist ein öffentlicher Schlüssel: Jede besuchende Person liest ihn in den Entwicklertools. Gehen Sie über eine Route auf Ihrer eigenen Website, die die API aufruft und das Ergebnis zurückgibt.
## Was die API noch nicht leistet
Vier Grenzen sollten Sie kennen, bevor Sie die erste Zeile Code schreiben, denn sie prägen den Aufbau Ihrer Seite.
- Gefiltert wird bei Ihnen. Die Liste kennt Paginierung, aber keine Filter nach Beruf, Standort oder Vertragsart. Sie holen Ihre Anzeigen und sortieren sie auf der eigenen Website — was ohnehin schneller ist, sobald es ein paar Dutzend sind.

- Die API liest Anzeigen, sie schreibt sie nicht. Veröffentlichen, Bearbeiten und Offlinenehmen bleiben in Joobs. Die einzige schreibende Route ist die für Bewerbungen.

- Push-Benachrichtigungen gibt es noch nicht. Nichts meldet Ihrer Website, dass sich eine Anzeige geändert hat; Sie rufen ab, in dem Intervall, das Ihnen passt.

- Bewerbende erhalten von Joobs keine Eingangsbestätigung. Die Bestätigung zeigt Ihr Formular. Die Benachrichtigung geht sehr wohl raus — an Sie, nicht an die bewerbende Person.


## Was sich im Recruiting ändert
Entwickelnde sehen eine Integration. Wer rekrutiert, gewinnt drei konkrete Dinge.
Ihre Stellenanzeigen arbeiten endlich für Ihre Domain. Anzeigenseiten, die Ihre Website selbst ausliefert, sind Seiten Ihrer Website: Sie werden unter Ihrem Namen indexiert, sie stärken Ihr Ranking, und sie bleiben, wenn Sie das Tool wechseln.
Kandidat:innen wechseln unterwegs nicht mehr die Website. Der visuelle Bruch zwischen Karriereseite und Bewerbungsformular ist ein klassischer Absprungpunkt. Er verschwindet, sobald Sie alles selbst darstellen.
Bewerbungen laufen weiterhin an einer Stelle zusammen. Eine über die API eingereichte Bewerbung landet in Ihrem gewohnten Joobs-Dashboard, mit E-Mail-Benachrichtigung und Lebenslauf, genau wie eine Bewerbung auf Joobs selbst. Sie trägt lediglich ein Herkunfts-Label, damit Sie wissen, woher sie kommt.
Eine gelungene Integration fällt nicht auf. Besuchende sollten nie herausfinden können, welches Tool Ihre Stellenanzeigen verwaltet — weder beim Betrachten der Seite noch beim Bewerben.
## Wo Sie anfangen
Die vollständige Dokumentation — Authentifizierung, Routenreferenz, Datenschema, Limits — finden Sie auf der Entwicklerseite. Dort stehen die Beispielaufrufe und die Details zu jedem gelieferten Feld.
Der API-Zugang gehört zum Premium-Plan. Den Schlüssel richten Sie gemeinsam mit unserem Team ein, das ihn Ihrer Organisation zuordnet und Ihr Kontingent festlegt.
Brauchen Sie Entwickelnde, um die API zu integrieren?Ja, aber nicht lange. Für eine klassische Karriereseite — die Anzeigenliste und eine Detailseite — rechnen Sie mit einem halben Tag für die Person, die Ihre Website ohnehin betreut. Die API liefert gewöhnliches JSON, ohne besondere Abhängigkeit und ohne Bibliothek zum Installieren.
Was passiert, wenn Sie eine Anzeige offline nehmen?Sie verschwindet beim nächsten Aufruf aus der Antwort. Wenn Ihre Website die Ergebnisse zwischenspeichert — was wir empfehlen, fünf bis fünfzehn Minuten — bleibt die Anzeige sichtbar, bis der Cache abläuft. Das ist die einzige Verzögerung.
Wo landen Bewerbungen über die API, und wer verarbeitet die Daten?In Ihrem Joobs-Dashboard, neben allen anderen. Der Lebenslauf liegt am selben Ort, die Benachrichtigung geht an dieselbe Adresse, und das Kandidatenkonto wird angelegt — oder wiederverwendet, wenn sich die Person schon einmal bei Ihnen beworben hat. Kein zusätzlicher Drittanbieter ist beteiligt.
Ist die API in meinem Abonnement enthalten?Sie gehört zum Premium-Plan, zusammen mit der Synchronisation zu Ihrem ATS und zu Ihrer Website. Wenn Sie einen anderen Plan haben, sprechen Sie unser Team an: Schlüssel und Kontingent werden gemeinsam eingerichtet.

---
*Source: [Joobs.be](https://joobs.be/de/blog/joobs-api-stellenanzeigen-auf-der-eigenen-website)*