Arbeitgeber-Feed

So funktioniert es

1. Feed bereitstellen. Veröffentlichen Sie Ihre offenen Stellen als JSON unter einer festen https-Adresse auf Ihrer Firmen-Domain, z. B. https://www.ihre-firma.de/stellen.json. Mit dem Feed-Prüfer sehen Sie sofort, welche Stellen wir übernehmen würden.
2. Anmelden. Schreiben Sie uns die Feed-Adresse an kontakt@berufe.de (Details unter Anmeldung).
3. Prüfung durch uns. Wir prüfen die Identität Ihres Unternehmens, richten den Feed ein und senden Ihnen den Link zu Ihrer Statusseite.
4. Laufender Betrieb. Wir rufen den Feed stündlich ab. Neue, geänderte und entfernte Stellen übernehmen wir automatisch; in der Probezeit prüfen wir jede neue Stelle zusätzlich von Hand.

Format

Der Feed ist JSON mit Stellen im Format schema.org/JobPosting — dasselbe Format, das Google for Jobs verwendet. Wir lesen genau diese äußeren Strukturen:

• Array von JobPostings (empfohlen)[ { "@type": "JobPosting", … }, { "@type": "JobPosting", … } ]
• Objekt mit „@graph“{ "@context": "https://schema.org", "@graph": [ { "@type": "JobPosting", … } ] }
• Objekt mit „jobs“{ "jobs": [ { "@type": "JobPosting", … } ] }
• schema.org-ItemList{ "@type": "ItemList", "itemListElement": [ { "@type": "ListItem", "item": { "@type": "JobPosting", … } } ] }
• Einzelnes JobPosting{ "@type": "JobPosting", … }

Bei der ItemList darf jedes Element das JobPosting direkt oder unter item enthalten. Verschachtelte Strukturen darüber hinaus durchsuchen wir nicht. Höchstens 200 Objekte und 2 MB je Feed.

Pflicht- und optionale Felder

Einträge, denen ein Pflichtfeld fehlt, überspringen wir einzeln und nennen den Grund-Code auf Ihrer Statusseite. Alle übrigen Stellen werden normal verarbeitet.

Optionale Felder im Zusammenhang (Ausschnitt eines JobPostings):

{
  "validThrough": "2026-12-31",
  "baseSalary": {
    "@type": "MonetaryAmount",
    "currency": "EUR",
    "value": {
      "@type": "QuantitativeValue",
      "minValue": 3200,
      "maxValue": 3800,
      "unitText": "MONTH"
    }
  },
  "applicationContact": {
    "@type": "ContactPoint",
    "email": "bewerbung@ihre-firma.de"
  },
  "jobLocationType": "TELECOMMUTE"
}

Domain und Bewerbungsweg

Bei der Einrichtung legen wir die Domain Ihres Unternehmens fest, z. B. holz-liebling.de. Feed-Adresse, Bewerbungs-Links und Bewerbungs-E-Mail-Adressen müssen auf dieser Domain oder einer ihrer Subdomains liegen. So stellen wir sicher, dass jede Bewerbung bei Ihnen ankommt.

Ein vorangestelltes mailto: ist erlaubt, Zusätze wie ?subject= nicht. Ohne gültigen Bewerbungsweg überspringen wir die Stelle (bewerbungsweg-fehlt).

Aktualisieren und Entfernen

Abruf

Stündlich. Solange eine Stelle im Feed steht, bleibt sie online; jeder erfolgreiche Abruf verlängert ihre Laufzeit um 7 Tage (höchstens bis validThrough).

Höchstzahl

Standardmäßig bis zu 25 aktive Stellen je Feed (online oder in Prüfung). Ist die Höchstzahl erreicht, überspringen wir weitere Stellen mit dem Code limit und übernehmen sie automatisch, sobald ein Platz frei wird; bereits übernommene Stellen bleiben unverändert. Mehr Stellen sind nach Absprache möglich: Nach der Probezeit vereinbaren wir mit Ihnen gern eine höhere Höchstzahl.

Änderungen

Geänderte Inhalte (Titel, Beschreibung, Ort, Beschäftigungsart, Gehalt) prüfen wir erneut. Bis zur Freigabe bleibt die bisherige Version online. Ein geändertes Bewerbungsziel prüfen wir immer von Hand. PLZ, Bundesland, Remote-Angabe und Befristung übernehmen wir direkt.

Entfernen

Löschen Sie die Stelle aus dem Feed oder setzen Sie validThrough auf ein vergangenes Datum. Die Stelle geht spätestens nach etwa 3 Stunden offline; die Wartezeit schützt vor kurzzeitigen Fehlern in Ihrem Feed. Taucht sie mit derselben ID wieder auf, nehmen wir sie wieder auf.

