Getting your API key

Chaque site web d’éditeur nécessite une clé API unique, que vous pouvez obtenir depuis votre compte d'éditeur.

Interroger l'API

Authentification

L'authentification de base est utilisée pour accéder à cette API. Cela signifie que vous devrez ajouter un header Authorization à chaque requête pour obtenir l'accès. Le nom d'utilisateur pour l'authentification de base est votre clé API, et le mot de passe pour l'authentification de base est une chaîne vide.

Le format du header Authorization est :

Authorization: Basic {credentials}

où '{credentials}' est la chaîne encodée en Base64 de la clé API suivie de deux-points.

Endpoint et paramètres

Le endpoint de l'API est https://search.api.careerjet.net/v4/query et expose les paramètres HTTP GET ci-dessous.

Nom du paramètre Valeurs Commentaires
locale_code [language_code]_[COUNTRY_CODE] La valeur doit correspondre à la liste des locales prises en charge. La valeur par défaut est en_GB si elle n'est pas spécifiée.
keywords string Une liste d’un ou plusieurs mots-clés de recherche encodés au format URL
location string la localité de recherche ; lorsqu'elle n'est pas spécifiée, indique une recherche à l'échelle du pays
contract_type
  • p: CDI
  • c: Mission en contrat
  • t: CDD
  • i: stage
  • v: poste de bénévolat
 le type de contrat
work_hours
  • f: poste à temps plein
  • p: poste à temps partiel
 temps de travail
fragment_size integer la taille de l’extrait du résultat de recherche en caractères, par défaut à 120
sort
  • relevance: trier par pertinence décroissante
  • date: trier par date décroissante
  • salary: trier par salaire décroissant
 détermine l'ordre de tri, par défaut sur « relevance »
offset integer de 1 à 999, par défaut à 0
page integer de 1 à 10
page_size integer de 1 à 100, avec une valeur par défaut de 20
radius integer defaulting to 5 km/miles depending on location
user_ip string obligatoire : l'adresse IP de l'utilisateur dont l'action a déclenché l'appel à l'API
user_agent string obligatoire : le User Agent de l’utilisateur dont l’action a déclenché l’appel à l’API

Types de réponse

Succès

Une requête réussie donnera lieu à une réponse JSON HTTP 200, dont la structure générale est la suivante :

{
  "type": 'JOBS',
  "hits": 62,
  "message": "62 matching jobs found", 
  "pages": 4, 
  "response_time": 0.322, 
  "jobs" [Liste des emplois : voir ci-dessous]
}

Réponses d'erreur

Les requêtes incorrectes entraîneront divers codes d’état d’erreur HTTP et un corps de réponse minimal indiquant le type d’erreur et les détails, si présent. Vous trouverez ci-dessous un aperçu des erreurs potentielles rencontrées :

Code HTTP Message Commentaires
400 Unsupported locale code Le code de locale fourni n'est pas pris en charge.
403 Missing param user_ip or user_agent La requête n'incluait pas les paramètres user_ip ou user_agent.

Mode localisation

Pas strictement une erreur, mais une situation qui empêchera toute recherche d’avoir lieu. Le mode localité est déclenché comme décrit ci-dessous :

Message Commentaires
no matching location found Aucune localité ne correspond au paramètre location fourni.

Exemple

{
  "type": "LOCATIONS",
  "locations": [], 
  "message": "no matching location found", 
  "response_time": 0.11
}
Message Commentaires
multiple locations found Plusieurs localités correspondent au paramètre location fourni. Vous pouvez alors choisir l’une d’elles dans la liste fournie locations.

Exemple

{
  "type": "LOCATIONS",
  "locations": ["choix 1", "choix 2", "choix 3"], 
  "message": "multiple locations found", 
  "response_time": 0.11
}

Structure emploi

Chaque emploi est structuré comme suit :

{
  'title': 'Consultant Java/J2EE/Websphere', 
  'company': 'Danone', 
  'date': 'Wed,15 Nov 2025 19:13:43 GMT', 
  'description': 'Job description excerpt', 
  'locations': 'Paris', 
  'salary': '30k-40k €', 
  'salary_currency_code': 'XOF', 
  'salary_max': xx.yy, 
  'salary_min': xx.yy, 
  'salary_type': 'Y', 
  'site': 'domain.com', 
  'url': 'https://jobviewtrack.com/v2/lien unique'
}

Où salary_type peut être :