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

> 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.

## 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à                                                | TMDB                             | OMDb                    | amodb                         |
| ----------------------------------------------------------- | -------------------------------- | ----------------------- | ----------------------------- |
| Prezzo quando la tua app guadagna                           | $149 al mese sotto $1M di ricavi | Termini non commerciali | A partire da 3,11 USD al mese |
| Percorsi e JSON di TMDB v3                                  | Sì                               | No                      | Sì                            |
| Parametri e campi di OMDb                                   | No                               | Sì                      | Sì                            |
| Valutazioni IMDb, Rotten Tomatoes e Metacritic              | No, solo il voto TMDB            | Sì                      | Sì, più Kinopoisk e TMDB      |
| Indicatori di mood, colonne sonore e orari delle proiezioni | No                               | No                      | Sì                            |
| Nessun logo o avviso richiesto sulle tue schermate          | No, logo e avviso obbligatori    | Non indicato            | Sì                            |
| Una chiave per entrambi i formati                           | No                               | No                      | Sì                            |

Fonti: i [termini dell'API di TMDB](https://www.themoviedb.org/api-terms-of-use), le risposte dello staff di TMDB sui [prezzi commerciali](https://www.themoviedb.org/talk/69cbf4f91b914f0e9542a772) e su [quando un'app è considerata commerciale](https://www.themoviedb.org/talk/6ac5579ae24d7a00344571d5) e la [pagina legale di OMDb](https://www.omdbapi.com/legal.htm), consultati a ottobre 2026.

## 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.

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

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

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

## 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ù.
- **Valutazioni in una chiamata**: IMDb, TMDB e altri tre punteggi con il numero di voti, da un solo endpoint.
- **Un limite di richieste che puoi vedere**: Ogni risposta ti dice quante richieste restano in questo minuto.
- **Un ID, 14 lingue**: Lo stesso film in ogni lingua servita da amodb. I tag sconosciuti ripiegano sull'inglese.
- **Ogni dimensione di immagine TMDB**: Dalle miniature w92 ai file originali su img.amodb.dev. Nessuna chiave.
- **Trova con qualsiasi ID esterno**: Invia un ID IMDb o un altro ID esterno e ricevi il record TMDB.
- **Orari delle proiezioni**: Gli orari per paese dei titoli in sala, quando sono noti.
- **Colonne sonore**: I brani usati in un film o in una serie, sullo stesso URL di base.

## 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.

| 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`     |

## 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](https://amodb.dev/it/terms/). 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.

## 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.

| Funzionalità                               | Lite      | Pro       | Pro+       |
| ------------------------------------------ | --------- | --------- | ---------- |
| Richieste al minuto                        | 20        | 40        | 120        |
| Richieste al giorno alla frequenza massima | 28.800    | 57.600    | 172.800    |
| Prezzo per 1 mese                          | 5,19 USD  | 6,19 USD  | 7,19 USD   |
| Prezzo per 3 mesi                          | 14,01 USD | 16,71 USD | 19,41 USD  |
| Prezzo per 6 mesi                          | 24,91 USD | 29,71 USD | 34,51 USD  |
| Prezzo per 12 mesi                         | 43,60 USD | 52,00 USD | 60,40 USD  |
| Prezzo per 24 mesi                         | 74,74 USD | 89,14 USD | 103,54 USD |

## Pensato per il traffico di produzione

Le liste popolari restano in cache per 30 minuti, i dettagli per 6 ore e `configuration` per 24 ore.
Ogni risposta riporta `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`. Un 429 aggiunge `Retry-After`.
Gli errori restituiscono `success`, `status_code` e `status_message`, quindi la gestione degli errori che hai già continua a funzionare.
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.

## Pagine correlate

- [Avvio rapido](https://amodb.dev/it/quickstart/): Fai la prima chiamata ad amodb: ottieni una chiave, richiedi i dettagli di un film in curl, JavaScript, Python, PHP o Go, carica la locandina. Meno di 2 minuti.
- [Prezzi](https://amodb.dev/it/pricing/): I piani amodb differiscono solo per le richieste al minuto: 20, 40 o 120. Ogni piano include tutti i dati TMDB v3 e OMDb. Prepagato, senza rinnovo né prova.
- [amodb vs TMDB](https://amodb.dev/it/amodb-vs-tmdb/): Confronto diretto tra amodb e TMDB: parità degli endpoint, percorsi non offerti, condizioni gratuite o a pagamento, 14 lingue, estensioni e limiti di richieste.
- [Alternativa all'API TMDB](https://amodb.dev/it/tmdb-api-alternative/): Cerchi un'alternativa all'API TMDB? Confronta condizioni, limiti e lingue, poi passa a un'API a pagamento che mantiene i percorsi di lettura TMDB v3.

Aggiornato: 2026-10-19. Source: https://amodb.dev/it/