API de métadonnées de films et de séries

Données de films et séries, compatibles TMDB et OMDb

Mêmes chemins et même JSON que TMDB v3 et OMDb. Changez l'URL de base, gardez votre code.

Obtenir une clé d'API Lire le démarrage rapide

BASE_URL

https://api.amodb.dev/3
https://api.amodb.dev/omdb/

~~https://api.themoviedb.org/3~~
https://api.amodb.dev/3
~~https://www.omdbapi.com/~~
https://api.amodb.dev/omdb/

GEThttps://api.amodb.dev/3/movie/550?language=en-US

200 OKapplication/json1,7 kBRéponse en direct

{  "id": 550,  "imdb_id": "tt0137523",  "title": "Fight Club",  "tagline": "Mischief. Mayhem. Soap.",  "release_date": "1999-10-15",  "runtime": 139,  "status": "Released",  "genres": [{ "id": 18, "name": "Drama" }, { "id": 53, "name": "Thriller" }],  "origin_country": ["US", "DE"],  "original_language": "en",  "budget": 63000000,  "revenue": 101209702,  "vote_average": 8.437,  "vote_count": 33042,  "popularity": 39.0054,  "poster_path": "/jSziioSwPVrOy9Yow3XhWIBDjq1.jpg",  "backdrop_path": "/b9HyPoxwxjxkWEUL5ErZdhApQe2.jpg"}

14 langues
2 styles d'API, TMDB v3 et OMDb
1 clé pour les deux styles
6 extensions en plus de TMDB

amodb est une API payante de métadonnées de films et séries. Elle garde chemins, paramètres et JSON de TMDB v3 et d'OMDb : un client existant fonctionne après changement d'URL de base. Une clé couvre les deux styles, 14 langues et affiches sur img.amodb.dev. Chaque offre inclut toutes les données et ne diffère que par les requêtes par minute.

01 · /3/movie/550

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.

Obtenez une clé

Choisissez une offre et copiez la clé depuis votre compte.
Authorization: Bearer $AMODB_KEY
Changez l’URL de base

Pointez votre client TMDB ou OMDb vers api.amodb.dev.
api.themoviedb.orgapi.amodb.dev
Déployez

Le même JSON revient, votre parseur fonctionne sans retouche.
200 OKapplication/json

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.

curl JavaScript Python

bashjspy

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

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);

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"
}

02 · /omdb/?i=tt0137523

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":"..."}.

curl JavaScript Python

bashjspy

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

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);

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"
}

03 · append_to_response

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.
GET /3/tv/1396/moods
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.
8.8 IMDb
8.4 TMDB
- Kinopoisk 8.7
- Metacritic 67
- Rotten Tomatoes 81%
GET /3/movie/550/ratings
Une limite de débit visible

Chaque réponse indique combien de requêtes il vous reste pour la minute en cours.
Toutes les tailles d'image TMDB

Des miniatures w92 aux fichiers originaux sur img.amodb.dev. Aucune clé nécessaire.
img.amodb.dev/t/p/w500/…
Recherche par identifiant externe

Envoyez un identifiant IMDb ou un autre identifiant externe et recevez la fiche TMDB.
GET /3/find/tt0137523
Séances de cinéma

Les séances par pays pour les titres à l'affiche, quand elles sont connues.
GET /3/movie/550/showtimes?country=US
Bandes originales

Les morceaux utilisés dans un film ou une série, sur la même URL de base.
1. 1 Dreaming of the Crash Hans Zimmer
2. 2 Cornfield Chase Hans Zimmer
3. 3 Dust Hans Zimmer
GET /3/movie/157336/soundtracks

05 · /plans

Les offres ne diffèrent que par les requêtes par minute

Chaque offre inclut tous les points de terminaison, les 14 langues, les images et les extensions. 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.

Lite

20 requêtes par minute

dès 3,11 $US par mois
Choisir Lite
Pro

40 requêtes par minute

dès 3,71 $US par mois
Choisir Pro
Pro+

120 requêtes par minute

dès 4,31 $US par mois
Choisir Pro+

Tarifs

06 · X-RateLimit-Remaining

Conçu pour le trafic de production

Cache de périphérie partagé

Les listes populaires restent en cache 30 minutes, les fiches détaillées 6 heures et configuration 24 heures.
Limites de débit claires

Chaque réponse porte X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Une réponse 429 ajoute Retry-After.
Erreurs de style TMDB

Les erreurs renvoient success, status_code et status_message : la gestion d'erreurs existante continue donc de fonctionner.
Images sans clé

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

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, 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 ?

Seulement le débit de requêtes : 20, 40 ou 120 requêtes par minute. Chaque offre inclut tous les points de terminaison, les 14 langues, les images et les extensions d'amodb.

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.

Commencez avec une clé

Chaque offre inclut tous les points de terminaison, les 14 langues et les images. Les offres ne diffèrent que par les requêtes par minute.

Obtenir une clé d'API Lire le démarrage rapide

$ curl https://api.amodb.dev/3/movie/550 -H "Authorization: Bearer $AMODB_KEY"

curl https://api.amodb.dev/3/movie/550 -H "Authorization: Bearer $AMODB_KEY"

Données de films et séries, compatibles TMDB et OMDb

Obtenez une clé

Changez l’URL de base

Déployez

Jauges d'ambiance

Les notes en un appel

Une limite de débit visible

Toutes les tailles d'image TMDB

Recherche par identifiant externe

Séances de cinéma

Bandes originales

Lite

Pro

Pro+

Cache de périphérie partagé

Limites de débit claires

Erreurs de style TMDB

Images sans clé