API La bonne alternance

Pourquoi utiliser cette suite d’API ?

• Accéder gratuitement et en temps réel à l'ensemble des opportunités d'emploi et/ou de formation en alternance
• Maximiser la visibilité de vos offres d’emploi en alternance en les diffusant sur la plateforme La bonne alternance ainsi que ses sites partenaires
• Fluidifiez le parcours de vos utilisateurs en leur permettant de contacter les recruteurs et centres de formation en alternance directement depuis votre site

Routes d'API disponibles

Accéder aux opportunités d’emploi en alternance

Accédez gratuitement et en temps réel à l'ensemble des opportunités d'emploi en alternance disponibles sur le territoire français**.** Les opportunités d’emploi retournées sont celles collectées par La bonne alternance ainsi que ses sites partenaires.

Deux types d’opportunités d’emploi sont disponibles :

1. Des offres d’emploi en alternance
2. Des entreprises n'ayant pas diffusé d'offres, mais ayant été identifiées comme à fort potentiel d'embauche en alternance grâce à l'analyse de diverses données publiques (données de recrutement, données financières, etc.). Cette liste restreinte d'entreprises a vocation à rendre visible le marché caché de l’emploi et ainsi faciliter les démarches de candidatures spontanées des candidats à l’alternance.

💡 Vous pouvez rechercher dans l’ensemble des opportunités d’emploi selon les critères suivants : Code(s) ROME, RNCP, géolocalisation, niveau de diplôme et rayon de recherche.

Les résultats sont retournés par priorité de source (La bonne alternance puis ses partenaires), par distance croissante au lieu de recherche si ce dernier a été fourni en paramètre puis par date de création décroissante.

➡️ Documentation de cette route

Consulter une opportunité d’emploi en alternance

Accédez gratuitement et en temps réel au détail d'une opportunité d'emploi en alternance.

