Introduction

L’API Apprentissage de beta.gouv.fr offre un point d’entrée unique et documenté pour accéder à des données fiables et à jour sur l’apprentissage en France. Elle permet de connecter candidats, entreprises et organismes de formation, tout en simplifiant la recherche et la diffusion des opportunités d’alternance.
Depuis mars 2024, l’API est intégrée aux activités de La bonne alternance et du Tableau de bord de l’apprentissage, tout en restant accessible à tous[2][1].

Fonctionnalités Clés

• Recherche d’opportunités d’emploi et de formation en alternance via une API REST[1][10].
• Mise en relation entre candidats, entreprises et organismes de formation[1][8].
• Collecte et diffusion des besoins en recrutement en alternance pour les entreprises[1].
• Accès à un widget personnalisable, facile à intégrer sur tout site web[5].
• Filtrage avancé par métier (code ROME), géolocalisation, rayon, etc.[5][3].

Cas d’Utilisation

• Affichage sur un site d’école ou de collectivité des offres d’alternance locales.
• Automatisation de la collecte des besoins en alternance pour les entreprises partenaires.
• Création de portails d’orientation et de recherche d’emploi pour les jeunes.
• Suivi statistique et pilotage de l’apprentissage via le Tableau de bord de l’apprentissage[4].

Intégrer le Widget "La bonne alternance"

Le widget La bonne alternance permet d’afficher directement sur votre site les formations et entreprises qui accueillent des alternants, en interrogeant les données de l’API. Il est disponible en plusieurs formats et personnalisable avec différents paramètres (zone géographique, métiers, etc.)[5].

Exemple d’intégration du widget :

<iframe 
    style="height: 660px; width: 360px;max-width: 100%;margin: auto;display: block;" 
    src="https://labonnealternance.apprentissage.beta.gouv.fr/recherche-apprentissage?radius=30&romes=A1021,F1065&scope=all&lat=48.8566&lon=2.3522&caller=MonEtablissement" 
    frameborder="0"></iframe>
        

• perimetre : recherche-apprentissage (formations et emplois), recherche-emploi (emplois uniquement), recherche-apprentissage-formation (formations uniquement)
• romes : codes métiers ROME (facultatif)
• radius : rayon de recherche (10, 30, 60, 100 km, facultatif)
• lat/lon : latitude/longitude pour la géolocalisation (facultatif)
• caller : nom de votre établissement (obligatoire)

Astuce : Vous pouvez tester et personnaliser le widget sur l’espace développeur[1][5].

Exemples d’Implémentation

• JavaScript (postMessage)
• Requête API REST
• HTML (Widget)

// Gérer le bouton de retour du widget avec postMessage
window.addEventListener('message', function(e) {
    if (e.data.type === "goToPage") {
        // Redirigez l'utilisateur selon le paramètre reçu
        window.location.href = e.data.page;
    }
});
                

# Exemple de requête pour rechercher des offres d'alternance
curl "https://api.apprentissage.beta.gouv.fr/fr/explorer/recherche-offre?romes=A1021&lat=48.8566&lon=2.3522&radius=30"
                

<iframe 
    style="height: 660px; width: 360px;max-width: 100%;margin: auto;display: block;" 
    src="https://labonnealternance.apprentissage.beta.gouv.fr/recherche-apprentissage?radius=30&romes=A1021&lat=48.8566&lon=2.3522&caller=MonEtablissement" 
    frameborder="0"></iframe>
                

Conclusion

L’API Apprentissage facilite l’accès, la diffusion et la valorisation des opportunités d’alternance en France. Son intégration simple, via API REST ou widget, en fait un outil incontournable pour les établissements, collectivités et développeurs souhaitant promouvoir l’alternance et accompagner efficacement les jeunes dans leur parcours professionnel[1][2][5].