Intégration API France Travail
Nous développons votre connecteur France Travail
Nous branchons les APIs France Travail sur votre site carrière, votre ATS ou votre outil RH : offres officielles, métier ROME, tension territoriale. Sans scraper le site public.
- Équipe produit senior
- connecteurs de données publiques en production
- du cadrage au monitoring
À quoi sert l'API France Travail et dans quels outils l'intégrer ?
France Travail (ex-Pôle emploi) expose des APIs publiques sur ses offres d'emploi, les compétences ROME et les indicateurs du marché du travail. On les intègre dans des plateformes RH, des outils de recrutement ou des applications d'orientation professionnelle pour afficher les offres en temps réel, suggérer des formations selon un métier ou enrichir une fiche poste avec les compétences associées par l'ROME. L'accès est gratuit après inscription sur le portail développeur ; chaque API nécessite une souscription distincte.
Ce que nos clients construisent sur l'API France Travail
Widget d'offres territoriales
Site d'une commune ou d'une agence de développement : le flux officiel, pas un scrape de francetravail.fr.
Enrichissement d'un ATS / jobboard
Les offres France Travail et partenaires consentants, avec respect des conditions de rediffusion.
Autocomplete métier ROME
Formulaire de recrutement ou de formation : on stocke le code métier, pas seulement le libellé.
Tension métier sur un territoire
API Marché du travail pour un cabinet RH ou un OPCO : « tension sur le métier X dans le 44 », sources admin déjà croisées.
Ce que ça change dans votre site carrière
La technique au service d'un résultat mesurable : l'offre officielle, un accès qui passe, pas un scrape illégal.
L'accès est ouvert avant de coder
Sans souscription correcte sur le portail, rien ne passe. On valide l'accès en amont : des semaines de debug évitées.
On cherche, on ne télécharge pas tout
Le produit interroge et suit les mises à jour. Paginer toute la base toutes les dix minutes n'est pas un produit.
Les anciennes URLs Pôle emploi sont nettoyées
Un ancien domaine peut encore répondre et masquer la dette. On bascule vers francetravail avant que ça casse en silence.
Offres ≠ statut d'un allocataire
Les offres passent par un compte développeur. Le statut d'un usager, c'est API Particulier avec habilitation. On ne mélange pas les deux.
Comment nous livrons votre connecteur France Travail
Cadrage
Offres, ROME, marché du travail : quelles APIs, quels scopes, quelle rediffusion. On souscrit avant d'écrire le client.
Développement
Client OAuth avec cache du token, secrets en coffre, limiteur, stockage local des offres déjà vues, mapping ROME par code.
Recette
Test invalid_client sans souscription, test des scopes oubliés, rejeu sur vos codes ROME / départements, repli cache si l'API saute.
Monitoring
Alerte 401 / 429, fraîcheur du cache d'offres, expiration du token. Le site carrière ne se vide pas si FT est down.
Ce que permet l'API France Travail
- Recherche d'offres v2
- Filtres métiers, communes, départements, types de contrat. Offres collectées par France Travail et partenaires consentants.
- Détail d'offre et référentiels
- Fiche d'une offre, lieux, contrats, métiers, formations, secteurs. De quoi préremplir une fiche de poste, pas de quoi dumper la base.
- ROME 4.0
- Quatre APIs : compétences, métiers, contextes de travail, fiches métiers. Le référentiel que les OPCO n'ont plus à recoder à la main.
- Marché du travail
- Demandeurs d'emploi, offres, embauches, tensions, salaires proposés. Sources FT, ACOSS, CCMSA, DARES. MAJ trimestrielle.
Le vocabulaire de l'API France Travail
- Souscription
- L'application doit être souscrite à chaque API. Sans ça, invalid_client. C'est le même réflexe que PISTE ou le portail Météo-France : un compte vide ne sert à rien.
- o2dsoffre / api_offresdemploiv2
- Exemple de scopes offres. Un scope oublié = token refusé ou 403. Chaque API a les siens, à composer au cadrage.
- ROME 4.0
- Référentiel métiers / compétences (mars 2023). Quatre APIs. Le code métier se stocke, le libellé s'affiche.
- dateActualisation
- Le champ pour ne relire que le delta. Sans lui, on re-télécharge ce qu'on a déjà. Avec ~500 000 offres / jour côté site, le connecteur cherche, il ne dump pas.
- francetravail.io
- Le portail actuel. api.emploi-store.fr et les chemins pole-emploi.fr dans le métier sont suspects. Le token PE qui répond encore est un piège.
- invalid_client
- Le symptôme n°1 : id/secret justes, souscription absente. Se documente en cinq minutes sur le portail, pas en trois jours de logs.
Les contraintes réelles de l'API France Travail
Rename 2024 : Pôle emploi → France Travail
Hosts, scopes, docs. Tout snippet api.emploi-store.fr est une dette. Le token PE qui répond encore est pire qu'une 404 : le code a l'air sain.
Souscrire n'est pas créer une appli
Sans souscription, invalid_client. Même mécanique que Météo-France et PISTE. On le vérifie au cadrage, pas en recette client.
Ce n'est pas le statut d'un allocataire
Offres = compte développeur. Statut demandeur d'emploi d'une personne = API Particulier, DataPass. Un jobboard n'a pas besoin du second ; un CCAS n'a pas besoin du premier.
Pas de webhook, donc un poll sous quota
Les plafonds se lisent dans le portail après compte. Nous ne publions pas de chiffre tiers. Limiteur, backoff 429, cache, User-Agent clair.
API France Travail Offres ou API Particulier ?
Deux « France Travail » dans les moteurs. L'un est un jobboard, l'autre une démarche sociale.
| Critère | Offres France TravailJobboard officiel | API ParticulierStatut d'un usager |
|---|---|---|
| Objet | Offres d'emploi publiques | Statut et paiements d'un allocataire |
| Accès | Compte dev, souscription | DataPass, mission de service public |
| Open-ish | Oui, après compte | Non, habilitation |
| Hôte | api.francetravail.io | particulier.api.gouv.fr |
| Auth | OAuth2 client_credentials | JWT Bearer |
| Front-end | Jeton serveur, pas en SPA | Interdit, CORS refusé |
| Le bon cas | Site carrière, ATS, OPCO | CCAS, tarification sociale |
On ne les combine que si le produit a vraiment les deux besoins. Sinon on en choisit un, et on arrête de les fusionner dans le même chiffrage.
Ce que nous mesurons sur une intégration France Travail
Les autres API publiques
Les briques que nous branchons le plus souvent à côté, une fois Offres cadré.
France TravailNous développons votre connecteur France TravailCette page
API AdresseNormaliser le lieu de l'offre ou du candidat, code INSEE inclus.
Météo FranceSans rapport avec les offres : autre portail, autre secret.
URSSAFOpen data territorial, complémentaire du marché du travail, pas un flux d'offres.
SNCF & transportNous développons votre connecteur SNCFAPI Particulier
DVF & cadastre
LegifranceNous développons votre connecteur Légifrance
API GéoOn combine France Travail avec
La stack qui entoure les offres sur nos projets.
Intégration France Travail : vos questions
Compte sur francetravail.io, application, souscription à chaque API utile, OAuth2 client_credentials sur entreprise.francetravail.fr (grant_type, client_id, client_secret, scope). Cacher le token selon expires_in, secrets en coffre, une appli sandbox / prod. Ensuite chercher un périmètre (ROME, département), stocker les offres déjà vues, relire le delta. User-Agent clair, limiteur calé sur le quota du portail, backoff 429. Si l'API saute, on ne vide pas le cache du site carrière.
Presque toujours : l'application n'est pas souscrite à l'API, ou un scope manque (api_offresdemploiv2, o2dsoffre, etc.). Les clés peuvent être justes. C'est le bug n°1, documentable en cinq minutes de portail. Le second piège est un hôte encore en pole-emploi.fr : ça répond, donc personne ne migre. On le vérifie au cadrage, sur le portail, avant d'écrire le client OAuth. Ça évite trois jours de logs pour un oubli de case à cocher.
L'API Offres expose des annonces publiques, avec un compte développeur. API Particulier expose le statut d'un allocataire, sous DataPass, pour une démarche sociale. L'une alimente un jobboard ; l'autre un dossier CCAS. Les mélanger dans le même connecteur est une erreur d'avant-vente, pas un raccourci technique. Un ATS n'a pas besoin du statut allocataire ; un CCAS n'a pas besoin du flux d'offres. On choisit, on ne fusionne pas le chiffrage.
Environ 500 000 offres en ligne par jour : on ne « télécharge pas la base ». On cherche un périmètre, on pagine avec mesure, on stocke le déjà-vu. Pas de webhook documenté, donc un poll sous le quota du portail. Un extract massif se discute au cadrage ; ce n'est pas le défaut du widget territorial. Les conditions de rediffusion des offres partenaires se lisent dans les CGU du portail : toutes les offres n'ont pas le même droit de republication.
L'accès partenaire est gratuit après compte. Le coût est le connecteur : OAuth, souscriptions, cache, delta, ROME, conditions de rediffusion. Un widget d'offres sur trois départements est un chantier court. Un ATS qui republicie des offres partenaires, plus ROME et marché du travail, est un projet. Nous cadrons le périmètre et donnons une estimation ferme avant de commencer. La souscription versionnée (sandbox / prod) et le mapping ROME par code font partie du livrable, pas d'une option.
Un projet d'intégration France Travail ?
Parlons-en. 30 minutes pour cadrer offres, ROME ou marché du travail, vérifier la souscription, et vous dire franchement ce qui est faisable.
Parler de mon projet France Travail