Für Entwickler

Schnittstelle und Widgets

Stellenanzeigen von aussen anlegen und pflegen, die eigenen Stellen auf der Firmenwebsite anzeigen oder die Jobsuche der Region in einen Blog einbinden – alles über eine schlanke JSON-Schnittstelle.

Auf einen Blick

Antworten und Feldnamen in JSON, auf Deutsch – englische Namen werden zusätzlich verstanden.
Die öffentliche Hälfte braucht keine Anmeldung und liefert nur veröffentlichte Stellen.
Für den eigenen Bestand genügt ein Token aus dem Arbeitgeber-Dashboard.
Kein Vertrag, keine Freischaltung, keine Kosten – wie alles andere hier auch.

Basisadresse: https://stellenangebote-rosenheim.de/api/v1/ · Selbstauskunft der Schnittstelle

Öffentlich – ohne Anmeldung

Nur lesend, nur aktive Anzeigen, keine personenbezogenen Kontaktdaten. Das ist die Grundlage der Widgets.

	Adresse	Zweck
GET	`/api/v1/oeffentlich/stellen`	Stellenliste mit Suche und Blätterung
GET	`/api/v1/oeffentlich/filter`	Kategorien, Beschäftigungsarten, Orte
GET	`/api/v1/oeffentlich/arbeitgeber`	Arbeitgeber mit aktiven Stellen

Parameter von /oeffentlich/stellen

`suche`	Freitext in Titel, Firma, Beschreibung und Ort
`kategorie`	eine der Kategorien aus `/oeffentlich/filter`
`art`	Beschäftigungsart, etwa `Vollzeit`
`ort`	Teil eines Ortsnamens
`arbeitgeber`	Nummer eines Arbeitgebers – nur dessen Stellen
`seite`, `limit`	Blätterung; `limit` höchstens 50

Beispiel

curl "https://stellenangebote-rosenheim.de/api/v1/oeffentlich/stellen?suche=pflege&limit=2"

Antwort

{
  "gesamt": 4,
  "seite": 1,
  "pro_seite": 2,
  "seiten": 2,
  "stellen": [
    {
      "id": 25,
      "titel": "Pflegefachkraft (m/w/d)",
      "firma": "Gesundheitswelt Chiemgau AG",
      "ort": "Rosenheim",
      "kategorie": "Gesundheit & Soziales",
      "beschaeftigung": "Vollzeit",
      "gehalt": "",
      "veroeffentlicht": "2026-08-31T18:31:59+02:00",
      "auszug": "Über uns Die Gesundheitswelt Chiemgau AG …",
      "logo": "https://stellenangebote-rosenheim.de/uploads/logos/…jpg",
      "url": "https://stellenangebote-rosenheim.de/stellen/pflegefachkraft-m-w-d-…-25"
    }
  ]
}

Mit Token – der eigene Bestand

Ein Arbeitgeber kann damit seine Stellenanzeigen anlegen, ändern und löschen, ohne sich anzumelden – etwa aus dem eigenen Bewerbermanagement heraus.

	Adresse	Zweck
GET	`/api/v1/profil`	eigenes Profil und Kennzahlen
GET	`/api/v1/stellen`	eigene Stellen, auch Entwürfe
POST	`/api/v1/stellen`	Stelle anlegen
GET	`/api/v1/stellen/{id}`	einzelne Stelle
PATCH	`/api/v1/stellen/{id}`	Stelle ändern (PUT geht auch)
DELETE	`/api/v1/stellen/{id}`	Stelle löschen

Anmeldung

Das Token steht im Arbeitgeber-Dashboard und muss dort einmal freigeschaltet werden. Es ist wie ein Passwort zu behandeln.

Authorization: Bearer <Token>

Wo sich keine Kopfzeilen setzen lassen, gehen ersatzweise auch X-Api-Token: <Token> oder ?token=<Token>.

Stelle anlegen

