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.
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
-H "Authorization: Bearer $AMODB_KEY"const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const data = await res.json();import os
import requests
res = requests.get(
"https://api.amodb.dev/3/movie/550",
params={"language": "en-US"},
headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
timeout=10,
)
data = res.json()<?php
$ch = curl_init("https://api.amodb.dev/3/movie/550?language=en-US");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("AMODB_KEY")],
]);
$data = json_decode(curl_exec($ch), true);req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/550?language=en-US", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var data map[string]any
json.NewDecoder(res.Body).Decode(&data)URL base
| Uso | URL base | Parámetro de la clave |
|---|---|---|
| Estilo TMDB v3 | https:/ | api_key o Authorization: Bearer |
| Estilo OMDb | https:/ | apikey |
| Imágenes | https:/ | ninguno |
| Catálogo de planes | https:/ | ninguno |
Empieza aquí
-
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.
-
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.
-
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.
Conceptos
-
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.
-
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.
-
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.
Recursos
-
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.
-
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
Todos los endpointsPelículas
-
/3/movie/{movie_id} -
/3/movie/{movie_id}/credits -
API de imágenes y host de imágenes
/3/movie/{movie_id}/images -
/3/movie/{movie_id}/videos -
/3/movie/{movie_id}/translations -
/3/movie/{movie_id}/keywords
Series
-
/3/tv/{series_id} -
API de temporadas y episodios de TV
/3/tv/{series_id}/season/{season_number}
Personas
-
/3/person/{person_id}
Búsqueda y listas
-
/3/search/movie -
/3/discover/movie -
Endpoints de tendencias y listas
/3/trending/{media_type}/{time_window} -
/3/genre/movie/list -
/3/collection/{collection_id} -
/3/company/{company_id} -
/3/find/{external_id}
Extensiones de amodb
-
Puntuaciones de películas y series
/3/movie/{movie_id}/ratings -
/3/movie/{movie_id}/moods -
/3/movie/{movie_id}/soundtracks -
/3/movie/{movie_id}/showtimes
Estilo OMDb
-
/omdb/
Tutoriales
Todos los tutorialesMás guías e índices
-
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.
-
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.