Modifié le : 16 Aug, 2026

Ce guide propose la documentation nécessaire pour vous intégrer à la Jooble REST API. Vous trouverez ci-dessous des informations sur la génération de clés API, les points de terminaison, les paramètres de requête, les formats JSON et les codes de réponse courants. Si vous n’avez pas encore commencé l’intégration, veuillez consulter notre guide étape par étape sur Comment vous connecter à la Jooble REST API.

Restrictions régionales importantes :
Chaque domaine Jooble (pays) demande sa propre clé REST API unique. Par exemple, une clé générée sur jooble.org donne accès exclusivement aux offres d’emploi aux États-Unis. Pour rechercher des offres d’emploi dans d’autres pays, inscrivez-vous et obtenez une clé API sur le domaine régional correspondant (par ex. uk.jooble.org/api/about pour le Royaume-Uni ou de.jooble.org/api/about pour l’Allemagne).

Limites d’utilisation de l’API :
L’offre d’abonnement REST API gratuite comprend une limite totale de 500 requêtes par clé (il s’agit d’un quota absolu pour toute la durée de vie de la clé, pas d’une limite mensuelle).

Comment obtenir une clé Jooble REST API

1. Créez un compte sur le portail API Jooble de votre pays cible (par ex. fr.jooble.org/api/about).
2. Une fois l’inscription terminée, copiez et conservez précieusement la clé API générée.

Paramètres de la requête (corps JSON)

Le corps de la requête doit être envoyé au format application/json avec les paramètres suivants :

• keywords(string, requis) : mots-clés ou titres de postes à rechercher
• location(string, requis) : nom de la localisation (ville, région ou pays)
• radius(string, facultatif) : rayon de recherche en kilomètres. Valeurs autorisées : 0, 4, 8, 16, 26, 40, 80
• salary(integer, facultatif) : seuil de salaire minimum
• page(integer, facultatif) : numéro de page des résultats de recherche (la valeur par défaut est 1)
• ResultOnPage(integer, facultatif) : nombre d’offres d’emploi affichées par page
• SearchMode(integer, facultatif) : mode de l’algorithme de recherche (la valeur par défaut est 0)
• companysearch(boolean, facultatif) :
  • true – recherche les mots-clés spécifiquement dans les noms d’entreprises
  • false – recherche les mots-clés dans les titres des postes et les descriptions

Paramètres de la réponse

En cas de requête réussie, le serveur renvoie un objet JSON contenant :

• totalCount(integer) : nombre total d’offres d’emploi correspondantes trouvées
• jobs(array) : liste d’objets d’offres d’emploi contenant :
  • id(integer) : identifiant unique de l’offre d’emploi
  • title(string) : titre du poste
  • location(string) : localisation de l’offre d’emploi
  • snippet(string) : bref extrait de la description affiché dans les résultats de recherche
  • salary(string) : fourchette de salaire formatée comme suit : {min} - {max} {currency}
  • source(string) : source de la publication de l’offre d’emploi
  • type(string) : type d’emploi (par ex. plein temps, temps partiel)
  • link(string) : URL directe vers l’offre d’emploi sur Jooble
  • company(string) : nom de l’entreprise
  • updated(string) : horodatage ISO de la dernière mise à jour de l’offre d’emploi

Exemples de requête et de réponse JSON

Exemple de corps de requête :

Exemple de réponse réussie (200 OK) :

Codes de réponse HTTP et d’erreur

• 200 OK : la requête a réussi et a renvoyé des données
• 403 Access Denied : clé API non valide ou manquante
• 404 Not Found : le point de terminaison ou la ressource demandé n’existe pas

Exemples d’implémentation du code

Vous pouvez intégrer la Jooble REST API en utilisant des langages de programmation tels que PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby, entre autres. Des extraits de code prêts à l’emploi et des guides d’implémentation sont disponibles sur notre page de documentation de l’API Jooble.