Recherche multicritères dans les offres d'emploi France Travail (temps réel). Renvoie une liste paginée de résumés d'offres + le total de résultats correspondants.

Paramètres principaux :

• motsCles : mots-clés (ex. 'boulanger', 'développeur web'). Caractères autorisés : lettres, chiffres, espace, @#$%^&+./-.

• codeROME : 1 à 3 codes ROME (5 caractères, ex. ['D1102']). Utilisez ft_predict_rome ou ft_search_metiers pour les trouver.

• commune / departement / region : codes INSEE (commune = 5 chiffres). Récupérables via ft_list_referentiel. ⚠ Paris, Lyon et Marseille s'indiquent par ARRONDISSEMENT (ex. Lyon 1er = 69381, Paris 1er = 75101, Marseille 1er = 13201) : les codes « globaux » 69123 / 75056 / 13055 sont rejetés (400).

• distance : rayon en km autour de la commune (défaut 10 ; 0 = uniquement la commune).

• typeContrat : codes (ex. ['CDI','CDD','MIS']) — voir ft_list_referentiel typesContrats.

• experience : '1' (<1 an), '2' (1-3 ans), '3' (>3 ans).

• qualification : '0' (non cadre), '9' (cadre).

• tempsPlein : true/false.

• salaireMin + periodeSalaire (M=mensuel, A=annuel, H=horaire, C=autre) : obligatoires ENSEMBLE.

• publieeDepuis : 1, 3, 7, 14 ou 31 jours.

• sort : '0' pertinence (défaut), '1' date, '2' distance.

• offset (défaut 0) / limit (défaut 15, max 150) : pagination. Profondeur max ≈ 1150 résultats ; au-delà, affinez.

Exemples : « offres de boulanger en CDI à Lyon » → motsCles='boulanger', commune='69381' (Lyon 1er), typeContrat=['CDI']. « développeurs publiés cette semaine » → motsCles='développeur', publieeDepuis='7'.

Erreurs : 400 = paramètre/format invalide (vérifiez les codes) ; 403 = API non souscrite.

Récupère le détail complet d'une offre par son identifiant (champ 'id' renvoyé par ft_search_offres, ex. '209WHZN'). Renvoie l'intitulé, l'entreprise, le lieu, le contrat, le salaire, la description complète, les compétences/formations et le lien pour postuler. Erreur 404 si l'identifiant n'existe pas ou si l'offre n'est plus en ligne.

Restitue un référentiel de codes utilisé par la recherche d'offres (codes ↔ libellés). Indispensable pour traduire un nom en code (ex. trouver le code INSEE d'une commune, ou les codes de types de contrats). Types disponibles : communes, departements, regions, metiers, appellations, themes, domaines, continents, pays, naturesContrats, typesContrats, niveauxFormations, permis, langues, secteursActivites. Astuce : pour 'communes', filtrez vous-même par nom dans le résultat (la liste est longue).

Recherche un métier dans le référentiel ROME 4.0 par texte libre et renvoie les codes ROME correspondants (à 5 caractères, ex. M1607). Ces codes alimentent ft_search_offres (paramètre codeROME) et ft_search_entreprises. La recherche filtre sur le libellé des 532 métiers ROME (insensible à la casse/accents). Pour un rapprochement sémantique plus fin à partir d'un intitulé de poste, préférez ft_predict_rome.

Nécessite que l'application soit abonnée à l'API « ROME 4.0 - Métiers » sur francetravail.io.

Récupère la fiche d'un métier ROME 4.0 par son code (5 caractères, ex. 'M1607') : libellé, définition, accès au métier et arborescence (domaine professionnel, grand domaine). Nécessite l'abonnement à l'API « ROME 4.0 - Métiers ».

Récupère la fiche métier détaillée (format Fiche ROME) pour un code ROME : groupes de compétences (savoir-faire) et groupes de savoirs associés au métier. Utile pour préparer un CV, identifier des compétences à valoriser ou comprendre les attendus d'un métier. Nécessite l'abonnement à l'API « ROME 4.0 - Fiches métiers ».

Utilise ROMEO 2 (modèle d'IA de France Travail) pour rapprocher un intitulé de poste en texte libre des métiers/appellations ROME les plus probables, avec un score de confiance (0 à 1). C'est le meilleur moyen de convertir « ce que dit la personne » (ex. 'je répare des vélos', 'community manager') en code ROME exploitable par ft_search_offres et ft_search_entreprises.

Renvoie les prédictions triées par score décroissant. Ajustez seuilScore pour ne garder que les prédictions fiables. Nécessite l'abonnement à l'API « ROMEO 2 » sur francetravail.io.