# Alternative à l'API Trakt

> Trakt se concentre sur les données utilisateur : historique, watchlists, notes, calendriers et OAuth. amodb ne stocke aucune activité utilisateur. C'est une API de métadonnées payante pour films, séries, personnes, images et notes. Beaucoup d'applications utilisent les deux : l'état utilisateur chez Trakt ou dans votre base, les données de titres chez amodb.

## Des rôles différents, des outils différents

Trakt se concentre sur les données utilisateur : historique de visionnage, watchlists, notes, calendriers et connexion OAuth. Il possède aussi des points de terminaison publics de métadonnées, et sa documentation indique les limites qui s'appliquent. amodb n'a qu'un seul rôle : les métadonnées des films, des séries et des personnes, renvoyées en JSON au format TMDB v3. Choisissez Trakt pour ce que vos utilisateurs ont fait. Choisissez amodb pour ce qu'est un titre. La plupart des applications qui ont besoin des deux appellent chaque service pour sa moitié.

## Données utilisateur et données de titres

| Rôle                     | Trakt                                                                   | amodb                                                          |
| ------------------------ | ----------------------------------------------------------------------- | -------------------------------------------------------------- |
| Historique de visionnage | Fonction centrale                                                       | Non proposé, stockez-le vous-même                              |
| Watchlists et listes     | Fonction centrale                                                       | Non proposé, les écritures renvoient 405                       |
| Notes des utilisateurs   | Fonction centrale                                                       | Non proposé, les écritures renvoient 405                       |
| Calendriers              | Par utilisateur, voir leur documentation                                | `next_episode_to_air` par série et listes de programmation     |
| Connexion                | OAuth                                                                   | Clé seule, pas de connexion utilisateur                        |
| Métadonnées de titres    | Points de terminaison publics, voir leur documentation pour les limites | Points de terminaison de détails en 14 langues                 |
| Distribution et équipe   | Voir leur documentation                                                 | `/credits` pour un titre, `combined_credits` pour une personne |
| Images                   | Voir leur documentation                                                 | `img.amodb.dev`, sans clé                                      |
| Bandes-annonces          | Voir leur documentation                                                 | `/videos` avec `type` et `official`                            |
| Modifié depuis une date  | Voir leur documentation                                                 | Non proposé, il n'y a pas de flux de changements               |

