# Alternativa all'API TMDB

> Cerca un'alternativa all'API TMDB quando vuoi un accordo a pagamento, un limite di richieste su cui pianificare o più dati in ogni risposta. amodb parla il protocollo TMDB v3 in lettura, quindi cambi l'URL di base e la chiave. Scritture e alcuni percorsi non sono offerti. Resta su TMDB se le sue condizioni gratuite ti bastano.

## Quale API scegliere

TMDB offre un'API gratuita per usi idonei secondo le proprie condizioni, con chiavi API v3 e token v4. Leggi quelle condizioni sull'uso commerciale e sull'attribuzione prima di pubblicare. Scegli un'alternativa quando vuoi un accordo a pagamento, un limite su cui pianificare o più dati in ogni risposta. amodb è un'API indipendente che parla il protocollo TMDB v3 in lettura, quindi passare significa cambiare l'URL di base e la chiave. È di sola lettura e alcuni percorsi TMDB non sono offerti, come elencato più sotto.

Resta su TMDB se le condizioni gratuite vanno bene per il tuo progetto e nulla nella sezione successiva ti riguarda.

## Segnali che ti serve un'alternativa

Cinque verifiche aiutano a decidere. Eseguile sul tuo traffico e sul tuo contratto, non su un elenco di funzionalità.

| Segnale                 | Cosa verificare                                                                  | Come risponde amodb                                                                                  |
| ----------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Condizioni commerciali  | Leggi le condizioni dell'API che usi oggi per l'uso commerciale e l'attribuzione | Piani a pagamento, prepagati, senza rinnovo automatico                                               |
| Traffico di picco       | Conta le richieste nel tuo minuto più carico                                     | Un limite fisso di 20, 40 o 120 richieste al minuto per chiave                                       |
| Dati per schermata      | Elenca le chiamate extra dietro una pagina di titolo                             | `append_to_response` accetta anche `ratings`, `moods`, `soundtracks`, `wikidata` e `showtimes`       |
| Lingua dell'interfaccia | Controlla ogni lingua che pubblichi                                              | 14 lingue, ogni altra ripiega su `en`                                                                |
| Costo di uscita         | Conta le righe di codice che nominano un fornitore                               | Stessi percorsi e stesso JSON sugli endpoint serviti, quindi anche uscire è un cambio di URL di base |

Contano anche le risposte dalla cache. Il controllo della chiave e il limite di richieste vengono prima della cache edge, quindi una richiesta ripetuta usa comunque una delle tue richieste al minuto. Pianifica sul totale delle richieste, non solo sui miss della cache.

## Confronto delle funzionalità

