API di metadati per film e serie TV

L'API per film con tutte le valutazioni, compatibile con TMDB e OMDb

Cambia un solo URL, tieni il tuo codice TMDB o OMDb e ricevi nella stessa risposta le valutazioni di IMDb, Rotten Tomatoes, Metacritic e Kinopoisk.

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

200 OKapplication/json1,7 kBRisposta dal vivo

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

amodb è un'API a pagamento per film e serie TV che mantiene percorsi e JSON di TMDB v3 e OMDb, quindi il tuo codice funziona dopo aver cambiato l'URL di base. Una chiave aggiunge le valutazioni di IMDb, Rotten Tomatoes, Metacritic e Kinopoisk, indicatori di mood e colonne sonore, e l'uso commerciale è incluso in ogni piano prepagato.

01 · /compare?tmdb&omdb

Perché pagare un'API per i film quando TMDB è gratuito?

TMDB è gratuito finché la tua app non guadagna il primo dollaro. Dopo, TMDB chiede il suo piano commerciale, $149 al mese per le aziende con ricavi sotto $1M. TMDB non ha nemmeno i punteggi di IMDb, Rotten Tomatoes o Metacritic, e OMDb, la seconda API a cui di solito si ricorre, è concessa in licenza per l'uso non commerciale. amodb unisce entrambi i formati in una sola chiave, con l'uso commerciale incluso a partire da 3,11 USD al mese.

FunzionalitàTMDBOMDbamodb
Prezzo quando la tua app guadagna$149 al mese sotto $1M di ricaviTermini non commercialiA partire da 3,11 USD al mese
Percorsi e JSON di TMDB v3SìNoSì
Parametri e campi di OMDbNoSìSì
Valutazioni IMDb, Rotten Tomatoes e MetacriticNo, solo il voto TMDBSìSì, più Kinopoisk e TMDB
Indicatori di mood, colonne sonore e orari delle proiezioniNoNoSì
Nessun logo o avviso richiesto sulle tue schermateNo, logo e avviso obbligatoriNon indicatoSì
Una chiave per entrambi i formatiNoNoSì

Fonti: i termini dell'API di TMDB, le risposte dello staff di TMDB sui prezzi commerciali e su quando un'app è considerata commerciale e la pagina legale di OMDb, consultati a ottobre 2026.

02 · /3/movie/550

Cambia l'URL di base, tieni il tuo codice

amodb risponde sugli stessi percorsi di TMDB v3. Una richiesta per il film 550 restituisce gli stessi campi JSON che il tuo client già elabora: id, title, genres, release_date, poster_path e gli altri.

Invia la chiave come api_key nella query o nell'header Authorization: Bearer. Entrambi i modi funzionano su ogni endpoint.

  1. Prendi una chiave

    Scegli un piano e copia la chiave dal tuo account.

    Authorization: Bearer $AMODB_KEY
  2. Cambia l’URL di base

    Punta il tuo client TMDB o OMDb su api.amodb.dev.

    api.themoviedb.orgapi.amodb.dev
  3. Vai in produzione

    Torna lo stesso JSON, quindi il parser funziona senza modifiche.

    200 OKapplication/json
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"
}

03 · /omdb/?i=tt0137523

Una chiave per le chiamate in stile OMDb

L'endpoint compatibile con OMDb si trova su https://api.amodb.dev/omdb/. Accetta i, t, s, type, y, plot e page e restituisce Title, Year, imdbRating, Ratings e gli altri campi di OMDb.

Il campo Poster punta a img.amodb.dev, quindi le locandine si caricano dallo stesso servizio. Gli errori mantengono la forma di OMDb: {"Response":"False","Error":"..."}.

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

04 · append_to_response

Dati che TMDB v3 non restituisce

