JH

API publique

API REST libre d'accès pour construire vos propres outils autour des offres d'emploi françaises. Sans authentification, rate-limited à 30 req/s par IP.

Quick start

curl https://jobhunter-france.com/api/public/vacancies?category=informatique&limit=5

# Réponse JSON
{
  "vacancies": [ { "id": 1, "title": "Dev React", "company": "...", "salary": "...", ... } ],
  "total": 1247,
  "page": 1,
  "has_more": true
}

Base URL

jobhunter-france.com

Format

JSON, UTF-8

Rate limit

30 req/s par IP

Endpoints

GET/api/public/stats

Compteurs globaux (vacances actives, nouvelles aujourd'hui, candidatures)

Response schema
{
  "total_vacancies": 42510,
  "total_users": 847,
  "new_today": 623,
  "total_applications": 2184
}
GET/api/public/vacancies

Liste paginée des offres d'emploi

Query params (4)
page — Numéro de page (défaut: 1)
limit — Résultats par page (1-50, défaut: 20)
category — Filtre par catégorie (slug)
department — Filtre par département (code INSEE)
Exemple : /api/public/vacancies?category=informatique&department=75&limit=10
GET/api/public/vacancies/{id}

Détails d'une offre spécifique

Exemple : /api/public/vacancies/12345
GET/api/public/vacancies/{id}/similar

Offres similaires par catégorie + département

Query params (1)
limit — 1-10, défaut: 5
GET/api/public/vacancies/geo

Offres avec coordonnées géo pour affichage cartographique

Query params (2)
category — Filtre par catégorie
department — Code département
GET/api/public/salary-stats

Statistiques salariales par catégorie et département (médianes, P25, P75)

GET/api/public/salary-by-role

Fourchette salariale détaillée par métier

Query params (2)
category* — Clé de catégorie (e.g. 'it')
department — Code département optionnel
Exemple : /api/public/salary-by-role?category=it&department=75
GET/api/public/skill-stats

Statistiques pour une compétence (nombre d'offres, top employeurs, salaire)

Query params (1)
skill* — Nom de la compétence (2-30 chars, alphanum)
Exemple : /api/public/skill-stats?skill=Python
GET/api/public/companies

Top entreprises qui recrutent

Query params (1)
limit — 1-200, défaut: 50
GET/api/public/companies/{name}

Détails d'une entreprise : offres, breakdown secteur/département, salaire

Exemple : /api/public/companies/Criteo
GET/api/public/suggest

Auto-complétion pour titres d'offres et noms d'entreprises

Query params (1)
q* — Terme de recherche (2-50 chars)
Exemple : /api/public/suggest?q=react
GET/api/public/referral-leaderboard

Top parrains (anonymisé : prénom + initiale)

Query params (1)
limit — 3-50, défaut: 10
GET/api/public/success-stories

Témoignages approuvés d'utilisateurs embauchés

Query params (1)
limit — défaut: 10, max: 50
GET/api/public/status

Santé du service (API, DB, parseur)

Conditions d'utilisation

  • Usage gratuit pour projets personnels, recherche académique, outils communautaires.
  • Rate limit : 30 requêtes/seconde par IP. Dépassement → 429 Too Many Requests.
  • Cache recommandé : les données changent au plus toutes les 15 min.
  • Attribution appréciée : "Données fournies par JobHunter France".
  • Usage commercial intensif : nous contacter.