# Documentation d'amodb

> Commencez par le démarrage rapide pour faire votre premier appel en deux minutes. Lisez ensuite comment fonctionnent les clés, les limites de débit, les erreurs, les langues et les images. amodb garde les chemins et le JSON de TMDB v3 et d'OMDb : la plupart des pages expliquent ce qui est identique, ce qu'amodb ajoute et les rares différences.

## URL de base

| Usage                | URL de base                               | Paramètre de clé                     |
| -------------------- | ----------------------------------------- | ------------------------------------ |
| Style TMDB v3        | `https://api.amodb.dev/3`                 | `api_key` ou `Authorization: Bearer` |
| Style OMDb           | `https://api.amodb.dev/omdb/`             | `apikey`                             |
| Images               | `https://img.amodb.dev/t/p/{size}/{file}` | aucun                                |
| Catalogue des offres | `https://api.amodb.dev/plans`             | aucun                                |

### Prise en main

- [Démarrage rapide](https://amodb.dev/fr/quickstart/): Faites votre premier appel amodb : obtenez une clé, demandez un film en curl, JavaScript, Python, PHP ou Go, puis chargez l'affiche. En moins de 2 minutes.
- [Authentification](https://amodb.dev/fr/authentication/): Comment envoyer votre clé amodb : api_key dans la requête, en-tête Authorization Bearer, ou apikey pour OMDb. Format, stockage, rotation et erreurs 401.

### Concepts

- [Limites de débit](https://amodb.dev/fr/rate-limits/): amodb limite chaque clé en requêtes par minute sur une fenêtre glissante de 60 secondes : 20, 40 ou 120 selon l'offre. Lisez les en-têtes et gérez le 429.
- [Erreurs](https://amodb.dev/fr/errors/): Chaque erreur amodb : statut HTTP, status_code et message TMDB, plus la forme d'erreur OMDb. Ce que chacune signifie et ce que votre client doit faire.
- [Langues](https://amodb.dev/fr/languages/): amodb sert titres, résumés et noms en 14 langues. Passez une balise TMDB comme ru-RU ou pt-BR dans language ; toute autre balise se replie sur l'anglais.
- [Images](https://amodb.dev/fr/images/): Chargez affiches, fonds et photos de profil depuis img.amodb.dev, avec les chemins et tailles TMDB de w92 à original. Sans clé, cache de 30 jours.

### Référence de l'API

- [API de détails de film](https://amodb.dev/fr/movies/): API de détails de film aux chemins et au JSON de TMDB v3. Obtenez un film par id, ajoutez crédits, notes et ambiances avec append_to_response, en 14 langues.
- [API des séries TV](https://amodb.dev/fr/tv-series/): API de séries TV aux chemins et au JSON de TMDB v3 : une série par id avec saisons, chaînes et prochain épisode, plus classifications et plateformes.
- [API des saisons et épisodes de séries TV](https://amodb.dev/fr/tv-seasons-episodes/): API de saisons et d'épisodes aux chemins et au JSON de TMDB v3. Lisez une saison avec tous ses épisodes, ou un épisode avec date de diffusion, durée et image.
- [API de détails de personne](https://amodb.dev/fr/people/): API de détails de personne aux chemins et au JSON de TMDB v3 : biographie, filmographie, ids externes et liste populaire d'un acteur ou d'un membre de l'équipe.
- [API des crédits](https://amodb.dev/fr/credits/): API crédits aux chemins et au JSON de TMDB v3. Distribution et équipe des films, séries, saisons et épisodes, avec les champs order, department et job.
- [API de recherche](https://amodb.dev/fr/search/): API de recherche aux chemins et au JSON de TMDB v3 : films, séries, personnes, collections, sociétés et mots-clés par texte, filtres d'année et pagination.
- [API Discover](https://amodb.dev/fr/discover/): API Discover avec les mêmes filtres que TMDB v3. Listez films et séries par genre, distribution, société, mot-clé, année, note, durée et plateforme.
- [Tendances et points de terminaison de listes](https://amodb.dev/fr/trending-lists/): API de tendances aux chemins TMDB v3 : classements jour et semaine, plus films et séries à l'affiche, populaires, mieux notés et à venir, cache de 30 minutes.
- [Genres et listes de référence](https://amodb.dev/fr/genres/): API de genres aux chemins TMDB v3 : identifiants de genres films et séries avec noms traduits, plus pays, langues, métiers, classifications et plateformes.
- [API d'images et hôte d'images](https://amodb.dev/fr/images-api/): API d'images de films aux chemins TMDB v3 : listez affiches, fonds, logos et images par titre, puis chargez-les depuis img.amodb.dev en 10 tailles sans clé.
- [API des vidéos et bandes-annonces](https://amodb.dev/fr/videos-trailers/): API de vidéos aux chemins TMDB v3 : listez bandes-annonces, teasers, extraits et making of d'un film ou d'une série, puis filtrez par type et langue.
- [API des traductions](https://amodb.dev/fr/translations/): API de traductions aux chemins TMDB v3 : lisez titres, résumés et slogans d'un film, d'une série ou d'un épisode dans toutes ses langues à la fois.
- [API des mots-clés](https://amodb.dev/fr/keywords/): API mots-clés aux chemins TMDB v3 : tags d'intrigue d'un film ou d'une série, recherche d'un mot-clé, ses films et with_keywords avec discover.
- [API des collections](https://amodb.dev/fr/collections/): API collections avec chemins TMDB v3 : récupérez une saga par id avec ses parties, lisez belongs_to_collection sur un film et cherchez par nom.
- [Sociétés et chaînes](https://amodb.dev/fr/companies-networks/): Sociétés de production et chaînes TV avec les chemins TMDB v3. Lisez nom, pays et logo par id, puis filtrez discover par id de société ou de chaîne.
- [Notes des films et séries](https://amodb.dev/fr/ratings/): API de notes de films : scores IMDb, Kinopoisk, Metacritic, Rotten Tomatoes et TMDB d'un titre en un appel, avec null pour toute source inconnue.
- [Recherche par identifiant externe](https://amodb.dev/fr/find-by-external-id/): Retrouvez un film, une série ou une personne par id IMDb, TVDB, Wikidata ou Kinopoisk avec find de TMDB, puis lisez ids externes et faits Wikidata.
- [Endpoint compatible OMDb](https://amodb.dev/fr/omdb-endpoint/): Endpoint compatible OMDb sur api.amodb.dev/omdb/. Cherchez par i ou t, recherchez avec s, lisez Ratings et gardez votre client en changeant l'URL de base.
- [Jauges d'ambiance](https://amodb.dev/fr/moods/): API d'ambiances avec jauges de 0 à 10 par titre. Lisez les ambiances d'un film ou d'une série, fusionnez avec append_to_response=moods, créez badges et filtres.
- [Bandes originales](https://amodb.dev/fr/soundtracks/): API de bandes originales : album et liste des morceaux d'un film ou d'une série. Appelez le point de terminaison ou ajoutez append_to_response=soundtracks.
- [Séances de cinéma](https://amodb.dev/fr/showtimes/): API de séances qui renvoie salles et horaires d'un film dans un pays, ou un résumé par pays. À fusionner aux détails ou à associer à now_playing.

### Ressources

- [Journal des modifications](https://amodb.dev/fr/changelog/): Les changements de l'API amodb, de l'hôte d'images img.amodb.dev, des offres et du site, par date. Entrées récentes en haut, avec ce qu'il faut faire.

- [Statut](https://amodb.dev/fr/status/): Savoir si amodb fonctionne : point de terminaison de santé public, codes d'erreur d'un incident, et comment signaler un problème avec les détails utiles.

- [Référence de l'API](https://amodb.dev/fr/reference/): Chaque point de terminaison amodb avec chemin, paramètres, exemples de requête en cinq langages et une vraie réponse JSON. Compatible TMDB v3 et OMDb.

- [Tutoriels](https://amodb.dev/fr/tutorials/): Tutoriels pas à pas pour l'API amodb : recherche, détails, images, langues et appels OMDb dans des environnements courants, avec du code à copier et à exécuter.

- [Comparer amodb](https://amodb.dev/fr/compare/): Comparatifs d'amodb avec d'autres API de métadonnées de films et séries : compatibilité, langues, limites, images et prix, avec des chiffres à vérifier.

- [Cas d'usage](https://amodb.dev/fr/use-cases/): Comment des équipes utilisent amodb pour les films et séries : catalogues, serveurs multimédias, bots, recherche, avec les points de terminaison utiles.

## Pages liées

- [Démarrage rapide](https://amodb.dev/fr/quickstart/): Faites votre premier appel amodb : obtenez une clé, demandez un film en curl, JavaScript, Python, PHP ou Go, puis chargez l'affiche. En moins de 2 minutes.
- [Authentification](https://amodb.dev/fr/authentication/): Comment envoyer votre clé amodb : api_key dans la requête, en-tête Authorization Bearer, ou apikey pour OMDb. Format, stockage, rotation et erreurs 401.
- [Tarifs](https://amodb.dev/fr/pricing/): Les offres amodb ne diffèrent que par les requêtes par minute : 20, 40 ou 120. Toutes incluent les données TMDB v3 et OMDb. Prépayé, sans renouvellement.

Mis à jour: 2026-10-18. Source: https://amodb.dev/fr/docs/