curl -X POST "https://stellenangebote-rosenheim.de/api/v1/stellen" \
  -H "Authorization: Bearer <Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "titel": "Elektroniker Betriebstechnik (m/w/d)",
    "beschreibung": "Wartung und Instandhaltung von Schaltanlagen.",
    "kategorie": "Handwerk & Produktion",
    "beschaeftigung": "Vollzeit",
    "ort": "Rosenheim",
    "gehalt": "42.000 - 52.000 EUR",
    "bewerbung_email": "bewerbung@meine-firma.de",
    "status": "Aktiv"
  }'

Pflicht sind titel und beschreibung. Fehlt etwas oder passt ein Wert nicht, antwortet die Schnittstelle mit 422 und nennt die erlaubten Werte.

Felder

`titel` *	Stellentitel
`beschreibung` *	Fliesstext; einfache Formatierung wie im Formular
`kategorie`	IT & Technik · Handwerk & Produktion · Kaufmännisch & Verwaltung · Gesundheit & Soziales · Gastronomie & Tourismus · Vertrieb & Marketing · Bildung & Erziehung · Logistik & Transport · Sonstiges
`beschaeftigung`	Vollzeit · Teilzeit · Minijob · Ausbildung · Praktikum · Werkstudent · Freelance
`status`	Entwurf · Aktiv · Pausiert · Abgelaufen – ohne Angabe `Entwurf`
`ort`, `gehalt`	frei
`anforderungen`, `benefits`	frei
`bewerbung_email`	Adresse für Bewerbungen
`bewerbung_url`	ist sie gesetzt, führt der Bewerben-Knopf dorthin
`auto_refresh`	wahr oder falsch; die Höchstzahl gilt wie im Dashboard

Rückmeldungen

200 / 201	erledigt
401	Token fehlt, stimmt nicht oder ist abgeschaltet
404	Endpunkt unbekannt oder die Stelle gehört zu einem anderen Konto
405	Verfahren an dieser Adresse nicht vorgesehen
409	Grenze für Auto-Refresh erreicht
422	Angaben unvollständig oder unzulässig – `einzelheiten` nennt den Grund

Widgets zum Einbinden

Ein Schnipsel, kein Framework, keine Abhängigkeiten. Das Widget übernimmt Schrift und Farben der Seite, in die es eingebunden wird.

Stellen der Region – etwa für einen Blog

<div data-sar-stellen data-suche="1" data-anzahl="10"></div>
<script src="https://stellenangebote-rosenheim.de/assets/js/widget.js" defer></script>

Nur die eigenen Stellen – für die Firmenwebsite

<div data-sar-stellen data-arbeitgeber="54"></div>
<script src="https://stellenangebote-rosenheim.de/assets/js/widget.js" defer></script>

Die Nummer steht im Arbeitgeber-Dashboard im fertigen Einbettungscode.

Angaben am Behälter

`data-arbeitgeber`	nur die Stellen dieses Arbeitgebers
`data-suche="1"`	Suchformular über der Liste
`data-anzahl="10"`	Stellen je Seite, höchstens 50
`data-ort`, `data-kategorie`	fest auf Ort bzw. Kategorie beschränken
`data-stil="aus"`	kein mitgeliefertes Stylesheet

Gestaltung

Das Widget schreibt absichtlich in das normale Dokument und nicht in ein Shadow DOM – ein Shadow DOM würde die Gestaltung Ihrer Seite gerade aussperren. Das mitgelieferte Stylesheet setzt nur Abstände und Anordnung; Schriftart und Farben kommen von Ihnen. Zum Nachgestalten dienen die Klassen sar-widget, sar-liste, sar-stelle, sar-titel, sar-meta, sar-auszug und sar-blaettern.

Vorschau in neutraler Umgebung

Token holen und loslegen

Arbeitgeberprofil anlegen, im Dashboard die Schnittstelle freischalten – fertig.

Kostenlos registrieren