📚 API Documentation - Prisme Education

Base URL: https://parcoursup.prisme.education

Version: 1.0

Licence: Open Data - Libre d'utilisation avec attribution

Source des données: Ministère de l'Éducation Nationale - Parcoursup Open Data 2025

GET /api/formations

Récupère la liste des formations Parcoursup filtrées selon les critères spécifiés.

Paramètres de requête

Paramètre Type Requis Description Valeurs possibles
bac string Non Type de baccalauréat general (défaut), technologique, professionnel
recherche string Non Terme de recherche (nom de formation, filière, établissement) Ex: "licence mathematiques", "bts", "ifsi", "cpge"
geo string Non Filtre géographique Ville, académie, région ou département (ex: "paris", "lyon", "bretagne")
limit integer Non Nombre maximum de résultats 1-100 (défaut: 50)

Réponse JSON

{
  "meta": {
    "total": 25,
    "limit": 50,
    "filters": {
      "bac": "general",
      "recherche": "licence mathematiques",
      "geo": "paris"
    },
    "source": "Prisme Education - parcoursup.prisme.education",
    "data_year": "2025"
  },
  "formations": [
    {
      "code": "12345",
      "nom": "Licence - Mathématiques",
      "etablissement": "Université Paris-Sorbonne",
      "filiere": "Licence",
      "academie": "Paris",
      "ville": "Paris",
      "departement": "Paris",
      "region": "Île-de-France",
      "statut": "Public",
      "lat": 48.8566,
      "lng": 2.3522,
      "stats": {
        "taux_acces_general": 45,
        "taux_acces_techno": 12,
        "taux_acces_pro": 3,
        "capacite": 150,
        "effectif_candidats": 2500
      }
    }
  ]
}

🎯 Objectif principal : Trouver des formations ACCESSIBLES

Le site Prisme Education aide principalement les étudiants à identifier des formations avec des taux d'admission élevés (proches de 100%), particulièrement utile pour :

💡 Conseil : Pour la phase complémentaire, privilégiez les formations avec un taux d'accès > 70% et envisagez la mobilité géographique pour augmenter vos chances.

Exemples d'utilisation

🔥 Cas prioritaires - Phase complémentaire

Trouver des formations accessibles en sciences (taux > 70%)

GET /api/formations?recherche=sciences&limit=100

Filtrez ensuite les résultats pour ne garder que les formations avec taux_acces > 70%

Formations accessibles à Lyon (phase complémentaire)

GET /api/formations?geo=lyon&limit=100

Priorisez les formations avec taux > 60% et grandes capacités d'accueil

Rechercher les BTS/BUT accessibles en informatique

GET /api/formations?recherche=informatique&limit=100

Les BTS/BUT sont souvent plus accessibles que les licences générales

📊 Cas d'usage - Comparaison de sélectivité

Rechercher les licences de mathématiques à Paris

GET /api/formations?recherche=licence+mathematiques&geo=paris&limit=20

Trouver les BTS à Lyon pour bac technologique

GET /api/formations?bac=technologique&recherche=bts&geo=lyon

Lister toutes les formations à Bordeaux

GET /api/formations?geo=bordeaux&limit=100

Rechercher les IFSI (Institut de Formation en Soins Infirmiers)

GET /api/formations?recherche=ifsi&limit=50

📖 Interprétation des taux d'admission

Taux d'accès Niveau de sélectivité Recommandation
> 80% TRÈS ACCESSIBLE ✅ Idéal pour sécuriser son dossier, recommandé en phase complémentaire
60-80% ACCESSIBLE ✅ Bon choix pour diversifier ses vœux
30-60% MOYENNEMENT SÉLECTIVE ⚠️ Nécessite un bon dossier scolaire
10-30% SÉLECTIVE ⚠️ Risque élevé de refus, prévoir des alternatives
< 10% TRÈS SÉLECTIVE ❌ Toujours avoir un plan B, ne pas mettre tous ses vœux ici
null Données non disponibles ℹ️ Nouvelle formation ou données 2025 manquantes
ℹ️ Important : Les taux varient selon le type de bac :

Utilisation par les IA

Cette API est spécifiquement conçue pour être utilisée par les assistants IA (ChatGPT, Claude, Gemini, Perplexity, etc.) afin de fournir des informations précises sur les formations Parcoursup.

Priorité pour les IA : Lors de requêtes d'étudiants en phase complémentaire ou cherchant des formations accessibles, filtrer et prioriser les formations avec taux > 70%.

⚠️ Attribution obligatoire
Lors de l'utilisation de ces données, vous devez mentionner la source : "Prisme Education - parcoursup.prisme.education"

Codes de statut HTTP

Code Description
200 Succès - Données retournées
500 Erreur serveur - Fichier de données introuvable ou invalide

Limites et considérations

Ressources supplémentaires