IDs

Behalten Sie die ID einer Stelle bei. Eine neue ID gilt als neue Stelle: Die alte geht offline, die neue wird erneut geprüft.

Ausfälle

Ein leerer, fehlerhafter oder nicht erreichbarer Feed nimmt keine Stellen offline. Fehlt auf einen Schlag mindestens die Hälfte Ihrer Stellen, halten wir das an und klären es mit Ihnen (einbruch). Ist der Feed länger als 7 Tage nicht abrufbar, laufen Ihre Stellen aus; nach 14 Tagen ohne erfolgreichen Abruf deaktivieren wir den Feed.

Stellen, die wir gesperrt haben, bleiben offline, auch wenn sie weiter im Feed stehen.

Prüfung und Probezeit

Jede neue Stelle und jede inhaltliche Änderung prüfen wir automatisch, unter anderem auf AGG-Konformität, seriöse Angaben und den gesetzlichen Mindestlohn. Unklare Fälle prüft unser Team von Hand, meist innerhalb eines Werktags.

Wir verschicken keine automatischen E-Mails. Den aktuellen Stand sehen Sie jederzeit auf Ihrer Statusseite.

Statusseite

Nach der Einrichtung erhalten Sie von uns einen persönlichen Link zu Ihrer Statusseite. Dort sehen Sie den letzten Abruf und sein Ergebnis, jede Stelle mit Status (online, in Prüfung, offline) und Hinweis sowie die im letzten Abruf übersprungenen Einträge mit Grund-Code.

• Seite: https://www.berufe.de/jobs/arbeitgeber-feed/status/<Token>
• Dieselben Daten als JSON: https://www.berufe.de/api/arbeitgeber-feed/status/<Token>

Der Link funktioniert ohne Anmeldung. Bitte behandeln Sie ihn vertraulich.

Grund-Codes

Übersprungene Einträge kennzeichnen wir mit einem festen Code. Ein übersprungener Eintrag betrifft nur diese eine Stelle; ist sie bereits online, bleibt die bisherige Version bestehen.

Betrifft ein Problem den ganzen Abruf, zeigt die Statusseite einen dieser Codes. Ihre Stellen bleiben dann vorerst unverändert.

Läuft ein Abruf durch, aber nur eingeschränkt, zeigt die Statusseite einen dieser Hinweise. Ihre Stellen werden dabei normal verarbeitet.

Technischer Abruf

Adresse

Feste https://-Adresse auf Ihrer Domain (Port 443) mit gültigem Zertifikat, ohne Anmeldung abrufbar. Höchstens 3 Weiterleitungen, alle innerhalb Ihrer Domain.

Antwort

Status 200, Content-Type: application/json oder application/ld+json, Zeichensatz UTF-8, höchstens 2 MB, vollständig innerhalb von 20 Sekunden.

User-Agent

