# Alternativa all'API TheTVDB

> TheTVDB è incentrato sulle serie TV e offre più ordinamenti degli episodi, come trasmissione, DVD e assoluto. amodb copre serie, film e persone con una sola chiave e associa un ID TVDB al proprio con una chiamata. Elenca i gruppi di episodi di una serie ma non il loro contenuto, quindi la numerazione alternativa resta su TheTVDB.

## Quale si adatta a un progetto di serie TV

TheTVDB è incentrato sulle serie TV e conserva più ordinamenti degli episodi per una serie, tra cui trasmissione, DVD e assoluto, dietro un modello a chiave API. Controlla la loro documentazione sulla licenza prima di pianificare un prodotto commerciale. Scegli amodb quando vuoi serie, film e persone con una sola chiave, percorsi TMDB v3 e 14 lingue. Scegli TheTVDB quando la numerazione alternativa esatta è al centro della tua app, perché amodb elenca i gruppi di episodi di una serie ma non serve ciò che contengono.

## Come si corrispondono i dati delle serie

I concetti coincidono, ma i nomi sono diversi. Questa tabella copre ciò che di solito legge un'app per serie TV.

| Esigenza                     | Approccio TheTVDB                            | Chiamata amodb                                       |
| ---------------------------- | -------------------------------------------- | ---------------------------------------------------- |
| Una serie                    | Scheda della serie tramite ID TVDB           | `GET /3/tv/1396`, dopo una ricerca `tvdb_id`         |
| Elenco delle stagioni        | Vedi la loro documentazione                  | Array `seasons` nei dettagli della serie             |
| Una stagione con gli episodi | Vedi la loro documentazione                  | `GET /3/tv/1396/season/1`                            |
| Un episodio                  | Vedi la loro documentazione                  | `GET /3/tv/1396/season/1/episode/1`                  |
| Quali ordinamenti esistono   | Ordinamenti per trasmissione, DVD e assoluto | `GET /3/tv/1396/episode_groups`                      |
| Episodi di un ordinamento    | Vedi la loro documentazione                  | Non offerto, `/3/tv/episode_group/{id}` risponde 404 |
| Prossimo episodio in onda    | Vedi la loro documentazione                  | `next_episode_to_air` nei dettagli della serie       |

I campi degli episodi usano i nomi TMDB: `air_date`, `episode_number`, `season_number`, `runtime` e `still_path`. Gli `external_ids` di stagioni ed episodi sono tutti nulli, quindi l'ID TVDB di una singola stagione o di un episodio non si può leggere da amodb. Fai invece il join su `season_number` e `episode_number`. I dettagli sono nella pagina [stagioni ed episodi](https://amodb.dev/it/tv-seasons-episodes/).

## Cosa restituisce l'elenco dei gruppi di episodi

La chiamata di elenco mostra quali ordinamenti esistono per una serie. Non restituisce gli episodi che contengono.

| Campo           | Significato                                    |
| --------------- | ---------------------------------------------- |
| `id`            | ID del gruppo, una stringa                     |
| `name`          | Nome dell'ordinamento, come `DVD / PVOD`       |
| `description`   | Testo della fonte, spesso vuoto                |
| `type`          | Un numero che indica che tipo di ordinamento è |
| `episode_count` | Episodi nell'ordinamento                       |
| `group_count`   | Blocchi nell'ordinamento, come le stagioni     |
| `network`       | Un oggetto con l'emittente, oppure null        |

Questa è una risposta reale per Breaking Bad.

```json
{
  "id": 1396,
  "results": [
    {
      "description": "Seasons grouped as they appear on DVD, as well as paid video-on-demand services, such as Prime Video and YouTube.",
      "episode_count": 62,
      "group_count": 6,
      "id": "69f50757054263b7bc87e32a",
      "name": "DVD / PVOD",
      "network": null,
      "type": 3
    }
  ]
}
```

