# L'API de films avec toutes les notes, compatible TMDB et OMDb

> amodb est une API payante de films et séries qui garde les chemins et le JSON de TMDB v3 et d'OMDb : votre code fonctionne après un simple changement d'URL de base. Une clé ajoute les notes IMDb, Rotten Tomatoes, Metacritic et Kinopoisk, des jauges d'ambiance et des bandes originales, et l'usage commercial est inclus dans chaque offre prépayée.

## Pourquoi payer une API de films quand TMDB est gratuit ?

TMDB est gratuit jusqu'à ce que votre application gagne son premier dollar. Ensuite, TMDB réclame son offre commerciale, $149 par mois pour les entreprises sous $1M de chiffre d'affaires. TMDB n'a pas non plus de notes IMDb, Rotten Tomatoes ou Metacritic, et OMDb, la deuxième API habituelle, est proposée sous licence non commerciale. amodb réunit les deux formats dans une seule clé, avec l'usage commercial inclus dès 3,11 $US par mois.

| Fonctionnalité                                      | TMDB                                         | OMDb                        | amodb                       |
| --------------------------------------------------- | -------------------------------------------- | --------------------------- | --------------------------- |
| Prix dès que votre application rapporte de l'argent | $149 par mois sous $1M de chiffre d'affaires | Conditions non commerciales | Dès 3,11 $US par mois       |
| Chemins et JSON de TMDB v3                          | Oui                                          | Non                         | Oui                         |
| Paramètres et champs d'OMDb                         | Non                                          | Oui                         | Oui                         |
| Notes IMDb, Rotten Tomatoes et Metacritic           | Non, seulement la note TMDB                  | Oui                         | Oui, plus Kinopoisk et TMDB |
| Jauges d'ambiance, bandes originales et séances     | Non                                          | Non                         | Oui                         |
| Aucun logo ni mention exigé sur vos écrans          | Non, logo et mention exigés                  | Non précisé                 | Oui                         |
| Une clé pour les deux formats                       | Non                                          | Non                         | Oui                         |

