# La API de películas con todas las puntuaciones, compatible con TMDB y OMDb

> amodb es una API de pago de películas y series que conserva rutas y JSON de TMDB v3 y OMDb, así que tu código funciona tras cambiar la URL base. Una clave suma las puntuaciones de IMDb, Rotten Tomatoes, Metacritic y Kinopoisk, medidores de mood y bandas sonoras, y el uso comercial está incluido en todos los planes prepago.

## ¿Por qué pagar por una API de películas si TMDB es gratis?

TMDB es gratis hasta que tu app gana su primer dólar. Después, TMDB pide su plan comercial, $149 al mes para empresas con menos de $1M de ingresos. TMDB tampoco tiene puntuaciones de IMDb, Rotten Tomatoes ni Metacritic, y OMDb, la segunda API habitual, tiene licencia para uso no comercial. amodb reúne ambos formatos en una sola clave, con el uso comercial incluido desde 3,11 US$ al mes.

| Función                                              | TMDB                                     | OMDb                    | amodb                          |
| ---------------------------------------------------- | ---------------------------------------- | ----------------------- | ------------------------------ |
| Precio cuando tu app genera ingresos                 | $149 al mes con menos de $1M de ingresos | Términos no comerciales | Desde 3,11 US$ al mes          |
| Rutas y JSON de TMDB v3                              | Sí                                       | No                      | Sí                             |
| Parámetros y campos de OMDb                          | No                                       | Sí                      | Sí                             |
| Puntuaciones de IMDb, Rotten Tomatoes y Metacritic   | No, solo la puntuación de TMDB           | Sí                      | Sí, además de Kinopoisk y TMDB |
| Medidores de mood, bandas sonoras y horarios de cine | No                                       | No                      | Sí                             |
| Sin logotipo ni aviso obligatorio en tus pantallas   | No, exige logotipo y aviso               | No indicado             | Sí                             |
| Una clave para ambos formatos                        | No                                       | No                      | Sí                             |

Fuentes: los [términos de la API de TMDB](https://www.themoviedb.org/api-terms-of-use), las respuestas del equipo de TMDB sobre [los precios comerciales](https://www.themoviedb.org/talk/69cbf4f91b914f0e9542a772) y sobre [cuándo una app se considera comercial](https://www.themoviedb.org/talk/6ac5579ae24d7a00344571d5), y la [página legal de OMDb](https://www.omdbapi.com/legal.htm), consultados en octubre de 2026.

## Cambia la URL base y conserva tu código

amodb responde en las mismas rutas que TMDB v3. Una solicitud de la película 550 devuelve los mismos campos JSON que tu cliente ya procesa: `id`, `title`, `genres`, `release_date`, `poster_path` y el resto.

Envía tu clave como `api_key` en la consulta o en la cabecera `Authorization: Bearer`. Ambas formas funcionan en todos los endpoints.

```bash
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

```python
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,
)
movie = res.json()
print(movie["title"], movie["release_date"])
```

```json
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}
```

## Una clave para llamadas estilo OMDb

El endpoint compatible con OMDb está en `https://api.amodb.dev/omdb/`. Acepta `i`, `t`, `s`, `type`, `y`, `plot` y `page`, y devuelve `Title`, `Year`, `imdbRating`, `Ratings` y el resto de los campos de OMDb.

El campo `Poster` apunta a `img.amodb.dev`, así que los pósteres se cargan desde el mismo servicio. Los errores conservan la forma de OMDb: `{"Response":"False","Error":"..."}`.

```bash
curl "https://api.amodb.dev/omdb/?i=tt0137523&plot=short&apikey=$AMODB_KEY"
```

```js
const url = new URL("https://api.amodb.dev/omdb/");
url.searchParams.set("t", "Fight Club");
url.searchParams.set("y", "1999");
url.searchParams.set("apikey", process.env.AMODB_KEY);

const film = await (await fetch(url)).json();
console.log(film.Title, film.imdbRating);
```

```python
import os
import requests

film = requests.get(
    "https://api.amodb.dev/omdb/",
    params={"i": "tt0137523", "apikey": os.environ["AMODB_KEY"]},
    timeout=10,
).json()
print(film["Title"], film["imdbRating"])
```

```json
{
  "Title": "Fight Club",
  "Year": "1999",
  "Runtime": "139 min",
  "Director": "David Fincher",
  "imdbRating": "8.8",
  "imdbID": "tt0137523",
  "Poster": "https://img.amodb.dev/t/p/w300/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
  "Response": "True"
}
```

