Vacatures afnemen met de Vacature API

Op deze pagina lees je alles over de Vacature API.

Wat doet deze API?

Met de Vacature API neem je automatisch vacatures af bij VDAB om ze op te laden in je eigen systeem.

Voorwaarden voor gebruik

  • Je mag de Vacature API gebruiken, nadat VDAB een partnership met jou heeft goedgekeurd en na het ondertekenen van een samenwerkingsovereenkomst.
  • Je mag de Vacature API enkel voor professionele doeleinden gebruiken. 
  • De data-uitwisseling via de API moet een toegevoegde waarde hebben voor VDAB en voor je organisatie.

Hoe verloopt de voorbereiding (onboarding) als je wil starten met API's?

Lees hoe je toegang krijgt tot de Profiel API en welke stappen je moet doorlopen bij de technische voorbereiding met uitgebreide testfase op de pagina 'Hoe verloopt de voorbereiding (onboarding) als je wil starten met API's?'

Vraag de API aan

Technische info

Functionaliteiten

Met de Vacature API kun je:

  • vacatures ophalen
  • interactief zoeken naar vacatures
  • alle bestaande informatie van een vacature opvragen
  • vacatures synchroniseren in bulk

Deze functionaliteiten zijn beschikbaar via de vijf endpoints van de Vacature API:

  • GET/vacatures/initial

    Het aanroepen van dit endpoint geeft een lijst van vacatures en hun status (altijd status “GEPUBLICEERD”) terug, op een bepaalde datum. 

  • GET/vacatures (interactief zoeken)

    Bij het aanroepen van dit endpoint stel je verschillende selectiefilters in om een gewenste set van vacatures te bekomen.

  • GET/vacatures/{id}

    Het aanroepen van dit endpoint geeft alle bestaande info van één bepaalde vacature.

  • POST/vacatures

    Het aanroepen van dit endpoint geeft bestaande info van meerdere vacatures door vacaturenummers toe te voegen aan je verzoek.

  • GET/vacatures/bulk (bulk synchronisatie)

    Het aanroepen van dit endpoint geeft als resultaat alle vacatures die aangemaakt, gewijzigd of verwijderd zijn in een bepaalde tijdsspanne.

Paginering

Zowel voor het 'initieel ophalen', het 'interactief zoeken' als het 'in bulk synchroniseren' wordt paginering gebruikt om het aantal resultaten per call te beperken.

Beveiliging

VDAB gebruikt de API-sleutel (een unieke lange cijfercode) als authenticatiemiddel. Extra beveiliging is voorzien via OAuth 2.0 (OIDC-protocol). Verder kunnen de API's enkel benaderd worden via HTTPS-verbindingen die versleuteld zijn via TLS1.2 (of hoger) om de veiligheid te garanderen.

Hoe testen?

Voorbeeld maart 2025 (versie 4)

Stap 1: Zoek vacatures in 'management' in 9000 (Gent)

Aanvraag via GET /vacatures

Criteria:

  • jobdomein=JOBCAT15 (management)
  • postcode=9000 (Gent)

Het criterium 'JOBCAT15 (management)' kan je opvragen via de Referentie API - subproduct Jobdomeinen. 

Zie ook de info over de Referentie API.

Resultaat 04-03-2025:

Deze zoekopdracht geeft 565 resultaten terug (gepagineerd afgebeeld, limiet van 15 vacatures per pagina)

Stap 2: Inzoomen op één vacature van de opgevraagde vacaturelijst

Aanvraag via GET /vacatures/{id}

Resultaat 04-03-2025:

Deze aanroep geeft het detail van één specifieke vacature weer.