Alternativa a la API de TMDB

Qué API elegir

TMDB ofrece una API gratuita para usos que cumplan sus condiciones, con claves de API v3 y tokens v4. Lee esos términos sobre uso comercial y atribución antes de publicar. Elige una alternativa cuando quieras un acuerdo de pago, un límite con el que puedas planificar, o más datos en cada respuesta. amodb es una API independiente que habla el protocolo TMDB v3 para lecturas, así que el cambio supone una nueva URL base y una nueva clave. Es de solo lectura, y algunas rutas de TMDB no se ofrecen, como se indica más abajo.

Quédate en TMDB si los términos gratuitos encajan con tu proyecto y nada de la siguiente sección te afecta.

Señales de que necesitas una alternativa

Cinco comprobaciones te ayudan a decidir. Hazlas con tu propio tráfico y tu propio contrato, no con una lista de funciones.

Los aciertos de caché también cuentan. La comprobación de la clave y el límite de solicitudes se ejecutan antes de la caché perimetral, así que una solicitud repetida sigue consumiendo una de tus solicitudes por minuto. Planifica según el total de solicitudes, no según los fallos de caché.

Comparación de funciones

En qué se diferencia amodb

• Límites que puedes leer. Cada respuesta con clave lleva X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset en segundos. Un 429 añade Retry-After. Los números se explican en límites de solicitudes.
• Bloques extra en una llamada. Las puntuaciones de cinco fuentes, los medidores de mood (ambiente emocional), las bandas sonoras, los datos de Wikidata y los horarios de sesiones llegan mediante append_to_response, así que una página de título puede usar una sola solicitud.
• Más fuentes de ids externos. /3/find resuelve imdb_id, tvdb_id, wikidata_id y kinopoisk_id, y también facebook_id, twitter_id e instagram_id. Consulta buscar por ID externo.
• OMDb con la misma clave. https://api.amodb.dev/omdb/ responde llamadas al estilo OMDb con un parámetro apikey, lo que ayuda cuando dos de tus sistemas usan protocolos distintos.
• Tiempos de caché conocidos. Los detalles y los créditos se mantienen 6 horas en la caché perimetral, las tendencias y el descubrimiento 30 minutos, la búsqueda 10 minutos, la configuración 24 horas y las imágenes 30 días.

Dónde encaja mejor TMDB

• Proyectos gratuitos. Si tu uso cumple los términos gratuitos, TMDB no cuesta nada y amodb no puede igualarlo.
• Métodos de escritura de usuario. TMDB ofrece métodos de escritura de cuenta, sesión, puntuación y listas. amodb los responde con 405 y status_code 37, así que una aplicación que permite iniciar sesión y puntuar títulos debe quedarse con TMDB para esa parte.
• Feeds de cambios. TMDB lista los ids que cambiaron. amodb no tiene un feed así, así que actualizas con tu propio calendario.
• Más de 14 idiomas. amodb no sirve texto de interfaz en alemán, japonés ni coreano y recurre al inglés. Los títulos originales siguen llegando en original_title y original_name. Para otros idiomas en TMDB, consulta su documentación.
• Términos que ya aceptaste. Si la revisión legal de TMDB ya está hecha, cambiar te obliga a pasar otra revisión.

Lo que amodb no ofrece

Revisa tu código con esta lista antes del cambio definitivo. La tabla completa está en amodb vs TMDB.

Dos comportamientos son silenciosos. Un nombre de append_to_response que amodb no conoce, como aggregate_credits, se ignora sin error. El parámetro include_adult también se ignora, porque los títulos y las personas para adultos nunca se sirven.

Migrar a amodb

1. Elige un plan en precios y crea una clave en el panel de tu cuenta.
2. Sustituye la URL base y la clave en un solo lugar, como se muestra abajo.
3. Lee images.secure_base_url desde /3/configuration para que los enlaces de imágenes usen img.amodb.dev.
4. Elimina las llamadas a métodos de escritura y a las rutas de la tabla anterior.
5. Gestiona el 429 esperando los segundos de Retry-After.

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

Ejecuta tus pruebas actuales contra ambas URL base antes del cambio definitivo. Compartir la misma forma no garantiza valores idénticos, así que compara una muestra de tus propios títulos. El recorrido completo está en la guía de inicio rápido, y una tabla cara a cara en amodb vs TMDB.

El manejo de errores se mantiene

Las llamadas fallidas devuelven el cuerpo de TMDB {"success": false, "status_code": N, "status_message": "..."}, así que el código que se ramifica según status_code no necesita reescribirse.

Trata el 402 como una señal para renovar a mano, porque nada se renueva automáticamente. La lista completa está en errores.

Precios

amodb es prepago. Elige un periodo de 1, 3, 6, 12 o 24 meses, que aplica 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 obtienen todos los datos y nada se renueva automáticamente. No hay nivel gratuito ni periodo de prueba. Los importes vigentes están en precios.