# Alternativa a la API de Trakt

> Trakt se centra en datos de usuario: historial, listas de seguimiento, puntuaciones, calendarios y OAuth. amodb no almacena actividad de usuario. Es una API de metadatos de pago para películas, TV, personas, imágenes y puntuaciones. Muchas aplicaciones usan ambas: el estado del usuario en Trakt o en tu base de datos, y los datos de títulos desde amodb.

## Trabajos distintos, herramientas distintas

Trakt se centra en datos de usuario: historial de visionado, listas de seguimiento, puntuaciones, calendarios e inicio de sesión con OAuth. También tiene endpoints de metadatos públicos, y su documentación indica los límites que se aplican. amodb tiene un solo trabajo: metadatos de películas, TV y personas, devueltos como JSON con la forma de TMDB v3. Elige Trakt para lo que hicieron tus usuarios. Elige amodb para saber qué es un título. La mayoría de las aplicaciones que necesitan ambos llaman a cada servicio para su mitad.

## Datos de usuario frente a datos de títulos

| Tarea                          | Trakt                                                           | amodb                                                          |
| ------------------------------ | --------------------------------------------------------------- | -------------------------------------------------------------- |
| Historial de visionado         | Función principal                                               | No se ofrece, guárdalo tú mismo                                |
| Listas de seguimiento y listas | Función principal                                               | No se ofrece, las escrituras devuelven 405                     |
| Puntuaciones de usuario        | Función principal                                               | No se ofrece, las escrituras devuelven 405                     |
| Calendarios                    | Por usuario, consulta su documentación                          | `next_episode_to_air` por serie y listas de programación       |
| Inicio de sesión               | OAuth                                                           | Solo clave, sin inicio de sesión de usuario                    |
| Metadatos de títulos           | Endpoints públicos, consulta su documentación sobre los límites | Endpoints de detalle en 14 idiomas                             |
| Reparto y equipo técnico       | Consulta su documentación                                       | `/credits` para un título, `combined_credits` para una persona |
| Imágenes                       | Consulta su documentación                                       | `img.amodb.dev`, sin necesidad de clave                        |
| Tráileres                      | Consulta su documentación                                       | `/videos` con `type` y `official`                              |
| Cambios desde una fecha        | Consulta su documentación                                       | No se ofrece, no hay feeds de cambios                          |