Ogni chiave può chiamare le estensioni di amodb sullo stesso URL di base. Aggiungile con append_to_response oppure chiamale da sole.

  • Indicatori di mood

    Paura, umorismo, tristezza, violenza e altro, ciascuno su una scala da 0 a 10, con una chiamata in più.

    GET /3/tv/1396/moods
  • Valutazioni in una chiamata

    IMDb, TMDB e altri tre punteggi con il numero di voti, da un solo endpoint.

    GET /3/movie/550/ratings
  • Un limite di richieste che puoi vedere

    Ogni risposta ti dice quante richieste restano in questo minuto.

    X-RateLimit-Limit: 40
  • Ogni dimensione di immagine TMDB

    Dalle miniature w92 ai file originali su img.amodb.dev. Nessuna chiave.

    img.amodb.dev/t/p/w500/…
  • Trova con qualsiasi ID esterno

    Invia un ID IMDb o un altro ID esterno e ricevi il record TMDB.

    GET /3/find/tt0137523
  • Orari delle proiezioni

    Gli orari per paese dei titoli in sala, quando sono noti.

    GET /3/movie/550/showtimes?country=US
  • Colonne sonore

    I brani usati in un film o in una serie, sullo stesso URL di base.

    GET /3/movie/157336/soundtracks

05 · ?language=uk-UA

Titoli e trame in 14 lingue

Passa in language un tag in stile TMDB, come ru-RU o pt-BR. amodb serve 14 lingue di base e ripiega sull'inglese per qualsiasi altro tag, quindi una richiesta non fallisce mai a causa della lingua.

Lingua

Spirited Away

Унесённые призраками

Віднесені привидами

Скрадзеныя прывідамі

千与千寻

A Viagem de Chihiro

Отнесени от духове

המסע המופלא

Cesta do fantazie

Călătoria lui Chihiro

Le Voyage de Chihiro

Spirited Away: W krainie Bogów

La città incantata

El viaje de Chihiro

  • en English Spirited Away
  • ru Русский Унесённые призраками
  • uk Українська Віднесені привидами
  • be Беларуская Скрадзеныя прывідамі
  • zh 中文 千与千寻
  • pt Português A Viagem de Chihiro
  • bg Български Отнесени от духове
  • he עברית המסע המופלא
  • cs Čeština Cesta do fantazie
  • ro Română Călătoria lui Chihiro
  • fr Français Le Voyage de Chihiro
  • pl Polski Spirited Away: W krainie Bogów
  • it Italiano La città incantata
  • es Español El viaje de Chihiro

Pensato per progetti personali e commerciali

Un progetto del weekend e un prodotto a pagamento chiamano la stessa API, ricevono gli stessi dati e sono coperti dagli stessi termini. Ecco cosa ci costruiscono i team.

  • App di streaming e liste da guardare Locandine, trailer, stagioni ed episodi, più cinque valutazioni per ordinare e filtrare.
  • Bot per Telegram e Discord Una ricerca in stile OMDb per titolo o ID IMDb restituisce una risposta pronta in una sola chiamata.
  • Media server e plugin Gli scraper di metadati che già parlano TMDB v3 mantengono il loro client e ottengono i punteggi di IMDb e Rotten Tomatoes.
  • Siti e blog di cinema Titoli e trame in 14 lingue, così ogni mercato ha la sua pagina.
  • Motori di raccomandazione Gli indicatori di mood valutano paura, umorismo, violenza e altro da 0 a 10, segnali che i soli generi non danno.
  • Agenti IA e chatbot Rispondi a «cosa guardo stasera?» con valutazioni reali, mood, cast e orari delle proiezioni.

06 · /plans

I piani differiscono per le richieste al minuto

Ogni piano offre gli stessi dati: gli endpoint di TMDB e OMDb, tutte le 14 lingue, le immagini e le estensioni. Pro+ include anche /3/all: tutto su un film, una serie o una persona in una sola richiesta. Paghi una volta per 1, 3, 6, 12 o 24 mesi e un periodo più lungo costa meno al mese. Non esistono un piano gratuito né il rinnovo automatico.

