# Wie binde ich meine Stellenanzeigen per API in meine eigene Website ein? Neben der gehosteten Karriereseite und dem Job-Widget gibt es einen dritten Weg: Ihre Entwickler holen sich die Stellenanzeigen über die öffentliche recruware API und bauen den Karrierebereich direkt in Ihre bestehende Website ein. Kein iFrame, kein eingebettetes Fremdsystem, sondern echte Seiten in Ihrem Design, unter Ihrer Domain. recruware bleibt dabei das Redaktionssystem. Ihr Team pflegt Stellenanzeigen wie gewohnt in recruware, Ihre Website zeigt automatisch an, was dort veröffentlicht ist. Genau diese Schnittstelle nutzt auch die Karriereseite, die wir für Sie hosten. ## Wann lohnt sich dieser Weg? Eine API-Integration lohnt sich, wenn Ihr Karrierebereich sich exakt wie der Rest Ihrer Website anfühlen soll, wenn Sie eigene Filter, Landingpages oder Kampagnenseiten bauen möchten oder wenn Ihre Stellenanzeigen für Suchmaschinen bestmöglich auf Ihrer eigenen Domain ranken sollen. Sie brauchen dafür Entwicklerkapazität, entweder intern oder über Ihre Webagentur. Wenn Sie schnell starten möchten oder keine Entwickler zur Verfügung haben, sind die gehostete Karriereseite oder das Job-Widget die bessere Wahl. Beide sind ohne Programmierung einsatzbereit. ## Was die Schnittstelle kann Die öffentliche API ist ohne API-Schlüssel nutzbar und liefert alles, was ein Karrierebereich braucht: - alle veröffentlichten Stellenanzeigen für die Übersichtsseite - die vollständigen Details einer einzelnen Stellenanzeige - Ihr Unternehmensprofil inklusive Logo, Benefits und Farben - Ihre Standorte für Filter und Adressangaben - die Annahme von Bewerbungen inklusive Lebenslauf und Anschreiben Bewerbungen, die über die API eingehen, landen in recruware wie jede andere Bewerbung: im richtigen Bewerbungsprozess, mit automatischer Eingangsbestätigung an den Kandidaten. ## Das Bewerbungsformular passt sich jeder Stelle an Wichtig für Ihre Entwickler: Das Bewerbungsformular ist nicht für alle Stellen gleich. Pro Stellenanzeige legen Sie in recruware fest, ob ein Lebenslauf Pflicht ist, ob ein Anschreiben oder ein weiteres Dokument abgefragt wird, ob Telefonnummer und Profil-Links erscheinen und welche individuellen Fragen gestellt werden. Die Detail-Schnittstelle liefert genau diese Regeln mit. Das Formular muss daraus erzeugt werden, statt fest programmiert zu sein. Sonst fehlen bei neuen Stellen plötzlich Felder oder Ihre individuellen Fragen tauchen nicht auf. ## Was Ihre Entwickler von Ihnen brauchen Nur eine einzige Angabe: Ihren Namespace. Das ist der Teil in der Adresse Ihrer recruware Karriereseite hinter `companies.recruware.com/`. Bei `companies.recruware.com/musterfirma` lautet der Namespace also `musterfirma`. Zugangsdaten, Schlüssel oder Tokens sind nicht nötig, da die Schnittstelle ausschließlich öffentliche Daten ausliefert. ## Skill für KI-Agenten Damit die Umsetzung schnell geht, stellen wir eine fertige Anleitung für KI-Programmierassistenten wie Claude Code, Cursor oder Codex bereit. Diese Anleitung nennt sich Skill und beschreibt die komplette Integration: Endpunkte, Datenstruktur, das dynamische Bewerbungsformular, den Versand der Bewerbung, Fehlerbehandlung und Suchmaschinenoptimierung. Der Skill ist bewusst technologieunabhängig geschrieben. Er funktioniert für WordPress, TYPO3, Shopware, React, Next.js, Vue, Laravel, Rails oder jedes andere System, weil er beschreibt, wie die Schnittstelle funktioniert, und nicht, welches Framework Sie einsetzen sollen. Den passenden Befehl dazu finden Sie oben auf dieser Seite im Feld *Mit Agenten umsetzen*. Geben Sie ihn an Ihren Entwickler weiter. Er kopiert ihn in seinen KI-Assistenten, der Assistent lädt die Anleitung und setzt die Integration in Ihrem Projekt um. ## Technische Dokumentation Alle Endpunkte, Felder und Beispielantworten finden Ihre Entwickler in der [API-Dokumentation](https://docs.recruware.com/developers). Dort liegt die Schnittstelle auch als [OpenAPI-Spezifikation](https://docs.recruware.com/openapi.json) bereit, die sich direkt in Tools wie Postman oder in Codegeneratoren importieren lässt. ## Gut zu wissen Es sind nur veröffentlichte Stellenanzeigen über die Schnittstelle erreichbar. Sobald Sie eine Anzeige in recruware offline nehmen, verschwindet sie auch aus Ihrer Website. Umgekehrt erscheint eine neue Anzeige automatisch, ohne dass jemand die Website anfassen muss. Wenn bei einer Stelle eine externe Bewerbungsadresse hinterlegt ist, liefert die Schnittstelle diese mit. Ihre Website sollte in diesem Fall auf die externe Adresse verlinken, statt das eigene Formular anzuzeigen. Der Skill weist Ihre Entwickler darauf hin.