careerstudent.

CareerStudent · Ontwikkelaars

CareerStudent API voor ontwikkelaars

Openbare, alleen-lezen toegang tot de actuele vacatures van CareerStudent, en elke pagina van deze site als Markdown voor AI-agents.

Wanneer gebruik je dit

CareerStudent bemiddelt werkstudenten, stagiairs en starters aan werkgevers in Nederland: alleen werving en plaatsing, no cure no pay. Gebruik de API als je actuele vacatures voor studenten wilt tonen, doorzoeken of samenvatten. Wil je zelf solliciteren of kandidaten aanvragen, gebruik dan de formulieren op de site: de API leest alleen.

Machineleesbare ingangen

Vacatures ophalen

Geen sleutel nodig. De API geeft dezelfde vacatures als de pagina Vacatures, nieuwste eerst. Antwoorden worden een paar minuten gecachet. Paden eindigen op een slash.

  • GET /api/: Overzicht van de API
  • GET /api/vacatures/: Alle vacatures
  • GET /api/vacatures/{slug}/: Eén vacature
curl https://careerstudent.nl/api/vacatures/
{
  "data": [
    {
      "slug": "werkstudent-marketing",
      "title": "Werkstudent Marketing",
      "url": "https://careerstudent.nl/vacature/werkstudent-marketing/",
      "applyUrl": "https://careerstudent.nl/vacature/werkstudent-marketing/solliciteren/",
      "employmentType": "Werkstudent",
      "location": "Amsterdam",
      "hoursPerWeek": "16-24",
      "salary": "500 per maand",
      "datePosted": "2026-10-01T09:00:00.000Z",
      "current": true,
      "...": "..."
    }
  ],
  "meta": { "count": 1, "generatedAt": "2026-10-08T12:00:00.000Z" },
  "links": { "self": "https://careerstudent.nl/api/vacatures/", "...": "..." }
}

Bedrijfsnamen van opdrachtgevers staan nooit in de API, net als op de site. Solliciteren gaat via applyUrl.

Pagina's als Markdown

Elke pagina is ook als Markdown op te vragen, op dezelfde URL. Stuur Accept: text/markdown mee; browsers krijgen gewoon HTML. Het antwoord heeft Content-Type: text/markdown; charset=utf-8 en Vary: Accept. Een pagina die niet bestaat geeft een 404 met uitleg in Markdown, en een Accept-header zonder HTML of Markdown krijgt een 406.

curl -H "Accept: text/markdown" https://careerstudent.nl/

Foutmeldingen

Alle fouten onder /api/ zijn JSON volgens RFC 9457 (application/problem+json), met een vaste code, een hint om verder te komen en een link naar deze pagina.

HTTP/1.1 404 Not Found
Content-Type: application/problem+json

{
  "type": "https://careerstudent.nl/developers/#fout-vacancy_not_found",
  "title": "Vacature niet gevonden",
  "status": 404,
  "detail": "Er is geen vacature met deze slug.",
  "instance": "/api/vacatures/bestaat-niet/",
  "code": "vacancy_not_found",
  "hint": "Haal de actuele slugs op via GET /api/vacatures/.",
  "docs": "https://careerstudent.nl/developers/"
}
  • not_found (404): Niet gevonden. Bekijk de beschikbare endpoints in de OpenAPI-specificatie op /openapi.json.
  • vacancy_not_found (404): Vacature niet gevonden. Haal de actuele slugs op via GET /api/vacatures/.
  • vacancy_closed (410): Vacature gesloten. Deze vacature is vervuld of verlopen. Haal de actuele vacatures op via GET /api/vacatures/.
  • method_not_allowed (405): Methode niet toegestaan. Gebruik een van de methoden in de Allow-header.
  • unauthorized (401): Niet geautoriseerd. Dit endpoint is alleen voor intern gebruik en vereist een geldig gedeeld geheim.
  • not_configured (503): Niet geconfigureerd. Dit endpoint staat uit in deze omgeving. Probeer het later opnieuw.
  • upstream_unavailable (503): Gegevens tijdelijk niet beschikbaar. Probeer het over een paar minuten opnieuw.

Afspraken

De API is gratis en alleen-lezen. Vraag niet vaker dan nodig: de gegevens veranderen hooguit een paar keer per dag. Vragen of iets missen? Neem contact op.