Prezzi

07 · X-RateLimit-Remaining

Pensato per il traffico di produzione

  • Cache edge condivisa

    Le liste popolari restano in cache per 30 minuti, i dettagli per 6 ore e configuration per 24 ore.

  • Limiti di richieste chiari

    Ogni risposta riporta X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Un 429 aggiunge Retry-After.

  • Errori in stile TMDB

    Gli errori restituiscono success, status_code e status_message, quindi la gestione degli errori che hai già continua a funzionare.

  • Immagini senza chiave

    Locandine e sfondi si caricano da img.amodb.dev/t/p/{size}/{file} in tutte le dimensioni TMDB, con cache di 30 giorni.

Domande e risposte

L'API di TMDB è gratuita per l'uso commerciale?

No. Una chiave TMDB è gratuita finché il tuo progetto non guadagna nulla. Lo staff di TMDB afferma che qualsiasi ricavo da pubblicità, acquisti in-app, donazioni o abbonamenti rende un'app commerciale, e il piano commerciale costa $149 al mese per le aziende con ricavi sotto $1M. amodb include l'uso commerciale in ogni piano.

Quanto costa l'API di TMDB?

È gratuita per l'uso non commerciale. Per un'app commerciale lo staff di TMDB indica $149 al mese quando i ricavi annui sono sotto $1M e un prezzo personalizzato oltre quella soglia. I piani di amodb costano pochi dollari al mese e differiscono soprattutto per le richieste al minuto.

Perché pagare amodb se l'API di TMDB è gratuita?

Perché un'app a pagamento non è gratuita su TMDB. amodb costa una frazione dei $149 del piano commerciale di TMDB, non richiede alcun logo sulle tue schermate e restituisce nella stessa risposta le valutazioni di IMDb, Rotten Tomatoes, Metacritic e Kinopoisk. Una chiave serve sia il formato TMDB v3 sia quello OMDb, quindi gestisci una sola API invece di due.

OMDb è gratuita per l'uso commerciale?

La pagina legale di OMDb descrive il servizio come destinato a un uso personale e non commerciale e distribuisce i suoi contenuti con licenza CC BY-NC 4.0. amodb risponde agli stessi parametri OMDb con gli stessi nomi di campo e l'uso commerciale è incluso.

Devo cambiare il codice del mio client TMDB?

No. Punta l'URL di base su https://api.amodb.dev/3 e invia la tua chiave amodb come api_key o come token Bearer. Percorsi, parametri di query e campi JSON restano quelli di TMDB v3.

La stessa chiave funziona per le chiamate in stile OMDb?

Sì. Inviala come apikey a https://api.amodb.dev/omdb/. I parametri i, t, s, type, y, plot e page funzionano come in OMDb e la risposta usa i nomi dei campi di OMDb.

Esiste un piano gratuito o una prova?

No. amodb è solo prepagato. Scegli un piano e un periodo, paghi una volta con carta, Apple Pay, Google Pay, criptovalute o Patreon e la chiave funziona fino alla fine del periodo. Non c'è rinnovo automatico.

Qual è la differenza tra i piani?

La frequenza delle richieste: 20, 40 o 120 al minuto. Ogni piano offre gli stessi dati, tutte le 14 lingue, le immagini, le valutazioni e le altre estensioni di amodb. Pro+ include anche /3/all: tutto su un film, una serie o una persona in una sola richiesta.

Quali lingue sono servite?

Inglese, russo, ucraino, bielorusso, cinese, portoghese, bulgaro, ebraico, ceco, rumeno, francese, polacco, italiano e spagnolo. Passa un tag in stile TMDB come ru-RU; qualsiasi altra lingua ripiega sull'inglese.

Parti con una sola chiave

Ogni piano offre gli stessi dati, tutte le 14 lingue e le immagini. I piani differiscono per le richieste al minuto e Pro+ include anche /3/all: tutto su un film, una serie o una persona in una sola richiesta.

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