# De Joobs API: je vacatures op je eigen site, zonder iframe

> Je vacatures als JSON, in je eigen design op je eigen domein. De routes, de sleutel, de limieten en wat het verandert voor je werving.

- **Author:** David Verbustel
- **Category:** ETFY8wgbX6Y616hUa4Fq
- **Published:** 2026-04-20
- **Language:** nl

De jobpagina van veel Belgische kmo's toont de vacatures van iemand anders. Een kader midden in de site, met eigen lettertypes, een eigen scrollbalk en een eigen sollicitatieknop. Technisch werkt het. De bezoeker ziet alleen dat hij van site is veranderd zonder ergens op te klikken.
Er is nu een andere weg. De publieke API van Joobs geeft je je vacatures terug als data, en jij toont ze zelf: jouw design, jouw domein, jouw template.
## Wat het iframe je echt kost
Een iframe is een pagina in een pagina. Die grens heeft vier gevolgen, en geen enkel gevolg staat op een factuur — precies daarom worden ze makkelijk over het hoofd gezien.
- Je design stopt bij het kader. Lettertypes, kleuren en witruimte gaan niet over de rand. Het meest commerciële stuk van je site is net het stuk dat niet op jou lijkt.

- Mobiel betaalt dubbel. Een kader dat scrollt binnen een pagina die scrollt. Op een telefoon verliest de bezoeker de draad, of de knop.

- De vindbaarheid gaat elders heen. Inhoud in een iframe hoort niet bij jouw domein. Je vacatures werken voor de ranking van de site die ze levert, niet voor die van jou.

- Je meet niets. Je analysetool stopt bij de rand. Je weet hoeveel mensen de pagina zagen, niet hoeveel er een vacature lazen.


## Wat de API doet, in één zin
Ze geeft je gepubliceerde vacatures terug als data, zodat je site ze toont zoals ze al de rest toont.
Geen widget om in te bouwen, geen script van derden dat laadt in de browser van je bezoeker. Eén HTTP-aanvraag, JSON terug, en de weergave is helemaal van jou.
curl -H "x-api-key: joobs_jouw_sleutel" \
  https://europe-west1-leipzig-04103.cloudfunctions.net/api/v1/jobsHet antwoord bevat je actieve vacatures: titel, beschrijving, locaties, contracttypes, bedrijfsgrootte en de functiebenamingen in de vier talen van de site — Frans, Engels, Nederlands, Duits. Jij bepaalt wat je toont en hoe.
## De vier routes
RouteWat ze teruggeeftWat je ermee doetGET /v1/healthDe status van de dienstJe monitoringGET /v1/jobsJe publieke vacatures, gepagineerdDe lijst op je jobpaginaGET /v1/jobs/:idEén volledige vacatureDe detailpaginaPOST /v1/jobs/:id/applyDe ontvangstbevestigingJe eigen sollicitatieformulierDe lijst pagineer je met limit en offset, maximaal honderd vacatures per oproep. Elke vacature draagt ook haar adres op Joobs, voor als je liever doorlinkt dan zelf detailpagina's bouwt.
De sollicitatieroute aanvaardt een multipart-verzending: voornaam, naam, e-mail, bericht en een cv in PDF, DOC of DOCX tot 10 MB. Ze antwoordt met een sollicitatie-id.
## De sleutel, en wat ze opent
De authenticatie past in één header, x-api-key. De sleutel hoort bij één organisatie: ze raakt aan jouw vacatures en aan niets anders, en geen enkele andere sleutel raakt aan die van jou. Er is geen organisatie-id mee te geven, dus je kunt er ook niet naast mikken.
Joobs bewaart de sleutel zelf nooit, alleen de vingerafdruk ervan. Intrekken werkt onmiddellijk: een uitgeschakelde sleutel faalt bij de eerstvolgende oproep.
Het standaardquotum is duizend aanvragen per dag. Elk antwoord vertelt je wat er overblijft, in de headers X-RateLimit-Limit en X-RateLimit-Remaining — genoeg om je verbruik op te volgen zonder zelf te tellen.
Gebruik de sleutel vanaf je server, nooit vanuit de browser. Een sleutel in JavaScript aan de clientkant is een publieke sleutel: elke bezoeker leest hem in de ontwikkelaarstools. Ga via een route op je eigen site die de API aanroept en het resultaat teruggeeft.
## Wat de API nog niet doet
Vier beperkingen zijn het waard om te kennen voor je de eerste regel code schrijft, want ze bepalen hoe je de pagina bouwt.
- Filteren doe je zelf. De lijst aanvaardt paginering, geen filters op functie, locatie of contracttype. Je haalt je vacatures op en sorteert ze op je eigen site — wat sowieso sneller is zodra je er enkele tientallen hebt.

