REST + MCP

Öffentliche API-Referenz

Lesende REST-Endpunkte für Stellenangebote und Gehaltsdaten rund um Ökotrophologie und Ernährungswissenschaften. Für den direkten Abruf durch Agenten gebaut, mit OpenAPI-3.1-Spezifikation und kopierbaren curl-Beispielen.

OpenAPI 3.1Kein API-Key30 Anfragen / 60 sv1 stabil

Schnellstart

Kein API-Key. Gleiche Antwortstrukturen wie die MCP-Tools. 30 Anfragen pro 60 Sekunden pro IP.

GETDie 20 neuesten Stellen auflisten

bash

curl "https://oekotrophologie-jobs.de/api/v1/jobs?sort=newest"

GETEine Stelle per Slug abrufen

bash

curl "https://oekotrophologie-jobs.de/api/v1/jobs/apetito-oekotrophologe-qualitaetsmanagement-abc123"

GETGehaltsübersicht abrufen

bash

curl "https://oekotrophologie-jobs.de/api/v1/salaries?dimension=overview"

Filter für /api/v1/jobs

Alle Filter sind Query-Parameter und lassen sich frei kombinieren (UND-Logik). Listen-Felder akzeptieren kommagetrennte Werte. Die Parameternamen sind englisch, weil sie die Datenbankspalten spiegeln; die Werte sind deutsche Slugs.

GET /api/v1/jobsQuery-Parameter

Name	Typ	Beispiel	Beschreibung
q	string	ernährungsberatung	Volltextsuche über Titel, Beschreibung und Arbeitgeber. ö/oe gleichwertig.
page	integer	1	Seitennummer; 20 Stellen pro Seite.
sort	enum	newest	newest \| salary \| relevance
locationType	enum	hybrid	remote (Homeoffice) \| hybrid (teilweise Homeoffice) \| onsite (vor Ort)
employmentType	enum	full-time	full-time (Vollzeit) \| part-time (Teilzeit) \| contract (befristet) \| freelance (freiberuflich)
seniority	enum	mid	junior (Berufseinstieg) \| mid (mit Berufserfahrung) \| senior \| lead \| staff \| principal
salaryMin	integer	40000	Mindestgehalt, Jahresbrutto in EUR.
salaryMax	integer	65000	Maximalgehalt, Jahresbrutto in EUR.
agenticFrameworks	comma-list	qualitaetsmanagement	Fachbereiche (14 Slugs), z. B. qualitaetsmanagement, klinische-ernaehrung, ernaehrungsberatung-ernaehrungstherapie, gemeinschaftsverpflegung, produktentwicklung.
aiInfrastructure	comma-list	kliniken-reha,catering-gv	Arbeitgeber-Typen (11 Slugs), z. B. lebensmittelindustrie, kliniken-reha, behoerden, forschung-hochschulen, beratungspraxen.
techStack	comma-list	haccp,ifs-food	Qualifikationen als Slugs: Kenntnisse und Zertifikate wie haccp, ifs-food, lebensmittelrecht, sensorik, dge-zertifikat, paragraf-20-sgb-v.

Rate-Limits

REST-API

30Anfragen / 60 s

REST-Endpunkte: 30 Anfragen pro 60 Sekunden pro IP. Eine 429-Antwort heißt: Limit erreicht. 60 Sekunden warten und erneut versuchen.

MCP-Tools

60Anfragen / 60 s

MCP-Tools: 60 Anfragen pro 60 Sekunden pro IP, getrennt je Tool (search_jobs, get_job, get_salaries).

429-Antworten enthalten einen Retry-After-Header. Bitte beachten.

Antwort-Envelope

Erfolg

Erfolgreiche Antworten tragen einen `data`-Schlüssel. Listen-Antworten ergänzen `meta` mit den Feldern `total`, `page` und `per_page`.

json

{
  "data": [
    { "slug": "apetito-oekotrophologe-qualitaetsmanagement-abc123", ... }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "per_page": 20
  }
}

Fehler

Fehler liefern `{ "error": { "code": "...", "message": "..." } }` mit einem der stabilen Codes weiter unten.

json

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Stelle nicht gefunden"
  }
}

MCP-Tools

Dieselben Daten gibt es als drei MCP-Tools. Server-URL für jeden MCP-fähigen Client (Streamable HTTP, ohne Authentifizierung): https://oekotrophologie-jobs.de/api/mcp. Einrichtungsanleitungen für Claude Desktop, Claude Code, ChatGPT, Cursor und Windsurf stehen im Agent-Skill connect-mcp.

POST /api/mcp3 Tools

Tool	Eingabe	Liefert
search_jobs	q, location, locationType, seniority, salaryMin, agenticFrameworks (Fachbereiche), aiInfrastructure (Arbeitgeber-Typen), techStack (Qualifikationen), page, sort	Kompakte Job-Objekte (ohne HTML-Beschreibung).
get_job	slug	Vollständiges Stellenangebot inklusive HTML-Beschreibung.
get_salaries	dimension, slug (optional; nur country, infrastructure, tech-stack, framework)	Gehaltsauswertung für die gewählte Dimension.

Einrichtungsanleitung (connect-mcp Skill) öffnen

Fehlercodes

application/jsonStabil

Code	HTTP	Bedeutung
BAD_REQUEST	400	Ungültige Query-Parameter oder ungültiger Request-Body. Details stehen im message-Feld.
NOT_FOUND	404	Ressource mit diesem Slug existiert nicht oder ist nicht veröffentlicht.
RATE_LIMITED	429	Rate-Limit erreicht. Der Retry-After-Header nennt die Sekunden bis zum nächsten Fenster.
INTERNAL_ERROR	500	Serverfehler. Erneut versuchen; bei dauerhaften Problemen an kontakt@oekotrophologie-jobs.de melden.

Changelog

Juni 2026: Start von oekotrophologie-jobs.de. Die Taxonomie-Parameter behalten ihre technischen Namen, tragen aber deutsche Werte: agenticFrameworks = Fachbereiche, aiInfrastructure = Arbeitgeber-Typen, techStack = Qualifikationen. Gehälter in EUR (Jahresbrutto).
Juni 2026: v1 ist stabil. Antwortstrukturen sind eingefroren; neue Felder können hinzukommen, bestehende werden nicht umbenannt oder entfernt.

Interaktive Referenz

Alle Endpunkte durchstöbern und Anfragen direkt hier ausprobieren. Bereitgestellt mit Scalar.

Noch unentschieden?

Karriere-Kompass: Welches Berufsfeld passt zu Ihnen?

10 Fragen, 5 Karriereprofile, passende Stellen direkt dazu.

Zum Karriere-Kompass