# Alternativa all'API Trakt

> Trakt è incentrato sui dati utente: cronologia, watchlist, valutazioni, calendari e OAuth. amodb non conserva alcuna attività degli utenti. È un'API di metadati a pagamento per film, serie TV, persone, immagini e valutazioni. Molte app usano entrambi: lo stato utente in Trakt o nel tuo database, i dati dei titoli da amodb.

## Compiti diversi, strumenti diversi

Trakt è incentrato sui dati utente: cronologia di visione, watchlist, valutazioni, calendari e accesso con OAuth. Ha anche endpoint pubblici di metadati, e la sua documentazione indica i limiti che si applicano. amodb ha un solo compito: i metadati di film, serie TV e persone, restituiti come JSON nel formato TMDB v3. Scegli Trakt per ciò che hanno fatto i tuoi utenti. Scegli amodb per ciò che è un titolo. La maggior parte delle app che hanno bisogno di entrambi chiama ciascun servizio per la sua metà.

## Dati utente e dati dei titoli

| Compito                  | Trakt                                                       | amodb                                                        |
| ------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------ |
| Cronologia di visione    | Funzione centrale                                           | Non offerto, salvala tu                                      |
| Watchlist e liste        | Funzione centrale                                           | Non offerto, le scritture restituiscono 405                  |
| Valutazioni degli utenti | Funzione centrale                                           | Non offerto, le scritture restituiscono 405                  |
| Calendari                | Per utente, vedi la loro documentazione                     | `next_episode_to_air` per serie e liste di palinsesto        |
| Accesso                  | OAuth                                                       | Solo chiave, nessun login utente                             |
| Metadati dei titoli      | Endpoint pubblici, per i limiti vedi la loro documentazione | Endpoint di dettaglio in 14 lingue                           |
| Cast e troupe            | Vedi la loro documentazione                                 | `/credits` per un titolo, `combined_credits` per una persona |
| Immagini                 | Vedi la loro documentazione                                 | `img.amodb.dev`, senza chiave                                |
| Trailer                  | Vedi la loro documentazione                                 | `/videos` con `type` e `official`                            |
| Modificato da una data   | Vedi la loro documentazione                                 | Non offerto, non ci sono feed delle modifiche                |

