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 site api.bnf.fr regroupe de la documentation technique, des liens d'accès, des liens de téléchargements, mais aussi des supports d'accompagnement.
API
💡 Qu'est-ce qu'une API ?
Application Programming Interface ou « interface de programmation d'application », les API sont des applications qui permettent d'interroger et de récupérer les données.
Plusieurs API existent à la BnF, sur des données et des sources différentes.
→ Retrouvez la documentation de toutes les API de la BnF.
Jeux de données
💡 Qu'est-ce qu'un jeu de données ?
Ce sont des ensembles de données préconstitués, directement récupérables.
Les jeux de données de la BnF sont très divers dans leurs contenus et leurs formats.
Deux types de jeux de données sont proposés.
Les jeux de données brutes 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.
Les jeux de données transformées sont des données produites, modifiées ou enrichies dans le cadre d'un travail, notamment de recherche.
→ Retrouvez la documentation de tous les jeux de données brutes.
→ Retrouvez la documentation des tous les jeux de données transformées.
Documentation : des ressources d'accompagnement
Les ressources d'accompagnement sont des supports ou pages d'informations visant à accompagner les utilisateurs des données de la BnF, au-delà de la documentation directe des API et des jeux de données.
→ Retrouvez tous les tutoriels ; tous les outils ; tous les guides ; tous les focus sur des sujets spécifiques ; tous les scénarios de recherche.
Exemples d'utilisations
Les exemples d'utilisation mettent en avant des utilisations d'API ou de jeux de données, internes ou externes à la BnF.
→ Retrouvez toutes les utilisations dans le cadre de projets de recherche ; toutes les expérimentations.
Blog
Depuis 2025, la rubrique blog 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...).
Les types et formats de données sont très divers ; utilisez les filtres de la recherche pour parcourir les formats disponibles.
→ Retrouvez toutes les API ou les jeux de données permettant de récupérer des métadonnées.
→ Retrouvez toutes les API ou les jeux de données permettant de récupérer des documents.
Comment utiliser les données de la BnF ?
Pour toute réutilisation, il convient de consulter les conditions d'utilisation propres à 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
Pour un accompagnement sur l'utilisation d'une API ou d'un jeu de données, la colonne de droite indique une adresse courriel de contact (parfois hors BnF) : pour toute question, s'adresser aux interlocuteurs indiqués.
À 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", ou par la barre d'accès rapide (accessible au clavier avec la touche "Tabulation").
Elle permet de chercher dans l'ensemble de la documentation mise en ligne sur le portail, et d'affiner la recherche grâce à plusieurs filtres.
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, focus, 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 partie inférieure de la page d'accueil du site ou la page Sources permettent également de choisir directement par quelle source de données on souhaite filtrer.
D'où viennent les données ?
Les données récupérables par les API ou jeux de données décrits sur api.bnf.fr proviennent de plusieurs sources : catalogues, bibliothèque numérique, bases spécialisées... Retrouvez ci-dessous l'ensemble des sources et les liens vers leurs interfaces publiques (le cas échéant).
Sources des données
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 | → Accéder aux contenus api.bnf.fr concernant 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 | → Accéder aux contenus api.bnf.fr concernant le Catalogue général
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 | → Accéder aux contenus api.bnf.fr concernant 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 | → Accéder aux contenus api.bnf.fr concernant 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 | → Accéder aux contenus api.bnf.fr concernant le 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) | → Accéder aux contenus api.bnf.fr concernant le dépôt légal du web
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 | → Accéder aux contenus api.bnf.fr concernant 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 | → Accéder aux contenus api.bnf.fr concernant 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 | → Accéder aux contenus api.bnf.fr concernant Reliures
Données statistiques
Les données statistiques sont les données produites par la BnF sur son activité.
→ Accéder aux contenus api.bnf.fr concernant les données statistiques
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". C'est l'adresse à privilégier pour toute question en lien direct avec une API, un jeu de données ou un support d'accompagnement.
Pour toute remarques sur le site en lui-même, vous pouvez contacter l'équipe des services aux Professionnels (département des Métadonnées - BnF).
En cas de question plus générale, vous pouvez contacter la BnF.