Sources : les [conditions de l'API TMDB](https://www.themoviedb.org/api-terms-of-use), les réponses de l'équipe de TMDB sur [la tarification commerciale](https://www.themoviedb.org/talk/69cbf4f91b914f0e9542a772) et sur [ce qui rend une application commerciale](https://www.themoviedb.org/talk/6ac5579ae24d7a00344571d5), et la [page légale d'OMDb](https://www.omdbapi.com/legal.htm), consultées en octobre 2026.

## Changez l'URL de base, gardez votre code

amodb répond sur les mêmes chemins que TMDB v3. Une requête pour le film 550 renvoie les mêmes champs JSON que votre client lit déjà : `id`, `title`, `genres`, `release_date`, `poster_path` et les autres.

Envoyez votre clé comme `api_key` dans la requête ou dans l'en-tête `Authorization: Bearer`. Les deux fonctionnent sur chaque point de terminaison.

```bash
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

```python
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
movie = res.json()
print(movie["title"], movie["release_date"])
```

```json
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}
```

## Une clé pour les appels de style OMDb

Le point de terminaison compatible OMDb se trouve à l'adresse `https://api.amodb.dev/omdb/`. Il accepte `i`, `t`, `s`, `type`, `y`, `plot` et `page`, et renvoie `Title`, `Year`, `imdbRating`, `Ratings` et les autres champs d'OMDb.

Le champ `Poster` pointe vers `img.amodb.dev` : les affiches se chargent donc depuis le même service. Les erreurs gardent la forme d'OMDb : `{"Response":"False","Error":"..."}`.

```bash
curl "https://api.amodb.dev/omdb/?i=tt0137523&plot=short&apikey=$AMODB_KEY"
```

```js
const url = new URL("https://api.amodb.dev/omdb/");
url.searchParams.set("t", "Fight Club");
url.searchParams.set("y", "1999");
url.searchParams.set("apikey", process.env.AMODB_KEY);

const film = await (await fetch(url)).json();
console.log(film.Title, film.imdbRating);
```

```python
import os
import requests

film = requests.get(
    "https://api.amodb.dev/omdb/",
    params={"i": "tt0137523", "apikey": os.environ["AMODB_KEY"]},
    timeout=10,
).json()
print(film["Title"], film["imdbRating"])
```

```json
{
  "Title": "Fight Club",
  "Year": "1999",
  "Runtime": "139 min",
  "Director": "David Fincher",
  "imdbRating": "8.8",
  "imdbID": "tt0137523",
  "Poster": "https://img.amodb.dev/t/p/w300/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
  "Response": "True"
}
```

## Des données que TMDB v3 ne renvoie pas

Chaque clé peut appeler les extensions d'amodb sur la même URL de base. Ajoutez-les avec `append_to_response` ou appelez-les séparément.

- **Jauges d'ambiance**: Peur, humour, tristesse, violence et plus encore, chacun sur une échelle de 0 à 10, avec un appel de plus.
- **Les notes en un appel**: Les notes d'IMDb, de TMDB et de trois autres sources, avec le nombre de votes, depuis un seul point de terminaison.
- **Une limite de débit visible**: Chaque réponse indique combien de requêtes il vous reste pour la minute en cours.
- **Un identifiant, 14 langues**: Le même film dans toutes les langues qu'amodb propose. Les balises inconnues se replient sur l'anglais.
- **Toutes les tailles d'image TMDB**: Des miniatures w92 aux fichiers originaux sur img.amodb.dev. Aucune clé nécessaire.
- **Recherche par identifiant externe**: Envoyez un identifiant IMDb ou un autre identifiant externe et recevez la fiche TMDB.
- **Séances de cinéma**: Les séances par pays pour les titres à l'affiche, quand elles sont connues.
- **Bandes originales**: Les morceaux utilisés dans un film ou une série, sur la même URL de base.

## Titres et résumés en 14 langues

Passez dans `language` une balise de style TMDB, comme `ru-RU` ou `pt-BR`. amodb sert 14 langues de base et se replie sur l'anglais pour toute autre balise : une requête n'échoue donc jamais à cause de la langue.

| Code | Language   | Native name | Example tag |
| ---- | ---------- | ----------- | ----------- |
| `en` | English    | English     | `en-US`     |
| `ru` | Russian    | Русский     | `ru-RU`     |
| `uk` | Ukrainian  | Українська  | `uk-UA`     |
| `be` | Belarusian | Беларуская  | `be-BY`     |
| `zh` | Chinese    | 中文          | `zh-CN`     |
| `pt` | Portuguese | Português   | `pt-BR`     |
| `bg` | Bulgarian  | Български   | `bg-BG`     |
| `he` | Hebrew     | עברית       | `he-IL`     |
| `cs` | Czech      | Čeština     | `cs-CZ`     |
| `ro` | Romanian   | Română      | `ro-RO`     |
| `fr` | French     | Français    | `fr-FR`     |
| `pl` | Polish     | Polski      | `pl-PL`     |
| `it` | Italian    | Italiano    | `it-IT`     |
| `es` | Spanish    | Español     | `es-ES`     |

## Conçu pour les projets personnels et commerciaux

Un projet du week-end et un produit payant appellent la même API, reçoivent les mêmes données et relèvent des mêmes [conditions d'utilisation](https://amodb.dev/fr/terms/). Voici ce que les équipes construisent avec.

- **Applications de streaming et de suivi :** affiches, bandes-annonces, saisons et épisodes, plus cinq notes pour trier et filtrer.
- **Bots Telegram et Discord :** une recherche de style OMDb par titre ou par identifiant IMDb renvoie une réponse prête en un seul appel.
- **Serveurs multimédias et plugins :** les scrapers de métadonnées qui parlent déjà TMDB v3 gardent leur client et gagnent les notes IMDb et Rotten Tomatoes.
- **Sites et blogs de cinéma :** titres et résumés en 14 langues, pour que chaque marché ait sa propre page.
- **Moteurs de recommandation :** les jauges d'ambiance notent la peur, l'humour, la violence et plus encore de 0 à 10, des signaux que les genres seuls ne donnent pas.
- **Agents IA et chatbots :** répondez à « que regarder ce soir ? » avec de vraies notes, des ambiances, la distribution et les séances.

## Les offres diffèrent par les requêtes par minute

Chaque offre donne accès aux mêmes données : les points de terminaison TMDB et OMDb, les 14 langues, les images et les extensions. Pro+ inclut aussi `/3/all` : tout sur un film, une série ou une personne en une seule requête. Vous payez une fois pour 1, 3, 6, 12 ou 24 mois, et une période plus longue coûte moins cher par mois. Il n'y a ni offre gratuite ni renouvellement automatique.

| Fonctionnalité                     | Lite      | Pro       | Pro+       |
| ---------------------------------- | --------- | --------- | ---------- |
| Requêtes par minute                | 20        | 40        | 120        |
| Requêtes par jour au débit maximal | 28 800    | 57 600    | 172 800    |
| Prix pour 1 mois                   | 5,19 $US  | 6,19 $US  | 7,19 $US   |
| Prix pour 3 mois                   | 14,01 $US | 16,71 $US | 19,41 $US  |
| Prix pour 6 mois                   | 24,91 $US | 29,71 $US | 34,51 $US  |
| Prix pour 12 mois                  | 43,60 $US | 52,00 $US | 60,40 $US  |
| Prix pour 24 mois                  | 74,74 $US | 89,14 $US | 103,54 $US |

## Conçu pour le trafic de production

Les listes populaires restent en cache 30 minutes, les fiches détaillées 6 heures et `configuration` 24 heures.
Chaque réponse porte `X-RateLimit-Limit`, `X-RateLimit-Remaining` et `X-RateLimit-Reset`. Une réponse 429 ajoute `Retry-After`.
Les erreurs renvoient `success`, `status_code` et `status_message` : la gestion d'erreurs existante continue donc de fonctionner.
Les affiches et les fonds se chargent depuis `img.amodb.dev/t/p/{size}/{file}` dans toutes les tailles TMDB, avec un cache de 30 jours.

## Questions et réponses

### L'API TMDB est-elle gratuite pour un usage commercial ?

Non. Une clé TMDB est gratuite tant que votre projet ne rapporte rien. Selon l'équipe de TMDB, tout revenu issu de publicités, d'achats intégrés, de dons ou d'abonnements rend une application commerciale, et l'offre commerciale coûte $149 par mois pour les entreprises sous $1M de chiffre d'affaires. amodb inclut l'usage commercial dans chaque offre.

### Combien coûte l'API TMDB ?

Elle est gratuite pour un usage non commercial. Pour une application commerciale, l'équipe de TMDB annonce $149 par mois quand le chiffre d'affaires annuel est inférieur à $1M, et un prix sur mesure au-delà. Les offres amodb coûtent quelques dollars par mois et diffèrent surtout par les requêtes par minute.

### Pourquoi payer amodb alors que l'API TMDB est gratuite ?

Parce qu'une application payante n'est pas gratuite chez TMDB. amodb coûte une fraction des $149 de l'offre commerciale de TMDB, n'exige aucun logo sur vos écrans et renvoie les notes IMDb, Rotten Tomatoes, Metacritic et Kinopoisk dans la même réponse. Une clé sert à la fois les formats TMDB v3 et OMDb : vous exploitez une seule API au lieu de deux.

### OMDb est-elle gratuite pour un usage commercial ?

La page légale d'OMDb présente le service comme réservé à un usage personnel et non commercial, et place son contenu sous licence CC BY-NC 4.0. amodb répond aux mêmes paramètres OMDb avec les mêmes noms de champs, et l'usage commercial est inclus.

### Dois-je modifier le code de mon client TMDB ?

Non. Pointez l'URL de base vers https://api.amodb.dev/3 et envoyez votre clé amodb comme api_key ou comme jeton Bearer. Les chemins, les paramètres de requête et les champs JSON restent ceux de TMDB v3.

### La même clé fonctionne-t-elle pour les appels de style OMDb ?

Oui. Envoyez-la comme apikey à https://api.amodb.dev/omdb/. Les paramètres i, t, s, type, y, plot et page fonctionnent comme dans OMDb, et la réponse utilise les noms de champs d'OMDb.

### Existe-t-il une offre gratuite ou un essai ?

Non. amodb est uniquement prépayé. Vous choisissez une offre et une période, vous payez une fois par carte, Apple Pay, Google Pay, en cryptomonnaie ou via Patreon, et la clé fonctionne jusqu'à la fin de la période. Il n'y a pas de renouvellement automatique.

### Quelle est la différence entre les offres ?

Le débit de requêtes : 20, 40 ou 120 requêtes par minute. Chaque offre donne accès aux mêmes données, aux 14 langues, aux images, aux notes et aux autres extensions d'amodb. Pro+ inclut aussi /3/all : tout sur un film, une série ou une personne en une seule requête.

### Quelles langues sont servies ?

Anglais, russe, ukrainien, biélorusse, chinois, portugais, bulgare, hébreu, tchèque, roumain, français, polonais, italien et espagnol. Passez une balise de style TMDB comme ru-RU ; toute autre langue se replie sur l'anglais.

## 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.
- [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.
- [amodb vs TMDB](https://amodb.dev/fr/amodb-vs-tmdb/): Comparatif amodb et TMDB : parité des endpoints, chemins non proposés, conditions gratuites ou payantes, 14 langues, extensions et limites de débit.
- [Alternative à l'API TMDB](https://amodb.dev/fr/tmdb-api-alternative/): Besoin d'une alternative à l'API TMDB ? Comparez conditions, limites et langues, puis passez à une API payante qui garde la plupart des chemins TMDB v3.

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