Alcune serie restituiscono un solo ordine di trasmissione e altre più d'uno, e alcune restituiscono un array `results` vuoto. Prova le serie che ti interessano. Poiché il contenuto di un gruppo non è offerto, un'app che ha bisogno del numero DVD o assoluto di ogni episodio non può ottenerlo da amodb.

## Confronto delle funzionalità

| Funzionalità           | TheTVDB                                                          | amodb                                                             |
| ---------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------- |
| Modello di prezzo      | Modello a chiave API, per la licenza vedi la loro documentazione | Periodi prepagati da 1 a 24 mesi                                  |
| Piano gratuito         | Vedi la loro documentazione                                      | Nessuno, e nessuna prova                                          |
| Autenticazione         | Chiave API, per il flusso vedi la loro documentazione            | `api_key` o header Bearer                                         |
| Formato della risposta | JSON, vedi la loro documentazione                                | JSON nel formato TMDB v3                                          |
| Lingue                 | Vedi la loro documentazione                                      | 14 lingue dell'interfaccia                                        |
| Film                   | Vedi la loro documentazione                                      | Sì                                                                |
| Serie TV               | Sì, è il suo focus principale                                    | Sì, con stagioni ed episodi                                       |
| Persone                | Vedi la loro documentazione                                      | Sì                                                                |
| Immagini               | Vedi la loro documentazione                                      | `img.amodb.dev`, senza chiave                                     |
| Valutazioni            | Vedi la loro documentazione                                      | IMDb e altre quattro fonti, quando sono note                      |
| Limite di richieste    | Vedi la loro documentazione                                      | 20, 40 o 120 al minuto per chiave                                 |
| Uso commerciale        | Per la licenza vedi la loro documentazione                       | Piani a pagamento, vedi i [prezzi](https://amodb.dev/it/pricing/) |
| Compatibilità          | La sua API                                                       | Letture TMDB v3 e OMDb                                            |

## Dove amodb è diverso

- **Una chiave per tutto il catalogo.** Una serie, il suo cast, i suoi trailer e un film che condivide un attore usano lo stesso URL di base e lo stesso limite.
- **Le valutazioni accanto alla guida agli episodi.** `append_to_response=ratings` sui dettagli di una serie aggiunge IMDb e altri punteggi in una sola chiamata.
- **Header semplici per regolare il ritmo.** `X-RateLimit-Remaining` e `X-RateLimit-Reset` dicono a un job di sincronizzazione quante richieste restano nella finestra di 60 secondi.
- **Nomi originali conservati.** Una serie mantiene `original_name` mentre `name` segue il tuo `language`, il che aiuta quando mostri un titolo nativo.

## Dove TheTVDB è più adatto

- **L'ordinamento è il prodotto.** Se i tuoi utenti discutono di ordine DVD contro trasmissione contro assoluto, TheTVDB lo tratta come parte centrale del suo modello. amodb nomina gli ordinamenti di una serie ma non ne restituisce gli episodi, e i gruppi esistenti cambiano da serie a serie.
- **Integrazioni esistenti.** Se la tua pipeline salva già gli ID TheTVDB e legge i suoi ordinamenti, tieni quella parte e aggiungi amodb per i dati extra.
- **Focus sulle serie TV.** Se non mostri mai film o persone, una fonte costruita attorno alle serie ha meno da imparare.

## Migrare ad amodb

Associa una volta gli ID TVDB che hai salvato. Dopo, usa l'ID amodb per ogni chiamata. L'endpoint find risolve solo gli ID delle serie. I suoi array `tv_season_results` e `tv_episode_results` sono sempre vuoti, quindi associa stagioni ed episodi per numero.

```js
const key = process.env.AMODB_KEY;
const headers = { Authorization: `Bearer ${key}` };
const base = 'https://api.amodb.dev/3';

async function getJson(path) {
  const res = await fetch(`${base}${path}`, { headers });
  if (!res.ok) throw new Error(`${path} returned ${res.status}`);
  return res.json();
}

const found = await getJson('/find/81189?external_source=tvdb_id');
const show = found.tv_results[0];
console.log(show.id, show.name);

const groups = await getJson(`/tv/${show.id}/episode_groups`);
for (const g of groups.results) {
  console.log(g.name, g.type, g.episode_count);
}
```

La prima richiesta restituisce Breaking Bad con id 1396. La seconda elenca gli ordinamenti che esistono per quella serie, con le loro dimensioni. Per confrontare la numerazione con quella che hai salvato ora, leggi l'ordine di trasmissione da `/tv/{id}/season/{n}` e lascia sul lato TheTVDB qualsiasi ordine alternativo. Fai questo controllo sulle dieci serie più guardate prima di spostare le altre.

Ogni chiamata conta come una richiesta nella finestra di 60 secondi, e una risposta 429 porta `Retry-After`. Vedi [ricerca per ID esterno](https://amodb.dev/it/find-by-external-id/) e [limiti di richieste](https://amodb.dev/it/rate-limits/).

## Prezzi

amodb è prepagato, senza rinnovo automatico. Scegli 1, 3, 6, 12 o 24 mesi e uno dei tre piani da 20, 40 o 120 richieste al minuto. I periodi più lunghi hanno uno sconto del 10, 20, 30 o 40 per cento, e ogni piano dà accesso a tutti i dati. Non esiste un piano gratuito. Gli importi sono nella pagina [prezzi](https://amodb.dev/it/pricing/).

## Domande e risposte

### Posso convertire gli ID TVDB in ID amodb?

Sì. Chiama /3/find/81189 con external_source=tvdb_id. L'array tv_results contiene la serie corrispondente: Breaking Bad torna con id 1396. Salva la coppia e usa da quel momento l'ID numerico. Vale anche il contrario: /3/tv/1396/external_ids restituisce tvdb_id.

### amodb supporta l'ordine DVD e quello assoluto degli episodi?

Solo in parte. GET /3/tv/{id}/episode_groups elenca i gruppi di una serie con name, type, episode_count e group_count. Il contenuto di un gruppo non è offerto, e /3/tv/episode_group/{id} risponde 404. Vedi che esiste un ordinamento DVD, ma non puoi leggerne la numerazione.

### TheTVDB è gratuito?

TheTVDB usa un modello a chiave API, e le condizioni di licenza sono stabilite da TheTVDB. Controlla la loro documentazione per la licenza attuale ed eventuali costi. amodb è un'API a pagamento prepagata, senza piano gratuito.

### Ottengo anche i dati dei film?

Sì. Film, persone, immagini, video e traduzioni usano la stessa chiave e lo stesso URL di base delle serie. Così non ti serve un secondo fornitore se la tua app elenca entrambi.

### Come scopro quale episodio va in onda dopo?

I dettagli di una serie includono next_episode_to_air e last_episode_to_air, ciascuno con season_number, episode_number e air_date. Il prossimo vale null per una serie conclusa. I dettagli restano in cache 6 ore sull'edge, quindi interrogali al massimo qualche volta al giorno.

## Pagine correlate

- [API di stagioni ed episodi delle serie TV](https://amodb.dev/it/tv-seasons-episodes/): API stagioni ed episodi con gli stessi percorsi e JSON di TMDB v3. Leggi una stagione con tutti gli episodi, o un episodio con data, durata e immagine.
- [Ricerca per ID esterno](https://amodb.dev/it/find-by-external-id/): Cerca un film, una serie o una persona per ID IMDb, TVDB, Wikidata o Kinopoisk con l'endpoint find di TMDB, e leggi ID esterni e dati Wikidata di un titolo.
- [API guida agli episodi](https://amodb.dev/it/episode-guide-api/): API guida agli episodi con gli endpoint di stagioni ed episodi di TMDB v3: nomi, date, durate, immagini e gruppi di episodi di ogni serie, in 14 lingue.
- [API delle serie TV](https://amodb.dev/it/tv-series/): API serie TV con gli stessi percorsi e JSON di TMDB v3. Ottieni una serie per ID con stagioni, emittenti e prossimo episodio, più classificazioni e piattaforme.
- [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.

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