Para las programaciones, `GET /3/tv/airing_today` y `GET /3/tv/on_the_air` listan las series por fecha de emisión, y cada registro de serie lleva su propio `next_episode_to_air`. En una serie que ha terminado, ese campo es `null`. Ambas listas se describen en [tendencias y listas](https://amodb.dev/es/trending-lists/). El calendario de un usuario es algo que montas a partir de tus propios registros de visionado.

## Comparación de funciones

| Función               | Trakt                                                                              | amodb                                                                                 |
| --------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Modelo de precios     | Consulta su documentación                                                          | Periodos prepago de 1 a 24 meses                                                      |
| Nivel gratuito        | Consulta su documentación                                                          | Ninguno, y sin periodo de prueba                                                      |
| Autenticación         | OAuth para datos de usuario, consulta su documentación sobre las llamadas públicas | `api_key` o cabecera Bearer                                                           |
| Formato de respuesta  | JSON, consulta su documentación                                                    | JSON con la forma de TMDB v3                                                          |
| Idiomas               | Consulta su documentación                                                          | 14 idiomas de interfaz                                                                |
| Películas             | Sí                                                                                 | Sí                                                                                    |
| TV                    | Sí                                                                                 | Sí, con temporadas y episodios                                                        |
| Personas              | Consulta su documentación                                                          | Sí                                                                                    |
| Imágenes              | Consulta su documentación                                                          | `img.amodb.dev`, los mismos tokens de tamaño que TMDB                                 |
| Puntuaciones          | Puntuaciones de usuario, consulta su documentación                                 | Puntuaciones de IMDb, Kinopoisk, Metacritic, Rotten Tomatoes y TMDB cuando se conocen |
| Límite de solicitudes | Consulta su documentación sobre los límites                                        | 20, 40 o 120 por minuto por clave                                                     |
| Uso comercial         | Consulta su documentación                                                          | Planes de pago, consulta los [precios](https://amodb.dev/es/pricing/)                 |
| Compatibilidad        | Su propia API                                                                      | Lecturas de TMDB v3 y OMDb                                                            |

## En qué se diferencia amodb

- **Sin pantalla de inicio de sesión para tus usuarios.** Basta una clave en el servidor. Nadie conecta una cuenta, así que no hay token que renovar ni pantalla de consentimiento que explicar.
- **Amplitud de campos.** La duración, los géneros, las productoras, las clasificaciones por edad, las traducciones y las palabras clave salen de los endpoints de detalle, en el idioma que pidas.
- **Límites publicados.** El límite del plan es un número por minuto, y cada respuesta muestra lo que queda. Con esos números puedes dimensionar una sincronización en segundo plano.
- **Medidores de mood y bandas sonoras.** Las extensiones de [moods](https://amodb.dev/es/moods/) (ambiente emocional) y de [bandas sonoras](https://amodb.dev/es/soundtracks/) añaden datos que no forman parte de TMDB v3.

## Dónde encaja mejor Trakt

- **Todo lo personal.** El scrobbling, la sincronización del historial, las listas sociales y los calendarios por usuario son funciones de Trakt. amodb no tiene cuentas ni métodos de escritura.
- **Estado entre dispositivos.** Si un usuario espera las mismas marcas de visto en un teléfono y en un televisor, el estado debe vivir en un servicio de usuarios, y amodb no lo es.
- **Aplicaciones OAuth existentes.** Si tu aplicación ya guarda tokens de Trakt, los conservas. Añade amodb solo para los datos de títulos que ahora obtienes en otro sitio.

## Migrar a amodb: une tus registros

No migras datos de usuario, porque amodb no guarda ninguno. Sustituyes las llamadas de metadatos. Los elementos de Trakt llevan ids de otras bases de datos (consulta su documentación para ver los campos exactos), así que guarda el id de TMDB o el de IMDb junto a cada registro de visionado y úsalo aquí.

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

Cuando solo tengas un id de IMDb, llama una vez a `/3/find/tt0903747?external_source=imdb_id` y conserva el id de `tv_results`. Un 429 incluye `Retry-After`, como se describe en [límites de solicitudes](https://amodb.dev/es/rate-limits/).

## Dimensionar un trabajo de actualización

Una biblioteca de usuario de 200 series necesita 200 solicitudes de detalle para actualizarse una vez. A 20 solicitudes por minuto tarda 10 minutos, a 40 tarda 5 y a 120 tarda menos de 2. La comprobación de la clave se ejecuta antes de la caché perimetral, así que las llamadas repetidas también cuentan. amodb no tiene feeds de cambios, así que no puede decirte qué ids cambiaron desde una fecha. Lee en su lugar `status` y `next_episode_to_air` de la respuesta de detalles. Actualiza a menudo las series que siguen en emisión, y pocas veces las que ya terminaron. Los detalles se guardan 6 horas en caché, así que una actualización más frecuente devuelve los mismos datos.

## Precios

amodb es prepago y no se renueva solo. Elige 1, 3, 6, 12 o 24 meses, que dan un descuento del 0, 10, 20, 30 o 40 por ciento, y uno de tres planes de 20, 40 o 120 solicitudes por minuto. Todos los planes devuelven todos los datos y no hay nivel gratuito. Los importes están en [precios](https://amodb.dev/es/pricing/).

## Preguntas y respuestas

### ¿Puede amodb sustituir el historial de visionado y las listas de seguimiento de Trakt?

No. amodb no almacena actividad de usuario, y los métodos de escritura de cuenta, sesión, puntuación y listas al estilo TMDB devuelven 405 con status_code 37. Guarda el historial de visionado en Trakt o en tu propia base de datos.

### ¿Necesito OAuth para llamar a amodb?

No. Cada solicitud lleva tu clave en el parámetro de consulta api_key o en una cabecera Authorization Bearer. No hay flujo de inicio de sesión de usuario porque la API sirve metadatos, no datos personales.

### ¿Cómo uno los registros de Trakt con los títulos de amodb?

Los elementos de Trakt listan ids de otras bases de datos, como IMDb y TMDB (consulta su documentación para ver los campos exactos). Un id de TMDB funciona directamente en amodb, y un id de IMDb se resuelve con /3/find y external_source=imdb_id.

### ¿Hay un calendario de próximos episodios?

Los detalles de la serie dan next_episode_to_air para cada serie que sigues, y /tv/airing_today y /tv/on_the_air listan las series por programación. amodb no construye un calendario para un usuario concreto.

### ¿Cómo son los límites en comparación con los de Trakt?

Consulta la documentación de Trakt para ver sus límites en los endpoints de metadatos públicos. amodb permite 20, 40 o 120 solicitudes por minuto por clave, según el plan, y muestra el recuento restante en las cabeceras de respuesta.

## Páginas relacionadas

- [API de series de TV para temporadas y episodios](https://amodb.dev/es/tv-show-api/): API de series de TV con estado, cadenas, temporadas, episodios y next_episode_to_air. JSON de TMDB v3 en 14 idiomas, desde 20 solicitudes por minuto.
- [API de series de TV](https://amodb.dev/es/tv-series/): API de series de TV con las mismas rutas y JSON que TMDB v3. Obtén una serie con temporadas, cadenas y próximo episodio, más clasificaciones y plataformas.
- [Buscar por id externo](https://amodb.dev/es/find-by-external-id/): Busca una película, serie o persona por id de IMDb, TVDB, Wikidata o Kinopoisk con el endpoint find de TMDB, y lee los ids externos y los datos de Wikidata.
- [Endpoints de tendencias y listas](https://amodb.dev/es/trending-lists/): API de películas en tendencia con rutas TMDB v3: rankings diarios y semanales, más cartelera, populares, mejor valoradas y estrenos. Caché de 30 minutos.
- [Autenticación](https://amodb.dev/es/authentication/): Cómo enviar tu clave de amodb: api_key en la consulta, un encabezado Bearer o apikey en llamadas OMDb. Formato, almacenamiento, rotación y errores 401.
- [Precios](https://amodb.dev/es/pricing/): Los planes de amodb se diferencian solo en solicitudes por minuto: 20, 40 o 120. Todos incluyen todos los datos de TMDB v3 y OMDb. Prepago y sin renovación.

Actualizado: 2026-10-18. Source: https://amodb.dev/es/trakt-api-alternative/