TMDB API
Une base de données complète de films, séries et personnalités, gratuite par API.
TMDB (The Movie Database) est une base de données collaborative dédiée au cinéma et à la télévision, accessible via une API REST gratuite. Elle fournit fiches de films et de séries, personnalités, affiches et images, bandes-annonces, génériques, genres, ainsi que des fonctions de recherche, de découverte et de tendances. Elle s'adresse aux développeurs qui construisent des applications de streaming, des catalogues, des outils de recommandation ou tout projet ayant besoin de métadonnées audiovisuelles riches et multilingues.
Que propose l'API TMDB ?
Tarifs de l'API TMDB
API gratuite. TMDB ne facture pas l'accès à l'API ; il faut un compte et accepter les conditions d'utilisation. Un usage commercial peut nécessiter un accord écrit distinct avec TMDB et, le cas échéant, le paiement de frais.
Offre gratuite — L'accès à l'API est gratuit. Il suffit de créer un compte TMDB, de demander une clé API depuis les paramètres et d'accepter les conditions d'utilisation. Aucun coût n'est facturé pour l'usage standard.
Authentification & intégration
Deux méthodes : une clé API (API key) classique passée en paramètre, ou un jeton d'accès Bearer (Read Access Token) dans l'en-tête Authorization. Des sessions invité (guest sessions) sont aussi disponibles pour certaines actions sans compte connecté.
API REST synchrone, réponses au format JSON (et JSONP). Un certain niveau de limitation de débit est appliqué. Des fonctions pratiques existent : append_to_response pour combiner plusieurs ressources en un appel, exports d'identifiants quotidiens, support des langues et régions, suivi des changements de contenu.
Cas d'usage de l'API TMDB
- Alimenter un catalogue de films et séries avec affiches, synopsis, notes et bandes-annonces.
- Construire un moteur de recherche et de découverte audiovisuelle filtrable par genre, année ou note.
- Afficher les contenus en tendance du jour ou de la semaine sur une page d'accueil.
- Récupérer les génériques complets (acteurs, réalisateurs) pour des fiches détaillées.
- Créer une application multilingue grâce au support des langues et régions.
- Synchroniser un référentiel local via les exports d'identifiants quotidiens et le suivi des changements.
✓ Points forts
- Gratuite, avec une base de données très riche et collaborative.
- Données multilingues et nombreuses images en haute résolution.
- Fonctions avancées : Discover filtré, Trending, append_to_response, exports quotidiens.
- Deux modes d'authentification (clé API ou jeton Bearer) et sessions invité.
- Documentation officielle claire et communauté active.
⚠ Limites
- L'usage commercial peut nécessiter un accord écrit distinct avec TMDB, éventuellement payant.
- L'attribution et l'usage du logo TMDB sont obligatoires pour identifier la source.
- Limitation de débit appliquée, à gérer pour les gros volumes.
- Données collaboratives : la complétude et l'exactitude peuvent varier selon les titres.
Questions fréquentes sur l'API TMDB
L'API TMDB est-elle gratuite ?
Oui, l'accès à l'API est gratuit. Il faut créer un compte, demander une clé API et accepter les conditions d'utilisation. Un usage commercial peut toutefois nécessiter un accord écrit distinct avec TMDB.
Comment s'authentifier ?
Soit avec une clé API classique passée en paramètre, soit avec un jeton d'accès Bearer (Read Access Token) dans l'en-tête Authorization. Des sessions invité existent aussi pour certaines actions.
Peut-on utiliser TMDB pour un projet commercial ?
C'est possible, mais un usage commercial peut nécessiter un accord écrit avec TMDB, éventuellement soumis à des frais. L'attribution et l'affichage du logo TMDB comme source sont par ailleurs obligatoires.
Comment récupérer affiche, synopsis et générique en un seul appel ?
En utilisant le paramètre append_to_response sur la fiche d'un film ou d'une série, qui permet de combiner plusieurs ressources (images, credits, vidéos) dans une seule réponse.
L'API gère-t-elle plusieurs langues ?
Oui, TMDB supporte les paramètres de langue et de région, ce qui permet de récupérer titres, synopsis et données localisés selon le public visé.
Dans quel format sont renvoyées les données ?
Au format JSON (et JSONP), standard pour les API REST.
