Zum Inhalt springen

MirageScouting REST API

Offene Stellen als API

Zwei lesende Endpunkte über der öffentlichen Jobbörse: dieselben Stellen, Unternehmen und Gehälter wie auf den /jobs-Seiten. Kein Schlüssel und keine Anmeldung.

Schnellstart

Eine Anfrage

Remote-Produktstellen, fünf pro Seite:

curl "https://www.miragescouting.de/api/v1/jobs?query=product&workMode=REMOTE&limit=5"

Jede Stelle hat eine url zu ihrer öffentlichen Seite; gib nextCursor als cursor für die nächste Seite mit.

Referenz

Endpunkte

Erzeugt aus der OpenAPI-Beschreibung, damit diese Liste und die Spezifikation nie voneinander abweichen. Die Parameterbeschreibungen sind Englisch, wie die Spezifikation.

GET/api/v1/jobslistJobs

Search open roles

Lists open roles on the public job board, newest first; sponsored roles are pinned on the first page and carry a non-null `promotion`. Filters combine with AND; text filters are case-insensitive substring matches. Page with `nextCursor`.

Parameter

queryquery · string, ≤ 200 chars
Text in the job title.
companyquery · string, ≤ 200 chars
Text in the company name.
locationquery · string, ≤ 200 chars
Text in the location, e.g. Berlin.
workModequery · REMOTE | HYBRID | ONSITE
Where the work happens.
seniorityquery · string, ≤ 50 chars
Seniority level, e.g. SENIOR.
employmentTypequery · string, ≤ 50 chars
Employment type, e.g. FULL_TIME.
cursorquery · string, ≤ 512 chars
The `nextCursor` of the previous page.
limitquery · integer, 1–50, default 20
Page size (default 20).

Antworten

  • 200 — A page of open roles.
  • 400 — Invalid query parameters (`invalid_request`).
  • 429 — Rate limit exceeded (`rate_limited`).
  • 503 — The job board is temporarily unavailable (`upstream_unavailable`).

GET/api/v1/jobs/{jobId}getJob

Get one open role

Returns one open role with its full description, benefits and company details. 404 when the role does not exist or is not public (the API never says which).

Parameter

jobId *path · uuid
The job's id (from listJobs).

Antworten

  • 200 — The open role.
  • 400 — jobId is not a UUID (`invalid_request`).
  • 404 — No public job with this id (`not_found`).
  • 429 — Rate limit exceeded (`rate_limited`).
  • 503 — The job board is temporarily unavailable (`upstream_unavailable`).

Fehler

Eine Fehlerform

Jeder Fehler hat die Form { "error": { "code", "message", "details"? } }.

  • 400 · invalid_request

    Ein Parameter ist ungültig oder außerhalb des erlaubten Bereichs; details nennt das Feld.

  • 404 · not_found

    Keine öffentliche Stelle mit dieser ID. Die API verrät nicht, ob sie existiert, aber nicht öffentlich ist.

  • 429 · rate_limited

    Zu viele Anfragen; warte die Sekunden aus Retry-After ab.

  • 503 · upstream_unavailable

    Die Jobbörse ist kurz nicht erreichbar; versuch es nach Retry-After Sekunden erneut.

Ratenlimits

120 Anfragen pro Minute und IP

Jede Antwort trägt die IETF-Felder RateLimit und RateLimit-Policy sowie RateLimit-Limit / -Remaining / -Reset, damit ein Client langsamer wird, bevor er abgewiesen wird. Ein 429 trägt Retry-After in Sekunden.