| Funzionalità           | TMDB                                                                     | amodb                                                                              |
| ---------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| Modello di prezzo      | API gratuita per usi idonei secondo le proprie condizioni                | Periodi prepagati di 1, 3, 6, 12 o 24 mesi                                         |
| Piano gratuito         | Sì, per usi idonei                                                       | Nessuno, e nessuna prova                                                           |
| Autenticazione         | Chiave v3 in `api_key`, o token v4 come Bearer                           | `api_key` o Bearer, chiave di 32 caratteri esadecimali                             |
| Formato della risposta | JSON                                                                     | JSON nel formato TMDB v3                                                           |
| Lingue                 | Vedi la loro documentazione                                              | 14 lingue dell'interfaccia                                                         |
| Film                   | Sì                                                                       | Sì                                                                                 |
| Serie TV               | Sì                                                                       | Sì, con stagioni ed episodi                                                        |
| Persone                | Sì                                                                       | Sì                                                                                 |
| Immagini               | Sì, dal proprio host di immagini                                         | `img.amodb.dev`, stessi token di dimensione, senza chiave                          |
| Valutazioni            | Punteggio degli utenti TMDB, per altre fonti vedi la loro documentazione | Punteggio TMDB più IMDb, Kinopoisk, Metacritic e Rotten Tomatoes, quando sono noti |
| Metodi di scrittura    | Metodi per account, liste e valutazioni                                  | Non offerti, rispondono 405                                                        |
| Limite di richieste    | Vedi la loro documentazione                                              | 20, 40 o 120 al minuto per chiave                                                  |
| Uso commerciale        | Per uso commerciale e attribuzione vedi le loro condizioni               | Venduto come API a pagamento, vedi i [prezzi](https://amodb.dev/it/pricing/)       |
| Compatibilità          | Definisce il protocollo v3                                               | La maggior parte dei percorsi di lettura v3, più OMDb                              |

## Dove amodb è diverso

- **Limiti leggibili.** Ogni risposta con chiave porta `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset` in secondi. Una risposta 429 aggiunge `Retry-After`. I valori sono spiegati nella pagina [limiti di richieste](https://amodb.dev/it/rate-limits/).
- **Blocchi extra in una sola chiamata.** Valutazioni da cinque fonti, mood, colonne sonore, fatti di Wikidata e orari delle proiezioni arrivano tramite `append_to_response`, così una pagina di titolo può bastarsi con una sola richiesta.
- **Più fonti di ID esterni.** `/3/find` risolve `imdb_id`, `tvdb_id`, `wikidata_id` e `kinopoisk_id`, e anche `facebook_id`, `twitter_id` e `instagram_id`. Vedi [ricerca per ID esterno](https://amodb.dev/it/find-by-external-id/).
- **OMDb con la stessa chiave.** `https://api.amodb.dev/omdb/` risponde alle chiamate in stile OMDb con un parametro `apikey`, il che aiuta quando due tuoi sistemi usano protocolli diversi.
- **Tempi di cache noti.** Dettagli e crediti restano 6 ore sull'edge, tendenze e discover 30 minuti, ricerca 10 minuti, configurazione 24 ore e immagini 30 giorni.

## Dove TMDB è più adatto

- **Progetti gratuiti.** Se il tuo uso rientra nelle condizioni gratuite, TMDB non costa nulla e amodb non può competere.
- **Metodi di scrittura per gli utenti.** TMDB offre metodi di scrittura per account, sessioni, valutazioni e liste. amodb risponde con 405 e status_code 37, quindi un'app che permette di accedere e valutare i titoli dovrebbe tenere TMDB per quella parte.
- **Feed delle modifiche.** TMDB elenca gli ID modificati. amodb non ha un feed simile, quindi aggiorni con i tuoi tempi.
- **Lingue oltre le 14.** amodb non serve l'interfaccia in tedesco, giapponese o coreano e ripiega sull'inglese. I titoli originali arrivano comunque in `original_title` e `original_name`. Per le altre lingue su TMDB, vedi la loro documentazione.
- **Condizioni già accettate.** Se la revisione legale è fatta per TMDB, cambiare ti costa un'altra revisione.

## Cosa amodb non offre

Controlla il tuo codice con questo elenco prima del passaggio. La tabella completa è nella pagina [amodb e TMDB](https://amodb.dev/it/amodb-vs-tmdb/).

| Chiamata TMDB                                                                                   | Risposta di amodb                          |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------ |
| Scritture per account, sessioni, valutazioni e liste                                            | 405, `status_code` 37                      |
| Modifiche, crediti aggregati, ricerche di crediti e recensioni, contenuto dei gruppi di episodi | 404, `status_code` 34                      |
| Traduzioni delle persone, immagini e traduzioni di collezioni, società e emittenti              | 404, `status_code` 34                      |
| Elenco delle recensioni di un film o di una serie                                               | 200, vuoto per la maggior parte dei titoli |
| Immagini, video e traduzioni delle stagioni                                                     | 200, vuoto                                 |
| ID esterni di stagioni ed episodi                                                               | 200, tutti nulli                           |

Due comportamenti sono silenziosi. Un nome di `append_to_response` che amodb non conosce, come `aggregate_credits`, viene ignorato senza errore. Anche il parametro `include_adult` viene ignorato, perché titoli e persone per adulti non vengono mai serviti.

## Migrare ad amodb

1. Scegli un piano nella pagina dei [prezzi](https://amodb.dev/it/pricing/) e crea una chiave nella dashboard del tuo account.
2. Sostituisci l'URL di base e la chiave in un solo punto, come qui sotto.
3. Leggi `images.secure_base_url` da `/3/configuration` così i link alle immagini usano `img.amodb.dev`.
4. Rimuovi le chiamate ai metodi di scrittura e ai percorsi della tabella qui sopra.
5. Gestisci il 429 attendendo i secondi di `Retry-After`.

```js
const config = {
  // before: baseUrl held your current TMDB v3 base URL
  baseUrl: 'https://api.amodb.dev/3',
  apiKey: process.env.AMODB_KEY,
};

const res = await fetch(`${config.baseUrl}/movie/550?language=en-US`, {
  headers: { Authorization: `Bearer ${config.apiKey}` },
});
if (!res.ok) throw new Error(`request failed with status ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

Esegui i test esistenti su entrambi gli URL di base prima del passaggio. Una struttura condivisa non garantisce valori identici, quindi confronta un campione dei tuoi titoli. La guida completa è nell'[avvio rapido](https://amodb.dev/it/quickstart/) e una tabella di confronto diretto è nella pagina [amodb e TMDB](https://amodb.dev/it/amodb-vs-tmdb/).

### La gestione degli errori si trasferisce

Le chiamate non riuscite restituiscono il corpo TMDB `{"success": false, "status_code": N, "status_message": "..."}`, quindi il codice che si ramifica su `status_code` non va riscritto.

| HTTP | status_code | Causa tipica                                               |
| ---- | ----------- | ---------------------------------------------------------- |
| 401  | 7           | Chiave mancante o scritta male                             |
| 401  | 10          | Chiave sospesa                                             |
| 402  | 36          | Periodo prepagato terminato                                |
| 404  | 34          | ID non trovato, o percorso che amodb non offre             |
| 405  | 37          | Un metodo di scrittura che il tuo codice chiama ancora     |
| 429  | 25          | Più richieste di quelle consentite dal piano in 60 secondi |

Tratta il 402 come un segnale per rinnovare a mano, perché nulla si rinnova automaticamente. L'elenco completo è nella pagina [errori](https://amodb.dev/it/errors/).

## Prezzi

amodb è prepagato. Scegli un periodo di 1, 3, 6, 12 o 24 mesi, che dà uno sconto di 0, 10, 20, 30 o 40 per cento, e uno dei tre piani da 20, 40 o 120 richieste al minuto. Ogni piano dà accesso a tutti i dati e nulla si rinnova automaticamente. Non c'è un piano gratuito né una prova. Gli importi attuali sono nella pagina dei [prezzi](https://amodb.dev/it/pricing/).

## Domande e risposte

### amodb sostituisce direttamente l'API TMDB?

Per la maggior parte degli endpoint di lettura, sì. Percorsi, parametri di query e campi JSON seguono TMDB v3, e funzionano sia api_key sia l'autenticazione Bearer. I metodi di scrittura restituiscono 405 con status_code 37. I feed delle modifiche, i crediti aggregati, le ricerche di crediti e recensioni e pochi altri percorsi restituiscono 404 con status_code 34.

### Gli URL delle mie immagini TMDB continueranno a funzionare?

La forma del percorso e i token delle dimensioni restano uguali, ma l'host è img.amodb.dev e non serve alcuna chiave. Leggi images.secure_base_url dall'endpoint di configurazione invece di scrivere un host nel codice, e il tuo codice per le immagini non richiede altre modifiche.

### amodb accetta un header Bearer come TMDB?

Sì. Invia Authorization: Bearer con la tua chiave amodb, oppure passa il parametro di query api_key. La chiave è di 32 caratteri esadecimali minuscoli, la stessa forma di una chiave TMDB v3.

### Come si confronta il costo con l'API gratuita di TMDB?

TMDB offre un'API gratuita per usi idonei secondo le proprie condizioni. amodb non ha un piano gratuito né una prova. Paghi in anticipo da 1 a 24 mesi su uno dei tre piani, e la pagina dei prezzi elenca gli importi attuali.

### Quale limite devo pianificare?

Misurati sul tuo minuto di picco. I piani consentono 20, 40 o 120 richieste al minuto per chiave in una finestra scorrevole di 60 secondi, e ogni piano restituisce tutti i dati. Gli header della risposta indicano quante richieste restano.

## Pagine correlate

- [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 OMDb](https://amodb.dev/it/omdb-api-alternative/): Hai raggiunto il limite giornaliero di OMDb? amodb risponde alle richieste in stile OMDb e serve anche gli endpoint TMDB v3, con la stessa chiave API.
- [API database di film per il tuo catalogo](https://amodb.dev/it/movie-database-api/): API database di film per la tua copia locale: film, persone, società, collezioni e parole chiave con ID collegati, finestre di date discover e ricerca per ID.
- [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.
- [Limiti di richieste](https://amodb.dev/it/rate-limits/): amodb limita ogni chiave per richieste al minuto in una finestra scorrevole di 60 secondi: 20, 40 o 120 in base al piano. Leggi gli header, gestisci il 429.
- [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.

Aggiornato: 2026-10-18. Source: https://amodb.dev/it/tmdb-api-alternative/