Aller au contenu
API et notebooks
Explorer les formations

Réutiliser les données

Exports ouverts, API et exemples reproductibles.

API publique

Lecture sans compte ni clé. Chaque réponse contient la version source, les définitions et la couverture des indicateurs.

GET /api/v1/datasets?famille=parcoursup
famille
parcoursup, apprentissage ou apb. Parcoursup par défaut.
campagne
Année sur quatre chiffres. La plus récente disponible par défaut.
version
Identifiant de publication reçu dans source.releaseId. Conserve exactement cet instantané, même après une mise à jour.
format
json par défaut ; csv pour les lignes et leurs états ; metadata pour les définitions, la provenance et les liens.

Commencer une analyse

Les exemples enregistrent la version téléchargée, vérifient les états des valeurs et conservent les sources.

Python 3, bibliothèque standard. R nécessite jsonlite.

Lire les valeurs

Un zéro observé reste zéro. Une valeur absente, masquée ou invalide est null en JSON, avec son état dans states. Le CSV ajoute une colonne d’état à chaque indicateur.

Les candidatures cumulées ne comptent pas des personnes uniques. Les pourcentages ont des dénominateurs différents ; le taux d’accès n’est pas une probabilité individuelle.

Consulter la méthode

Périmètre et réponses

Une requête porte sur une famille, une campagne et une version, jusqu’à 30 000 lignes. Au-delà, l’API échoue explicitement. Les versions demandées ne sont jamais remplacées par une publication plus récente.

200 : données ou jeu encore vide. 400 : paramètre invalide. 404 : campagne ou version introuvable. 503 : service indisponible ou limite dépassée. Les réponses d’erreur ne sont pas mises en cache.