# Documentación de amodb

> Empieza con el inicio rápido para hacer tu primera llamada en dos minutos. Después lee cómo funcionan las claves, los límites de solicitudes, los errores, los idiomas y las imágenes. amodb conserva las rutas y el JSON de TMDB v3 y OMDb, así que casi todas las páginas explican qué es igual, qué añade amodb y dónde difiere.

## URL base

| Uso                | URL base                                  | Parámetro de la clave               |
| ------------------ | ----------------------------------------- | ----------------------------------- |
| Estilo TMDB v3     | `https://api.amodb.dev/3`                 | `api_key` o `Authorization: Bearer` |
| Estilo OMDb        | `https://api.amodb.dev/omdb/`             | `apikey`                            |
| Imágenes           | `https://img.amodb.dev/t/p/{size}/{file}` | ninguno                             |
| Catálogo de planes | `https://api.amodb.dev/plans`             | ninguno                             |

### Primeros pasos

- [Inicio rápido](https://amodb.dev/es/quickstart/): Haz tu primera llamada a amodb: consigue una clave, pide los detalles de una película en curl, JavaScript, Python, PHP o Go y carga el póster. En 2 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.

### Conceptos

- [Límites de solicitudes](https://amodb.dev/es/rate-limits/): amodb limita cada clave por solicitudes por minuto en una ventana deslizante de 60 segundos: 20, 40 o 120 según el plan. Lee los encabezados y gestiona el 429.
- [Errores](https://amodb.dev/es/errors/): Cada error de amodb con su estado HTTP, su status_code de TMDB y su mensaje, más la forma de error de OMDb. Qué significa cada uno y qué debe hacer tu cliente.
- [Idiomas](https://amodb.dev/es/languages/): amodb sirve títulos, sinopsis y nombres en 14 idiomas. Pasa una etiqueta estilo TMDB como ru-RU o pt-BR en language; cualquier otra etiqueta recurre al inglés.
- [Imágenes](https://amodb.dev/es/images/): Carga pósteres, backdrops y fotos de perfil desde img.amodb.dev con rutas y tamaños de TMDB, de w92 a original. Sin clave, caché de 30 días y un patrón de URL.

### Referencia de la API

- [API de detalles de película](https://amodb.dev/es/movies/): API de detalles de película con rutas y JSON de TMDB v3. Obtén una película por id y añade créditos, puntuaciones y moods con append_to_response, en 14 idiomas.
- [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.
- [API de temporadas y episodios de TV](https://amodb.dev/es/tv-seasons-episodes/): API de temporadas y episodios de TV con las mismas rutas y JSON que TMDB v3. Lee una temporada con todos sus episodios, o un episodio con fecha y duración.
- [API de detalles de persona](https://amodb.dev/es/people/): API de detalles de persona con rutas y JSON de TMDB v3. Obtén un actor o miembro del equipo por id, con biografía, filmografía, ids externos y populares.
- [API de créditos](https://amodb.dev/es/credits/): API de créditos con las mismas rutas y el mismo JSON que TMDB v3. Obtén reparto y equipo técnico de películas, series, temporadas y episodios con order y job.
- [API de búsqueda](https://amodb.dev/es/search/): API de búsqueda con rutas y JSON de TMDB v3. Encuentra películas, series, personas, colecciones, productoras y palabras clave por texto, con filtros de año.
- [API Discover](https://amodb.dev/es/discover/): API Discover con los mismos filtros que TMDB v3. Lista películas y series por género, reparto, productora, palabra clave, año, nota, duración y plataforma.
- [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.
- [Géneros y listas de consulta](https://amodb.dev/es/genres/): API de géneros con rutas TMDB v3: ids de género de películas y TV con nombres traducidos, más listas de países, idiomas, oficios, clasificaciones y proveedores.
- [API de imágenes y host de imágenes](https://amodb.dev/es/images-api/): API de imágenes de películas con rutas TMDB v3: lista pósters, fondos, logos y fotogramas por título y cárgalos desde img.amodb.dev en 10 tamaños sin clave.
- [API de vídeos y tráilers](https://amodb.dev/es/videos-trailers/): API de vídeos de películas con rutas TMDB v3: lista tráilers, teasers, clips y reportajes de una película o serie, y filtra por tipo e idioma en tu código.
- [API de traducciones](https://amodb.dev/es/translations/): API de traducciones de películas con rutas TMDB v3: lee todos los títulos, sinopsis y eslóganes de una película, serie o episodio en todos sus idiomas.
- [API de palabras clave](https://amodb.dev/es/keywords/): API de palabras clave con rutas TMDB v3: lista las etiquetas de trama de una película o serie, consulta una palabra clave y combina ids con with_keywords.
- [API de colecciones](https://amodb.dev/es/collections/): API de colecciones de películas con rutas TMDB v3: obtén una saga por id con todas sus partes, lee belongs_to_collection en una película y busca por nombre.
- [Productoras y cadenas de TV](https://amodb.dev/es/companies-networks/): Consulta productoras y cadenas de TV con rutas TMDB v3. Lee nombre, país y logo por id, y filtra discover por el id de una productora o de una cadena.
- [Puntuaciones de películas y series](https://amodb.dev/es/ratings/): API de puntuaciones de películas: IMDb, Kinopoisk, Metacritic, Rotten Tomatoes y TMDB de un título en una sola llamada, con null si falta una fuente.
- [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.
- [Endpoint compatible con OMDb](https://amodb.dev/es/omdb-endpoint/): Endpoint compatible con la API de OMDb en api.amodb.dev/omdb/. Busca con i o t, explora con s, lee el array Ratings y conserva tu cliente cambiando la URL base.
- [Medidores de mood](https://amodb.dev/es/moods/): API de moods con medidores de 0 a 10 por título. Lee los moods de una película o serie, únelos con append_to_response=moods y crea insignias o filtros.
- [Bandas sonoras](https://amodb.dev/es/soundtracks/): API de banda sonora de películas que devuelve el álbum de una película o serie con sus pistas. Llama al endpoint o añade append_to_response=soundtracks.
- [Horarios de cine](https://amodb.dev/es/showtimes/): API de horarios de cine que devuelve los cines y las sesiones de una película en un país, o un resumen por país. Úsala con details o junto a now_playing.

### Recursos

- [Registro de cambios](https://amodb.dev/es/changelog/): Lista fechada de cambios en la API de amodb, el host de imágenes img.amodb.dev, los planes y el sitio web. Lo nuevo va arriba, con qué cambió y qué debes hacer.

- [Estado](https://amodb.dev/es/status/): Cómo saber si amodb funciona: el endpoint de salud público, los códigos de error que indican una incidencia y cómo reportarla con los datos necesarios.

- [Referencia de la API](https://amodb.dev/es/reference/): Cada endpoint de amodb con su ruta, sus parámetros, ejemplos de solicitud en cinco lenguajes y una respuesta JSON real. Compatible con TMDB v3 y OMDb.

- [Tutoriales](https://amodb.dev/es/tutorials/): Tutoriales paso a paso de la API de amodb: búsqueda, detalles, imágenes, idiomas y llamadas estilo OMDb, con código que puedes copiar y ejecutar.

- [Comparar amodb](https://amodb.dev/es/compare/): Comparativas de amodb con otras API de metadatos de cine y TV, lado a lado: compatibilidad, idiomas, límites, imágenes y precios, con cifras verificables.

- [Casos de uso](https://amodb.dev/es/use-cases/): Cómo usar amodb para datos de cine y TV: catálogos, servidores multimedia, recomendaciones, bots e investigación, con los endpoints y límites de cada caso.

## Páginas relacionadas

- [Inicio rápido](https://amodb.dev/es/quickstart/): Haz tu primera llamada a amodb: consigue una clave, pide los detalles de una película en curl, JavaScript, Python, PHP o Go y carga el póster. En 2 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/docs/
