Gewijzigd op: 16 Aug, 2026

Deze handleiding biedt documentatie voor de integratie met de Jooble REST API. Hieronder vind je informatie over het genereren van een API-key, endpoints, aanvraagparameters, JSON-formaten en veelvoorkomende responscodes. Als je de integratie nog niet hebt gestart, raadpleeg dan onze stappenhandleiding over hoe je verbinding maakt met de Jooble REST API.

Belangrijke regionale beperkingen:
Elk Jooble-domein (land) vereist een eigen unieke REST API-key. Een key die is gegenereerd op jooble.org geeft bijvoorbeeld uitsluitend toegang tot Amerikaanse vacatures. Registreer je en vraag een API-key aan op het bijbehorende regionale domein om vacatures voor andere landen op te vragen (bijvoorbeeld uk.jooble.org/api/about voor het Verenigd Koninkrijk of de.jooble.org/api/about voor Duitsland).

Limieten voor API-gebruik:
Het gratis REST API-plan bevat een totale levenslange limiet van 500 aanvragen per key (dit is een absoluut levenslang quotum, geen maandelijkse limiet).

Hoe je een Jooble REST API-key kunt verkrijgen

1. Registreer een account op het Jooble API-portaal voor je doelland (bijvoorbeeld nl.jooble.org/api/about).
2. Kopieer en bewaar je gegenereerde API-key op een veilige plek zodra je bent geregistreerd.

Aanvraagparameters (JSON-body)

De payload van de aanvraag moet worden verzonden in het formaat application/json met de volgende parameters:

• keywords(string, verplicht): trefwoorden of functietitels waarnaar gezocht moet worden.
• location(string, verplicht): locatienaam (stad, regio of land).
• radius(string, optioneel): zoekstraal in kilometers. Toegestane waarden: 0, 4, 8, 16, 26, 40, 80.
• salary(integer, optioneel): minimale salarisdrempel.
• page(integer, optioneel): paginanummer van de zoekresultaten (standaard is 1).
• ResultOnPage(integer, optioneel): aantal vacatures dat per pagina wordt geretourneerd.
• SearchMode(integer, optioneel): modus voor het zoekalgoritme (standaard is 0).
• companysearch(boolean, optioneel):
  • true – zoek trefwoorden specifiek binnen bedrijfsnamen.
  • false – zoek trefwoorden in functietitels en beschrijvingen.

Responsparameters

Bij een succesvolle aanvraag retourneert de server een JSON-object met:

• totalCount(integer): totaal aantal gevonden overeenkomende vacatures.
• jobs(array): lijst met vacature-objecten die het volgende bevatten:
  • id(integer): unieke id van de vacature.
  • title(string): functietitel.
  • location(string): vacaturelocatie.
  • snippet(string): kort fragment van de beschrijving dat wordt weergegeven in de zoekresultaten.
  • salary(string): salarisbereik geformatteerd als {min} - {max} {currency}.
  • source(string): bron van de vacature.
  • type(string): type dienstverband (bijvoorbeeld Fulltime, Parttime).
  • link(string): directe link naar de vacature op Jooble.
  • company(string): bedrijfsnaam.
  • updated(string): ISO-tijdstempel van de laatste vacature-update.

Voorbeelden van JSON-aanvragen en -responses

Voorbeeld van de payload van een aanvraag:

Voorbeeld van een succesvolle respons (200 OK):

HTTP-respons- en foutcodes

• 200 OK: de aanvraag was succesvol en heeft gegevens geretourneerd.
• 403 Access Denied: ongeldige of ontbrekende API-key.
• 404 Not Found: het opgevraagde endpoint of de bron bestaat niet.

Voorbeelden van code-implementatie

Je kunt de Jooble REST API integreren met programmeertalen zoals PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby en andere. Kant-en-klare codefragmenten en implementatiehandleidingen zijn beschikbaar op onze documentatiepagina van de Jooble API.