## Datos que TMDB v3 no devuelve

Toda clave puede llamar a las extensiones de amodb en la misma URL base. Añádelas con `append_to_response` o llámalas por separado.

- **Medidores de mood**: Miedo, humor, tristeza, violencia y más, cada uno en una escala de 0 a 10, con una llamada extra.
- **Puntuaciones en una llamada**: IMDb, TMDB y tres puntuaciones más con su número de votos, desde un solo endpoint.
- **Un límite que puedes ver**: Cada respuesta te dice cuántas solicitudes te quedan en este minuto.
- **Un id, 14 idiomas**: La misma película en cada idioma que sirve amodb. Las etiquetas desconocidas recurren al inglés.
- **Todos los tamaños de imagen de TMDB**: Desde miniaturas w92 hasta archivos originales en img.amodb.dev. Sin clave.
- **Búsqueda por cualquier ID externo**: Envía un ID de IMDb u otro ID externo y recibe el registro de TMDB.
- **Horarios de cine**: Horarios por país de los títulos en cartelera, cuando se conocen.
- **Bandas sonoras**: Las canciones que suenan en una película o una serie, en la misma URL base.

## Títulos y sinopsis en 14 idiomas

Pasa en `language` una etiqueta estilo TMDB, como `ru-RU` o `pt-BR`. amodb sirve 14 idiomas base y recurre al inglés con cualquier otra etiqueta, así que una solicitud nunca falla por el idioma.

| Code | Language   | Native name | Example tag |
| ---- | ---------- | ----------- | ----------- |
| `en` | English    | English     | `en-US`     |
| `ru` | Russian    | Русский     | `ru-RU`     |
| `uk` | Ukrainian  | Українська  | `uk-UA`     |
| `be` | Belarusian | Беларуская  | `be-BY`     |
| `zh` | Chinese    | 中文          | `zh-CN`     |
| `pt` | Portuguese | Português   | `pt-BR`     |
| `bg` | Bulgarian  | Български   | `bg-BG`     |
| `he` | Hebrew     | עברית       | `he-IL`     |
| `cs` | Czech      | Čeština     | `cs-CZ`     |
| `ro` | Romanian   | Română      | `ro-RO`     |
| `fr` | French     | Français    | `fr-FR`     |
| `pl` | Polish     | Polski      | `pl-PL`     |
| `it` | Italian    | Italiano    | `it-IT`     |
| `es` | Spanish    | Español     | `es-ES`     |

## Pensado para proyectos personales y comerciales