Per i palinsesti, `GET /3/tv/airing_today` e `GET /3/tv/on_the_air` elencano le serie per data di messa in onda, e ogni scheda di serie porta il proprio `next_episode_to_air`. Per una serie conclusa quel campo vale `null`. Entrambe le liste sono descritte nella pagina [tendenze e liste](https://amodb.dev/it/trending-lists/). Il calendario di un singolo utente è qualcosa che costruisci tu a partire dai tuoi dati di visione.

## Confronto delle funzionalità

| Funzionalità           | Trakt                                                                          | amodb                                                                             |
| ---------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| Modello di prezzo      | Vedi la loro documentazione                                                    | Periodi prepagati da 1 a 24 mesi                                                  |
| Piano gratuito         | Vedi la loro documentazione                                                    | Nessuno, e nessuna prova                                                          |
| Autenticazione         | OAuth per i dati utente, per le chiamate pubbliche 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                   | Sì                                                                             | Sì                                                                                |
| Serie TV               | Sì                                                                             | Sì, con stagioni ed episodi                                                       |
| Persone                | Vedi la loro documentazione                                                    | Sì                                                                                |
| Immagini               | Vedi la loro documentazione                                                    | `img.amodb.dev`, stessi token di dimensione di TMDB                               |
| Valutazioni            | Valutazioni degli utenti, vedi la loro documentazione                          | Punteggi di IMDb, Kinopoisk, Metacritic, Rotten Tomatoes e TMDB, quando sono noti |
| Limite di richieste    | Per i limiti vedi la loro documentazione                                       | 20, 40 o 120 al minuto per chiave                                                 |
| Uso commerciale        | 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

- **Nessuna schermata di login per i tuoi utenti.** Basta una chiave lato server. Nessuno collega un account, quindi non c'è alcun token da rinnovare e nessuna schermata di consenso da spiegare.
- **Ampiezza dei campi.** Durata, generi, case di produzione, classificazioni, traduzioni e parole chiave arrivano tutti dagli endpoint di dettaglio, nella lingua che chiedi.
- **Limiti pubblicati.** Il limite del piano è un numero al minuto, e ogni risposta mostra quanto resta. Con quei numeri puoi dimensionare una sincronizzazione in background.
- **Mood e colonne sonore.** Le estensioni nelle pagine [mood](https://amodb.dev/it/moods/) e [colonne sonore](https://amodb.dev/it/soundtracks/) aggiungono dati che non fanno parte di TMDB v3.

## Dove Trakt è più adatto

- **Tutto ciò che è personale.** Scrobbling, sincronizzazione della cronologia, liste social e calendari per utente sono funzioni di Trakt. amodb non ha account né metodi di scrittura.
- **Stato tra dispositivi.** Se un utente si aspetta gli stessi segni di «visto» su telefono e TV, lo stato deve vivere in un servizio utente, e amodb non lo è.
- **App OAuth esistenti.** Se la tua app possiede già token di Trakt, li mantieni. Aggiungi amodb solo per i dati dei titoli che ora recuperi altrove.

## Migrare ad amodb: collega i tuoi record

Non migri dati utente, perché amodb non ne conserva. Sostituisci le chiamate di metadati. Gli elementi di Trakt portano gli ID di altri database (per i campi esatti controlla la loro documentazione), quindi salva l'ID TMDB o l'ID IMDb accanto a ogni record di visione e usalo qui.

```php
<?php
declare(strict_types=1);

function amodb(string $path): array
{
    $ch = curl_init('https://api.amodb.dev/3' . $path);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')],
    ]);
    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($status !== 200) {
        throw new RuntimeException("amodb returned $status");
    }
    return json_decode($body, true);
}

$show = amodb('/tv/1396?language=en-US');
$next = $show['next_episode_to_air'] ?? null;
echo $show['name'], ' ', $show['status'], PHP_EOL;
echo $next ? 'Next: ' . $next['air_date'] : 'No episode scheduled', PHP_EOL;
```

Quando hai solo un ID IMDb, chiama una volta `/3/find/tt0903747?external_source=imdb_id` e tieni l'id di `tv_results`. Una risposta 429 include `Retry-After`, come descritto nella pagina [limiti di richieste](https://amodb.dev/it/rate-limits/).

## Dimensionare un job di aggiornamento

Una libreria utente di 200 serie richiede 200 richieste di dettaglio per un aggiornamento completo. A 20 richieste al minuto ci vogliono 10 minuti, a 40 ne bastano 5, e a 120 meno di 2. Il controllo della chiave viene prima della cache edge, quindi contano anche le chiamate ripetute. amodb non ha feed delle modifiche, quindi non può dirti quali ID sono cambiati da una certa data. Leggi invece `status` e `next_episode_to_air` dalla risposta dei dettagli. Aggiorna spesso le serie ancora in corso e di rado quelle concluse. I dettagli restano in cache 6 ore, quindi un aggiornamento più frequente restituisce gli stessi dati.

## Prezzi

amodb è prepagato e non si rinnova da solo. Scegli 1, 3, 6, 12 o 24 mesi, che danno 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 restituisce tutti i dati e non c'è un piano gratuito. Gli importi sono nella pagina dei [prezzi](https://amodb.dev/it/pricing/).

## Domande e risposte

### amodb può sostituire la cronologia e le watchlist di Trakt?

No. amodb non conserva alcuna attività degli utenti, e i metodi di scrittura in stile TMDB per account, sessioni, valutazioni e liste restituiscono 405 con status_code 37. Tieni la cronologia di visione in Trakt o nel tuo database.

### Mi serve OAuth per chiamare amodb?

No. Ogni richiesta porta la tua chiave nel parametro di query api_key o in un header Authorization Bearer. Non c'è un flusso di login utente, perché l'API serve metadati e non dati personali.

### Come collego i record di Trakt ai titoli di amodb?

Gli elementi di Trakt elencano gli ID di altri database come IMDb e TMDB (per i campi esatti controlla la loro documentazione). Un ID TMDB funziona direttamente su amodb, e un ID IMDb si risolve tramite /3/find con external_source=imdb_id.

### Esiste un calendario degli episodi in arrivo?

I dettagli di una serie danno next_episode_to_air per ogni serie che segui, e /tv/airing_today e /tv/on_the_air elencano le serie per palinsesto. amodb non costruisce un calendario per un utente specifico.

### Come si confrontano i limiti di richieste con quelli di Trakt?

Per i limiti di Trakt sugli endpoint pubblici di metadati controlla la loro documentazione. amodb consente 20, 40 o 120 richieste al minuto per chiave, a seconda del piano, e mostra il conteggio rimanente negli header di risposta.

## Pagine correlate

- [API per serie TV, stagioni ed episodi](https://amodb.dev/it/tv-show-api/): API serie TV con stato, emittenti, stagioni, episodi e next_episode_to_air. JSON compatibile TMDB v3 in 14 lingue, da 20 richieste al minuto.
- [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.
- [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.
- [Tendenze e endpoint delle liste](https://amodb.dev/it/trending-lists/): API tendenze con percorsi TMDB v3: classifiche giorno e settimana, più liste di film e serie in sala, popolari, più votati e in arrivo, cache di 30 minuti.
- [Autenticazione](https://amodb.dev/it/authentication/): Come inviare la chiave amodb: api_key nella query, un header Authorization Bearer o apikey per le chiamate OMDb. Formato, conservazione, rotazione, errori 401.
- [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/trakt-api-alternative/