- De API leest vacatures, ze schrijft ze niet. Publiceren, aanpassen en offline halen blijven in Joobs. De enige route die schrijft, is die van de sollicitaties.

- Er zijn nog geen meldingen die naar jou toe komen. Niets verwittigt je site dat een vacature veranderd is; jij roept op, met het interval dat jou past.

- De kandidaat krijgt geen ontvangstbevestiging van Joobs. Dat bevestigingsbericht toont jouw formulier. De melding vertrekt wel, maar naar jou, niet naar hem of haar.


## Wat het verandert voor je werving
Een ontwikkelaar ziet een integratie. Wie rekruteert, wint er drie concrete dingen bij.
Je vacatures werken eindelijk voor je eigen domein. Vacaturepagina's die je site zelf toont, zijn pagina's van je site: ze indexeren onder jouw naam, ze voeden jouw ranking, en ze blijven wanneer je van tool verandert.
De kandidaat wisselt niet meer van site onderweg. De visuele breuk tussen je jobpagina en het sollicitatieformulier is een klassiek afhaakpunt. Die verdwijnt zodra jij alles toont.
Sollicitaties komen nog altijd op één plek binnen. Een sollicitatie via de API belandt in je gewone Joobs-dashboard, met haar e-mailmelding en haar cv, net als een sollicitatie op Joobs zelf. Ze draagt enkel een herkomstlabel, zodat je weet waar ze vandaan komt.
Een geslaagde integratie valt niet op. Een bezoeker zou nooit mogen kunnen afleiden welke tool je vacatures beheert — niet door naar de pagina te kijken, en niet door te solliciteren.
## Waar je begint
De volledige documentatie — authenticatie, overzicht van de routes, dataschema, limieten — staat op de ontwikkelaarspagina. Daar vind je de voorbeeldoproepen en de details van elk veld.
Toegang tot de API hoort bij het Premium-plan. De sleutel maak je aan samen met ons team, dat ze aan je organisatie koppelt en je quotum instelt.
Heb je een ontwikkelaar nodig om de API te integreren?Ja, maar niet lang. Voor een klassieke jobpagina — de lijst met vacatures en een detailpagina — reken op een halve dag voor wie je site al beheert. De API geeft gewone JSON terug, zonder bijzondere afhankelijkheid of bibliotheek om te installeren.
Wat gebeurt er als je een vacature offline haalt?Ze verdwijnt uit het antwoord bij de eerstvolgende oproep. Als je site de resultaten cachet — wat we aanraden, vijf tot vijftien minuten — blijft de vacature zichtbaar tot de cache vervalt. Dat is de enige vertraging.
Waar komen sollicitaties via de API terecht, en wie verwerkt de gegevens?In je Joobs-dashboard, naast alle andere. Het cv staat op dezelfde plek, de melding gaat naar hetzelfde adres, en het kandidaatprofiel wordt aangemaakt — of hergebruikt als de persoon al eerder bij je solliciteerde. Er komt geen extra dienst van derden aan te pas.
Zit de API in mijn abonnement?Ze hoort bij het Premium-plan, samen met de synchronisatie naar je ATS en naar je website. Zit je op een ander plan, spreek ons team aan: de sleutel en het quotum worden tegelijk geregeld.

---
*Source: [Joobs.be](https://joobs.be/nl/blog/joobs-api-je-vacatures-op-je-eigen-site)*