Un proyecto de fin de semana y un producto de pago llaman a la misma API, reciben los mismos datos y se rigen por los mismos [términos](https://amodb.dev/es/terms/). Esto es lo que construyen los equipos con ella.

- **Apps de streaming y listas de seguimiento:** pósteres, tráilers, temporadas y episodios, y cinco puntuaciones para ordenar y filtrar.
- **Bots de Telegram y Discord:** una búsqueda estilo OMDb por título o por id de IMDb devuelve una respuesta lista en una sola llamada.
- **Servidores multimedia y plugins:** los scrapers de metadatos que ya hablan TMDB v3 conservan su cliente y ganan las puntuaciones de IMDb y Rotten Tomatoes.
- **Sitios web y blogs de cine:** títulos y sinopsis en 14 idiomas, para que cada mercado tenga su propia página.
- **Motores de recomendación:** los medidores de mood puntúan miedo, humor, violencia y más de 0 a 10, señales que los géneros por sí solos no dan.
- **Agentes de IA y chatbots:** responde a «¿qué veo esta noche?» con puntuaciones reales, moods, reparto y horarios de cine.

## Los planes se diferencian en las solicitudes por minuto

Todos los planes dan acceso a los mismos datos: los endpoints de TMDB y OMDb, los 14 idiomas, las imágenes y las extensiones. Pro+ también incluye `/3/all`: todo sobre una película, serie o persona en una sola solicitud. Pagas una vez por 1, 3, 6, 12 o 24 meses, y un periodo más largo cuesta menos al mes. No hay nivel gratuito ni renovación automática.

| Función                            | Lite      | Pro       | Pro+       |
| ---------------------------------- | --------- | --------- | ---------- |
| Solicitudes por minuto             | 20        | 40        | 120        |
| Solicitudes al día al ritmo máximo | 28.800    | 57.600    | 172.800    |
| Precio por 1 mes                   | 5,19 US$  | 6,19 US$  | 7,19 US$   |
| Precio por 3 meses                 | 14,01 US$ | 16,71 US$ | 19,41 US$  |
| Precio por 6 meses                 | 24,91 US$ | 29,71 US$ | 34,51 US$  |
| Precio por 12 meses                | 43,60 US$ | 52,00 US$ | 60,40 US$  |
| Precio por 24 meses                | 74,74 US$ | 89,14 US$ | 103,54 US$ |

## Pensado para tráfico de producción

Las listas populares se guardan en caché 30 minutos, los detalles 6 horas y `configuration` 24 horas.
Cada respuesta incluye `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset`. Un 429 añade `Retry-After`.
Los errores devuelven `success`, `status_code` y `status_message`, así que el manejo de errores que ya tienes sigue funcionando.
Los pósteres y fondos se cargan desde `img.amodb.dev/t/p/{size}/{file}` en todos los tamaños de TMDB, con caché de 30 días.

## Preguntas y respuestas

### ¿Es gratis la API de TMDB para uso comercial?

No. Una clave de TMDB es gratuita mientras tu proyecto no genere ingresos. El equipo de TMDB indica que cualquier ingreso por anuncios, compras dentro de la app, donaciones o suscripciones convierte una app en comercial, y el plan comercial cuesta $149 al mes para empresas con menos de $1M de ingresos. amodb incluye el uso comercial en todos los planes.

### ¿Cuánto cuesta la API de TMDB?

Es gratuita para uso no comercial. Para una app comercial, el equipo de TMDB indica $149 al mes cuando los ingresos anuales son inferiores a $1M, y un precio a medida por encima de esa cifra. Los planes de amodb cuestan unos pocos dólares al mes y se diferencian sobre todo en las solicitudes por minuto.

### ¿Por qué pagar por amodb si la API de TMDB es gratis?

Porque una app de pago no es gratis en TMDB. amodb cuesta una fracción de los $149 del plan comercial de TMDB, no exige ningún logotipo en tus pantallas y devuelve las puntuaciones de IMDb, Rotten Tomatoes, Metacritic y Kinopoisk en la misma respuesta. Una clave sirve tanto el formato TMDB v3 como el de OMDb, así que usas una sola API en lugar de dos.

### ¿Es gratis OMDb para uso comercial?

La página legal de OMDb describe el servicio como de uso personal y no comercial, y licencia su contenido bajo CC BY-NC 4.0. amodb responde a los mismos parámetros de OMDb con los mismos nombres de campo, y el uso comercial está incluido.

### ¿Tengo que cambiar el código de mi cliente de TMDB?

No. Apunta la URL base a https://api.amodb.dev/3 y envía tu clave de amodb como api_key o como token Bearer. Las rutas, los parámetros de consulta y los campos JSON son los mismos que en TMDB v3.

### ¿Sirve la misma clave para las llamadas estilo OMDb?

Sí. Envíala como apikey a https://api.amodb.dev/omdb/. Los parámetros i, t, s, type, y, plot y page funcionan como en OMDb, y la respuesta usa los nombres de campo de OMDb.

### ¿Hay un nivel gratuito o una prueba?

No. amodb es solo prepago. Eliges un plan y un periodo, pagas una vez con tarjeta, Apple Pay, Google Pay, criptomonedas o Patreon, y la clave funciona hasta que termina el periodo. No hay renovación automática.

### ¿En qué se diferencian los planes?

La tasa de solicitudes: 20, 40 o 120 por minuto. Todos los planes dan acceso a los mismos datos, los 14 idiomas, las imágenes, las puntuaciones y las demás extensiones de amodb. Pro+ también incluye /3/all: todo sobre una película, serie o persona en una sola solicitud.

### ¿Qué idiomas se sirven?

Inglés, ruso, ucraniano, bielorruso, chino, portugués, búlgaro, hebreo, checo, rumano, francés, polaco, italiano y español. Pasa una etiqueta estilo TMDB como ru-RU; cualquier otro idioma recurre al inglés.

## 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.
- [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.
- [amodb vs TMDB](https://amodb.dev/es/amodb-vs-tmdb/): Cara a cara entre amodb y TMDB: paridad de endpoints, rutas que amodb no ofrece, términos gratuitos y de pago, 14 idiomas, extensiones y límites de solicitudes.
- [Alternativa a la API de TMDB](https://amodb.dev/es/tmdb-api-alternative/): ¿Buscas una alternativa a TMDB? Revisa términos, límites, idiomas y puntuaciones, y pasa a una API de pago con la mayoría de lecturas y el JSON de TMDB v3.

Actualizado: 2026-10-19. Source: https://amodb.dev/es/