Cette route d'API est utilisée en complément de la route d'API de recherche d’opportunités d’emploi en alternance. Elle permet de récupérer une opportunité d’emploi à partir de son identifiant (fourni par la route d'API de recherche).

➡️ Documentation de cette route

Envoyer une candidature à une opportunité d’emploi en alternance

Afin de fluidifier le parcours de vos utilisateurs, cette route d'API vous permet de transmettre directement aux recruteurs les candidatures de vos usagers, sans que ces derniers n’aient à quitter votre site.

Pour cela, elle requiert uniquement la transmission des coordonnées et du CV du candidat. Un message de motivation, à destination du recruteur, peut également être transmis de manière facultative. La candidature est ensuite envoyée au recruteur par email.

Cette route d'API est utilisée en complément de la route d'API de recherche d’opportunités d’emploi en alternance.

La route d'API de recherche d'opportunités d'emploi en alternance vous donne accès, pour chaque opportunité pour laquelle nous disposons d'un email de contact, à un apply.recipient_id, à utiliser en paramètre d'appel de la route d'envoi d'une candidature.

➡️ Documentation de cette route

Accéder aux formations en apprentissage

Accéder gratuitement à l'ensemble des formations en apprentissage disponibles sur le territoire français.

Les formations retournées sont celles collectées par le catalogue des formations en apprentissage du réseau des Carif-Oref.

💡 Vous pouvez rechercher dans l’ensemble des formations selon les critères suivants : Code(s) ROME, Code(s) RNCP, géolocalisation, niveau de diplôme et rayon de recherche.

Les résultats sont retournés par distance croissante au lieu de recherche si ce dernier a été fourni.

➡️ Documentation de cette route

Contacter un centre de formation en apprentissage via un lien dédié

Récupérer un lien d’accès à un formulaire de prise de rendez-vous auprès d’un centre de formation.

Le lien récupéré est à mettre à disposition de vos usagers pour leur permettre de contacter le centre de formation proposant des formations qui les intéressent.

Vous devez fournir un identifiant de formation, qui peut être un identifiant Parcoursup, ONISEP ou une clé ministère éducatif qu'il vous est possible de récupérer via la route de recherche de formations en apprentissage.

➡️ Documentation de cette route

Diffuser vos offres d’emploi en alternance

Déposez, modifiez ou supprimez vos offres d’emploi en alternance pour maximiser leur visibilité en les diffusant sur la plateforme La bonne alternance ainsi que ses sites partenaires.

💡 Cette API vous permet de partager gratuitement vos offres en alternance de manière sécurisée et automatisée. Si vous préférez déposer vos offres via une interface, vous pouvez utiliser le formulaire de dépôt d’offre manuel proposé par La bonne alternance.

💡 Les offres diffusées via cette API doivent être rattachées au SIRET de l'employeur où s'exécutera le contrat.

➡️ Documentation de cette route

---

Widget - Des solutions clef en main, faciles à intégrer

Qu'est-ce qu'un widget ?

Un widget est un composant d’interface qui effectue une tâche ou fournit une fonctionnalité spécifique dans un espace dédié.
Concrètement, les widget La bonne alternance vous permettent d'exposer, en une ligne de code, des fonctionnalités issues du service La bonne alternance sur votre site.

Comment utiliser les widgets La bonne alternance ?

Le service La bonne alternance propose plusieurs widgets, exploitables selon vos besoins.

Chaque widget est accessible unitairement et gratuitement.

💡Afin de suivre vos usages et vous prévenir en cas de mise à jour, nous demandons à l'ensemble des utilisateurs de ces widgets de s'identifier grâce à la valorisation d'un paramètre détaillé dans chaque documentation.

Exposer les opportunités d’emploi et/ou de formations en alternance

Ce widget permet d'exposer les offres d'emploi et/ou de formation centralisées par La bonne alternance aux candidats, puis de leur permettre d'y postuler.

Les données exposées sur ce widget peuvent être filtrées

• sur un métier ou un ensemble de métiers (référentiel ROME ),
• sur une zone géographique donnée : adresse, ville, code postal, département
• sur le type d'opportunités à exposer, afin de n'exposer que les formations, que les emplois, ou les deux.

💡En tant que jobboard vous pouvez ainsi choisir de n'afficher que les opportunités d'emploi en alternance (offres + entreprises auprès desquelles adresser des candidatures spontanées).
En tant qu'OPCO, vous pouvez choisir de n'afficher que les formations et/ou les entreprises de vos branches professionnelles.
En tant que centre de formation, vous pourrez choisir de n'afficher que les entreprises correspondant à vos métiers ainsi que votre zone géographique.

🔎 Exemple d’exploitation du widget sur jassuremonfutur , en lançant une recherche “Chargé de clientèle” à “Paris”.

👉 Tester le widget en consultant cette page

📄 Intégrer le widget à votre site, en utilisant le code suivant au sein d’une balise HTML puis en remplaçant les valeurs des paramètres comme indiqué ci-dessous :

<iframe style="height: 660px; width: 360px;max-width: 100%;margin: auto;display: block;" src="https://labonnealternance.apprentissage.beta.gouv.fr/{perimetre}?radius={rayon}&romes={romes}&scope=all&lat={latitude}&lon={longitude}&caller={caller}" />

• perimètre (obligatoire) : remplacer {perimetre} par
  • recherche pour récupérer les formations et opportunités d’emploi en alternance.
  • recherche-emploi pour récupérer uniquement les opportunités d’emploi en alternance
  • recherche-formation pour récupérer uniquement les formations en apprentissage
• caller (obligatoire) : remplacer {caller} par le nom de votre établissement (ex : Parcoursup, 1jeune1solution, …)

• radius (facultatif) : Rayon de recherche autour du lieu en km. Sa valeur par défaut est 30. Si elle vous convient, vous pouvez supprimer la partie suivante de l’exemple radius={rayon}&. Si vous souhaitez instaurer une autre valeur, remplacez {rayon} par une des 4 valeurs suivantes : 10 | 30 | 60 | 100.

• romes (facultatif) : Métier(s) sur le(s)quel(s) vous souhaitez restreindre la recherche. Si vous ne souhaitez pas restreindre la liste des métiers, vous pouvez supprimer la partie suivante de l’exemple &romes={romes}. Si vous souhaitez instaurer une autre valeur, remplacez {romes} par une liste de maximum 20 codes romes séparés par des virgules. Exemple : A1021,F1065,F1066,F1067

• lat (facultatif) : Latitude géographique en degrés décimaux (float). Sa valeur par défaut est null

• lon (facultatif) : Longitude géographique en degrés décimaux (float). Sa valeur par défaut est null

Permettre aux candidats de postuler aux offres

Seulement dans le cas où l’offre dispose d’une adresse email dans le champ apply_email alors :

📄 Intégrer le widget à votre site, en utilisant le code suivant au sein d’une balise HTML puis en remplaçant les valeurs des paramètres comme indiqué ci-dessous :

<iframe style="height: 600px; width: 100%; overflow: hidden; margin: auto;display: block;" src="https://labonnealternance.apprentissage.beta.gouv.fr/postuler?caller={caller}&itemId={itemId}&type={type}" />

• caller (obligatoire) : remplacer {caller} par le nom de votre établissement (ex : Parcoursup, 1jeune1solution, …)

• type (obligatoire) : remplacer {type} par le type d'opportunité d'emploi. Les valeurs autorisées sont offres_emploi_lba, recruteurs_lba et offres_emploi_partenaires
  Le type à utiliser est dans le champ partner.label du retour de l'api La bonne alternance

• itemId (obligatoire) : remplacer {itemId} par l'identifiant de l'opportunité d'emploi à laquelle répondre. Cette valeur se trouve dans l'attribut « id » d'une opportunité d'emploi retournée par l'api offre lba

Des erreurs seront affichés dans les cas suivants :
- un ou plusieurs champs sont manquants
- l’id de l’offre ne correspond pas à une offre du type demandé
- le type de l’offre n’est pas conforme aux titres autorisés
- l’offre ne dispose pas d’adresse email de contact

Collecter des offres d’emploi en toute simplicité

Ce widget vous permet d'intégrer rapidement un formulaire simplifié de dépôt d’offres sur votre site.

🔎 Exemple d’exploitation du widget sur le site de l’OPCO AKTO

👉 Tester le widget en consultant cette page

📄 Intégrer le widget en utilisant le code suivant au sein d’une balise HTML, puis en remplaçant {caller} par le nom de votre établissement ainsi qu’un mode de contact (exemple "La bonne alternance - labonnealternance@apprentissage.beta.gouv.fr"), afin que nous puissions suivre votre usage du service et vous contacter en cas de mise à jour.

<iframe loading="lazy" src="https://labonnealternance.apprentissage.beta.gouv.fr/espace-pro/widget/{caller}/" width="100%" height="800" frameborder="0" style="max-width: 100%;"></iframe>

---

📊 Suivi & statistiques de nos API

Suivez en temps réel l’usage de l’API : Lien des statistiques de l'api

👥 L’équipe

Pour en savoir plus, consultez la présentation du service La bonne alternance.

🤝 Nos partenaires

La liste de nos partenaires est disponible ici.