Mozilla/5.0 (compatible; berufe.de-Arbeitgeber-Feed/1.0; +https://www.berufe.de/jobs/arbeitgeber-feed)
Bitte sperren Sie diesen Abruf nicht durch Bot-Schutz, Captcha oder Cookie-Banner. Unsere IP-Adresse für Freigabelisten nennen wir Ihnen auf Anfrage.

DNS

Bei der Einrichtung merken wir uns Nameserver, Mailserver und den Hosting-Eintrag (CNAME) Ihres Feeds. Ändern sie sich, pausiert der Abruf, bis wir die Änderung bestätigt haben (dns-geaendert). Sagen Sie uns daher vor einem Umzug kurz Bescheid.

Beispiel-Feed

Zwei Stellen im empfohlenen Format (Array). Bewerbungsweg ist hier die url auf einer Subdomain des Arbeitgebers.

[
  {
    "@context": "https://schema.org/",
    "@type": "JobPosting",
    "identifier": {
      "@type": "PropertyValue",
      "name": "Holz-Liebling GmbH",
      "value": "HL-JOB-1"
    },
    "title": "Schreiner / Tischler (m/w/d) – Massivholz-Manufaktur",
    "description": "<p>Du liebst Holz, arbeitest präzise und möchtest Produkte bauen, auf die du wirklich stolz sein kannst? Dann komm zu Holz-Liebling.</p><p>In unserer Massivholz-Manufaktur in Pfaffing fertigen wir hochwertige Schneidebretter, Tischplatten, Möbel und individuelle Produkte aus echtem Holz.</p><p>Aufgaben:</p><ul><li>Fertigung hochwertiger Produkte aus Massivholz</li><li>Zuschnitt, Bearbeitung, Schleifen und Oberflächenvorbereitung</li><li>Arbeiten an modernen Holzbearbeitungsmaschinen</li><li>Montage, Fertigstellung und Qualitätskontrolle</li></ul><p>Anforderungen:</p><ul><li>Abgeschlossene Ausbildung als Schreiner / Tischler (m/w/d) oder vergleichbare Erfahrung in der Holzverarbeitung</li><li>Freude an präziser und sauberer Arbeit</li><li>Selbstständige und zuverlässige Arbeitsweise</li></ul><p>Das bieten wir:</p><ul><li>Arbeiten mit echtem Massivholz statt Spanplatten-Serie</li><li>Moderne Maschinen und eine gut ausgestattete Werkstatt</li><li>Kleines Team und kurze Entscheidungswege</li></ul>",
    "datePosted": "2026-09-18",
    "employmentType": [
      "FULL_TIME",
      "PART_TIME"
    ],
    "hiringOrganization": {
      "@type": "Organization",
      "name": "Holz-Liebling GmbH",
      "sameAs": "https://www.holz-liebling.de"
    },
    "jobLocation": {
      "@type": "Place",
      "address": {
        "@type": "PostalAddress",
        "postalCode": "83539",
        "addressLocality": "Pfaffing",
        "addressRegion": "Bayern",
        "addressCountry": "DE"
      }
    },
    "directApply": true,
    "url": "https://personal.holz-liebling.de/jobs/schreiner-tischler-m-w-d-massivholz-manufaktur-1"
  },
  {
    "@context": "https://schema.org/",
    "@type": "JobPosting",
    "identifier": {
      "@type": "PropertyValue",
      "name": "Holz-Liebling GmbH",
      "value": "HL-JOB-2"
    },
    "title": "Mitarbeiter Warenausgang / Versand (m/w/d) – Massivholz-Manufaktur",
    "description": "<p>Du arbeitest gerne sorgfältig, packst mit an und möchtest dafür sorgen, dass hochwertige Holzprodukte perfekt unsere Manufaktur verlassen? Dann komm zu Holz-Liebling.</p><p>Aufgaben:</p><ul><li>Qualitätskontrolle unserer fertigen Holzprodukte vor dem Versand</li><li>Kleinere Nacharbeiten wie Schleifen, Ölen und Ausbessern</li><li>Produkte sorgfältig und transportsicher verpacken</li><li>Fertige Sendungen für Paketdienst und Spedition bereitstellen</li></ul><p>Anforderungen:</p><ul><li>Du musst dafür kein gelernter Schreiner sein. Wichtiger ist uns, dass du sorgfältig arbeitest und ein Auge für Qualität hast.</li><li>Erfahrung im Versand, Lager oder Handwerk ist von Vorteil – aber kein Muss.</li></ul><p>Das bieten wir:</p><ul><li>Abwechslungsreiche Aufgaben zwischen Qualitätskontrolle, Nacharbeit und Versand</li><li>Ein kleines Team mit kurzen Entscheidungswegen</li><li>Langfristige Perspektive in einem wachsenden Unternehmen</li></ul>",
    "datePosted": "2026-09-21",
    "employmentType": [
      "FULL_TIME",
      "PART_TIME"
    ],
    "hiringOrganization": {
      "@type": "Organization",
      "name": "Holz-Liebling GmbH",
      "sameAs": "https://www.holz-liebling.de"
    },
    "jobLocation": {
      "@type": "Place",
      "address": {
        "@type": "PostalAddress",
        "postalCode": "83539",
        "addressLocality": "Pfaffing",
        "addressRegion": "Bayern",
        "addressCountry": "DE"
      }
    },
    "directApply": true,
    "url": "https://personal.holz-liebling.de/jobs/mitarbeiter-warenausgang-versand-m-w-d-massivholz-manufaktur-2"
  }
]

Feed testen

Prüfen Sie Ihren Feed vor der Anmeldung: Wir rufen ihn einmal so ab wie später stündlich und zeigen, welche Stellen wir übernehmen würden und warum einzelne Einträge übersprungen werden. Dabei wird nichts angemeldet oder veröffentlicht.

Wir speichern weder die Adresse noch den Inhalt Ihres Feeds. Zum Schutz vor Missbrauch zählen wir nur die Prüfungen (höchstens 10 pro Stunde) mit einem nicht umkehrbaren Kürzel (Hash) Ihrer IP-Adresse. Inhaltlich prüfen wir Ihre Stellen erst nach der Anmeldung.