Pour la programmation, `GET /3/tv/airing_today` et `GET /3/tv/on_the_air` listent les séries par date de diffusion, et chaque fiche de série porte son propre `next_episode_to_air`. Pour une série terminée, ce champ vaut `null`. Les deux listes sont décrites sur [tendances et listes](https://amodb.dev/fr/trending-lists/). Le calendrier d'un utilisateur est quelque chose que vous assemblez à partir de vos propres données de visionnage.

## Comparatif des fonctionnalités

| Fonctionnalité    | Trakt                                                                               | amodb                                                                                 |
| ----------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Modèle tarifaire  | Voir leur documentation                                                             | Périodes prépayées de 1 à 24 mois                                                     |
| Offre gratuite    | Voir leur documentation                                                             | Aucune, et pas d'essai                                                                |
| Authentification  | OAuth pour les données utilisateur, voir leur documentation pour les appels publics | `api_key` ou en-tête Bearer                                                           |
| Format de réponse | JSON, voir leur documentation                                                       | JSON au format TMDB v3                                                                |
| Langues           | Voir leur documentation                                                             | 14 langues d'interface                                                                |
| Films             | Oui                                                                                 | Oui                                                                                   |
| Séries            | Oui                                                                                 | Oui, avec saisons et épisodes                                                         |
| Personnes         | Voir leur documentation                                                             | Oui                                                                                   |
| Images            | Voir leur documentation                                                             | `img.amodb.dev`, mêmes jetons de taille que TMDB                                      |
| Notes             | Notes des utilisateurs, voir leur documentation                                     | Notes d'IMDb, Kinopoisk, Metacritic, Rotten Tomatoes et TMDB quand elles sont connues |
| Limite de débit   | Voir leur documentation pour les limites                                            | 20, 40 ou 120 par minute et par clé                                                   |
| Usage commercial  | Voir leur documentation                                                             | Offres payantes, voir les [tarifs](https://amodb.dev/fr/pricing/)                     |
| Compatibilité     | Sa propre API                                                                       | Lectures TMDB v3 et OMDb                                                              |

## Ce qui distingue amodb

- **Pas d'écran de connexion pour vos utilisateurs.** Une clé côté serveur suffit. Personne ne connecte de compte, donc il n'y a aucun jeton à renouveler ni écran de consentement à expliquer.
- **Une grande variété de champs.** Durée, genres, sociétés de production, classifications, traductions et mots-clés viennent tous des points de terminaison de détails, dans la langue demandée.
- **Des limites publiées.** La limite de l'offre est un nombre par minute, et chaque réponse indique ce qu'il reste. Vous pouvez dimensionner une synchronisation en arrière-plan à partir de ces chiffres.
- **Ambiances et bandes originales.** Les extensions sur [ambiances](https://amodb.dev/fr/moods/) et [bandes originales](https://amodb.dev/fr/soundtracks/) ajoutent des données qui ne font pas partie de TMDB v3.

## Quand Trakt convient mieux

- **Tout ce qui est personnel.** Le scrobbling, la synchronisation de l'historique, les listes sociales et les calendriers par utilisateur sont des fonctions de Trakt. amodb n'a ni comptes ni méthodes d'écriture.
- **L'état entre appareils.** Si un utilisateur s'attend à retrouver les mêmes marques « vu » sur un téléphone et sur une télévision, l'état doit vivre dans un service utilisateur, et amodb n'en est pas un.
- **Les applications OAuth existantes.** Si votre application détient déjà des jetons Trakt, vous les gardez. Ajoutez amodb seulement pour les données de titres que vous récupérez aujourd'hui ailleurs.

## Migrer vers amodb : relier vos données

Vous ne migrez pas de données utilisateur, car amodb n'en détient aucune. Vous remplacez les appels de métadonnées. Les éléments Trakt portent des identifiants pour d'autres bases (voir leur documentation pour les champs exacts) : stockez l'identifiant TMDB ou IMDb à côté de chaque donnée de visionnage et utilisez-le ici.

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

Quand vous n'avez qu'un identifiant IMDb, appelez une fois `/3/find/tt0903747?external_source=imdb_id` et gardez l'id de `tv_results`. Une réponse 429 inclut `Retry-After`, comme décrit sur [limites de débit](https://amodb.dev/fr/rate-limits/).

## Dimensionner un travail d'actualisation

Une bibliothèque d'utilisateur de 200 séries demande 200 requêtes de détails pour une actualisation complète. À 20 requêtes par minute, cela prend 10 minutes, à 40 cela prend 5, et à 120 moins de 2. La vérification de la clé passe avant le cache de périphérie, donc les appels répétés comptent aussi. amodb n'a pas de flux de changements, il ne peut donc pas vous dire quels identifiants ont changé depuis une date. Lisez plutôt `status` et `next_episode_to_air` dans la réponse de détails. Actualisez souvent les séries encore en cours et rarement les séries terminées. Les détails restent en cache 6 heures : une actualisation plus fréquente renvoie les mêmes données.

## Tarifs

amodb est prépayé et ne se renouvelle pas tout seul. Choisissez 1, 3, 6, 12 ou 24 mois, qui donnent 0, 10, 20, 30 ou 40 pour cent de réduction, et l'une des trois offres à 20, 40 ou 120 requêtes par minute. Chaque offre renvoie toutes les données et il n'y a pas d'offre gratuite. Les montants sont sur les [tarifs](https://amodb.dev/fr/pricing/).

## Questions et réponses

### amodb peut-il remplacer l'historique et les watchlists de Trakt ?

Non. amodb ne stocke aucune activité utilisateur, et les méthodes d'écriture de compte, de session, de notation et de liste de style TMDB renvoient 405 avec status_code 37. Gardez l'historique de visionnage dans Trakt ou dans votre propre base de données.

### Ai-je besoin d'OAuth pour appeler amodb ?

Non. Chaque requête porte votre clé dans le paramètre de requête api_key ou dans un en-tête Authorization Bearer. Il n'y a pas de parcours de connexion utilisateur, car l'API sert des métadonnées et non des données personnelles.

### Comment relier les fiches Trakt aux titres amodb ?

Les éléments Trakt listent des identifiants pour d'autres bases comme IMDb et TMDB (voir leur documentation pour les champs exacts). Un identifiant TMDB fonctionne directement sur amodb, et un identifiant IMDb se résout via /3/find avec external_source=imdb_id.

### Existe-t-il un calendrier des épisodes à venir ?

Les détails d'une série donnent next_episode_to_air pour chaque série suivie, et /tv/airing_today et /tv/on_the_air listent les séries par programmation. amodb ne construit pas de calendrier pour un utilisateur précis.

### Comment se comparent les limites de débit avec celles de Trakt ?

Consultez leur documentation pour les limites de Trakt sur les points de terminaison publics de métadonnées. amodb autorise 20, 40 ou 120 requêtes par minute et par clé selon l'offre, et affiche le nombre restant dans les en-têtes de réponse.

## Pages liées

- [API de séries TV pour les séries, les saisons et les épisodes](https://amodb.dev/fr/tv-show-api/): API de séries TV avec statut, chaînes, saisons, épisodes et next_episode_to_air. JSON compatible TMDB v3 en 14 langues, dès 20 requêtes par minute.
- [API des séries TV](https://amodb.dev/fr/tv-series/): API de séries TV aux chemins et au JSON de TMDB v3 : une série par id avec saisons, chaînes et prochain épisode, plus classifications et plateformes.
- [Recherche par identifiant externe](https://amodb.dev/fr/find-by-external-id/): Retrouvez un film, une série ou une personne par id IMDb, TVDB, Wikidata ou Kinopoisk avec find de TMDB, puis lisez ids externes et faits Wikidata.
- [Tendances et points de terminaison de listes](https://amodb.dev/fr/trending-lists/): API de tendances aux chemins TMDB v3 : classements jour et semaine, plus films et séries à l'affiche, populaires, mieux notés et à venir, cache de 30 minutes.
- [Authentification](https://amodb.dev/fr/authentication/): Comment envoyer votre clé amodb : api_key dans la requête, en-tête Authorization Bearer, ou apikey pour OMDb. Format, stockage, rotation et erreurs 401.
- [Tarifs](https://amodb.dev/fr/pricing/): Les offres amodb ne diffèrent que par les requêtes par minute : 20, 40 ou 120. Toutes incluent les données TMDB v3 et OMDb. Prépayé, sans renouvellement.

Mis à jour: 2026-10-18. Source: https://amodb.dev/fr/trakt-api-alternative/