Découvrir api.bnf.fr
Qu'est-ce qu'api.bnf.fr ?
api.bnf.fr ou BnF API et jeux de données est le portail qui documente les API et les jeux de données de la Bibliothèque nationale de France (BnF).
Il a vocation à accompagner tous les utilisateurs qui souhaitent interroger, récupérer et réutiliser les données produites par la BnF.
Que trouve-t-on sur api.bnf.fr ?
Le portail api.bnf.fr documente de nombreuses méthodes pour accéder aux données :
- par les API (Application Programming Interface ou « interface de programmation d'application ») de la BnF : ce sont les applications qui permettent d'interroger et de récupérer les données.
On trouvera leur documentation technique et les liens pour y accéder. - par les jeux de données : ce sont des ensembles de données préconstitués, directement récupérables.
On trouvera leur documentation ainsi que des liens de téléchargement.
On distingue :- des jeux de données brutes : ce sont des données directement exportées à partir de bases ou réservoirs de données, et mises en ligne dans des formats spécifiques. Les dumps sont des jeux de données brutes.
- des jeux de données transformées : ce sont des données produites, modifiées ou enrichies dans le cadre d'un travail, notamment de recherche.
En complément, le portail met à disposition des ressources d'accompagnement pour utiliser les données de la BnF. On trouvera ainsi :
- de la documentation :
- des exemples d'utilisations (dont outils ou jeux de données non maintenus par la BnF) :
- des projets de recherche ;
- des expérimentations.
Depuis fin 2025, api.bnf.fr propose également un blog qui diffuse des actualités sur les données à la BnF.
Quelles données peut-on récupérer ?
Selon l'API ou le jeu de données, il est possible de récupérer des métadonnées (notices ou autres types de métadonnées descriptives) et/ou des documents (images, textes...).
Récupérer des métadonnées
Récupérer des documents
Pour toute réutilisation, il convient de consulter les conditions d'utilisation propre à chaque API ou jeu de données, indiquées dans la colonne de droite sur la page décrivant l'API ou le jeu de données.
Voir aussi : Conditions d'utilisation
À qui s'adresse api.bnf.fr ?
api.bnf.fr s'adresse à tout utilisateur des données de la BnF.
Le site propose des contenus qui peuvent particulièrement être utiles :
- aux professionnels des métiers du livre : bibliothèques, centre de documentation qui récupèrent les notices produites par la BnF pour leur propre catalogue ; éditeurs de logiciels de bibliothèque qui utilisent ces données ;
- aux chercheurs : étudiants, professionnels de la recherche qui ont besoin d'explorer et d'exploiter les données de la BnF.
Les API et données sont également utilisées par des développeurs ou dans le cadre de hackathons.
Comment trouver des contenus sur api.bnf.fr ?
Par l'interface de recherche
L'interface de recherche est accessible depuis le menu de navigation principale du site, par l'icône "loupe".
Elle permet d'explorer l'ensemble des contenus mis en ligne sur le portail, en filtrant sur un ou plusieurs critères.
Ces filtres se trouvent sur la gauche de l'écran de recherche, dans des facettes dépliables.
Les filtres disponibles sont détaillés ci-dessous.
Filtres disponibles : détail des facettes de recherche
La recherche propose 9 facettes, permettant d'opérer plusieurs types de filtres.
- Facette Source : permet de filtrer par source des données
- Facette Catégories : permet de filtrer par type de contenu :
- mode d'accès : API ou jeux de données
- nature des données récupérées : documents ou métadonnées
- exemples : projets de recherche ou expérimentations
- documentation : tutoriels, outils, guides, scénarios de recherche
- Facette Date de dernière mise à jour : permet de filtrer par date de mise à jour de l'API, des données ou du contenu
- Facette Formats techniques : permet de filtrer par format technique (notamment type de fichier de sortie)
- Facette Formats de description : permet de filtrer par format de description (notamment format bibliographique)
- Facette Technologies : permet de filtrer par technologie ou protocole
- Facette Sujets : permet de filtrer par mot-clé
- Facette Public : permet de filtrer sur des contenus dédiés à un public
- Facette Licence : permet de filtrer sur les conditions d'utilisation des données
Par le menu de navigation et la page d'accueil
Le menu de navigation principale et la page d'accueil proposent des accès directs vers l'interface de recherche pré-filtrée sur les critères choisis.
Par source des données
Les contenus peuvent être filtrés par source des données grâce à la facette de recherche correspondante ;
la page d'accueil du site permet également de choisir directement par quelle source de données on souhaite filtrer.
D'où viennent les données ?
Actuellement, les données récupérables par les API ou jeux de données décrits sur api.bnf.fr proviennent des sources suivantes.
Gallica
Gallica est la bibliothèque numérique de la BnF et de ses partenaires. Elle offre un accès libre et gratuit à plusieurs millions de documents numérisés de toutes époques et de tous supports.
Accéder à Gallica
Catalogue général de la BnF
Le catalogue général de la BnF est le catalogue en ligne qui contient la majorité des références des documents conservés sur tous les sites de la BnF, soit plus de 14 millions de documents.
Accéder au Catalogue général de la BnF
Mandragore
Mandragore est la base d'indexation iconographique des enluminures de la BnF. Régulièrement enrichie depuis 1989, elle décrit aujourd'hui 205 000 enluminures issues de près de 7000 manuscrits conservés au département des Manuscrits et à la Bibliothèque de l’Arsenal. Chaque élément identifiable y est indexé à l’aide d’un vocabulaire multilingue de plus de 20 000 termes.
Accéder à Mandragore
data.bnf.fr
Le projet data.bnf.fr valorise les fonds de la BnF sur le web et sert de pivot entre les ressources produites dans ses applications et celles qui sont accessibles dans le web de données.
Accéder à data.bnf.fr
Catalogue collectif de France (CCFr)
Le Catalogue collectif de France (CCFr) héberge plusieurs sources de données : Répertoire de bibliothèques et de fonds en France, Base patrimoine (imprimés patrimoniaux conservés dans les établissements territoriaux), Catalogue général des manuscrits (CGM, manuscrits, archives et iconographie conservés dans les établissements territoriaux).
Accéder au CCFr
Dépôt légal du Web
Dans le cadre du dépôt légal, la BnF collecte régulièrement un échantillon du web français, constitué à partir de collectes annuelles non sélectives et de collectes ciblées.
Plus d'informations sur le dépôt légal du web (sur bnf.fr)
BnF Archives et manuscrits
BnF Archives et Manuscrits est le catalogue dédié aux descriptions de manuscrits et d'archives littéraires et administratives, décrits sous forme d'instruments de recherche au format XML/EAD.
Accéder à BnF Archives et manuscrits
Bibliographie des éditions parisiennes du 16e siècle
La base BP16 (Bibliographie des éditions parisiennes du 16e siècle) a pour objet le recensement de la production imprimée à Paris tout au long du 16e siècle.
Accéder à BP16
Reliures
La base Reliures propose une sélection de reliures numérisées, accompagnées chacune d'une description détaillée, rédigée par la Réserve des livres rares de la BnF.
Accéder à Reliures
Données statistiques
Les données statistiques sont les données produites par la BnF sur son activité.
Qui contacter en cas de question ?
Les pages d'api.bnf.fr indiquent à quelle adresse courriel de contact il faut s'adresser selon le sujet, l'API ou le jeu de données décrit : cette adresse se trouve en colonne de droite, rubrique "Contact".
En cas de question plus générale, vous pouvez contacter la BnF.