# API фильмов со всеми рейтингами, совместимый с TMDB и OMDb

> amodb предлагает платный API фильмов и сериалов, который сохраняет пути и JSON из TMDB v3 и OMDb, поэтому ваш код работает после смены базового URL. Один ключ добавляет рейтинги IMDb, Rotten Tomatoes, Metacritic и Kinopoisk, измерители настроения и саундтреки, а коммерческое использование входит в каждый тариф с предоплатой.

## Зачем платить за API фильмов, если TMDB бесплатен?

TMDB бесплатен, пока ваше приложение не заработало первый доллар. После этого TMDB требует коммерческий тариф: $149 в месяц для компаний с выручкой до $1M. В TMDB нет и оценок IMDb, Rotten Tomatoes и Metacritic, а OMDb, обычный второй API, лицензирован для некоммерческого использования. В amodb оба формата доступны по одному ключу, а коммерческое использование включено от 3,11 $ в месяц.

| Критерий                                    | TMDB                                   | OMDb                                      | amodb                     |
| ------------------------------------------- | -------------------------------------- | ----------------------------------------- | ------------------------- |
| Цена, когда приложение приносит доход       | $149 в месяц при выручке до $1M        | Условия для некоммерческого использования | От 3,11 $ в месяц         |
| Пути и JSON TMDB v3                         | Да                                     | Нет                                       | Да                        |
| Параметры и поля OMDb                       | Нет                                    | Да                                        | Да                        |
| Рейтинги IMDb, Rotten Tomatoes и Metacritic | Нет, только оценка TMDB                | Да                                        | Да, плюс Kinopoisk и TMDB |
| Измерители настроения, саундтреки и сеансы  | Нет                                    | Нет                                       | Да                        |
| Без логотипа и уведомления на ваших экранах | Нет, логотип и уведомление обязательны | Не указано                                | Да                        |
| Один ключ для обоих форматов                | Нет                                    | Нет                                       | Да                        |

Источники: [условия TMDB API](https://www.themoviedb.org/api-terms-of-use), ответы сотрудников TMDB о [коммерческих ценах](https://www.themoviedb.org/talk/69cbf4f91b914f0e9542a772) и о том, [когда приложение считается коммерческим](https://www.themoviedb.org/talk/6ac5579ae24d7a00344571d5), и [юридическая страница OMDb](https://www.omdbapi.com/legal.htm). Прочитано в октябре 2026 года.

## Смените базовый URL, а код оставьте

amodb отвечает по тем же путям, что и TMDB v3. Запрос фильма 550 возвращает те же поля JSON, которые ваш клиент уже разбирает: `id`, `title`, `genres`, `release_date`, `poster_path` и остальные.

Передавайте ключ как `api_key` в запросе или в заголовке `Authorization: Bearer`. Оба способа работают на каждом эндпоинте.

```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"
}
```

## Один ключ для вызовов в стиле OMDb

Эндпоинт, совместимый с OMDb, находится по адресу `https://api.amodb.dev/omdb/`. Он принимает `i`, `t`, `s`, `type`, `y`, `plot` и `page` и возвращает `Title`, `Year`, `imdbRating`, `Ratings` и остальные поля OMDb.

Поле `Poster` указывает на `img.amodb.dev`, поэтому постеры загружаются с того же сервиса. Ошибки сохраняют формат 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"
}
```

## Данные, которых нет в TMDB v3

Каждый ключ может вызывать расширения amodb на том же базовом URL. Добавляйте их через `append_to_response` или вызывайте отдельно.

- **Измерители настроения**: Страх, юмор, грусть, насилие и другие показатели по шкале от 0 до 10, одним дополнительным вызовом.
- **Рейтинги одним вызовом**: Оценки IMDb, TMDB и еще три источника с числом голосов, из одного эндпоинта.
- **Лимит запросов на виду**: Каждый ответ сообщает, сколько запросов осталось в эту минуту.
- **Один ID, 14 языков**: Один и тот же фильм на каждом языке, который поддерживает amodb. Неизвестные теги откатываются на английский.
- **Все размеры изображений TMDB**: От миниатюр w92 до оригиналов на img.amodb.dev. Ключ не нужен.
- **Поиск по любому внешнему ID**: Отправьте ID IMDb или другой внешний ID и получите запись TMDB.
- **Сеансы в кинотеатрах**: Сеансы по странам для тайтлов в кинотеатрах, когда они известны.
- **Саундтреки**: Песни, звучащие в фильме или сериале, на том же базовом URL.

## Названия и описания на 14 языках

Передайте в `language` тег в стиле TMDB, например `ru-RU` или `pt-BR`. amodb поддерживает 14 базовых языков и для любого другого тега откатывается на английский, поэтому запрос никогда не падает из-за языка.

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

## Подходит для личных и коммерческих проектов

Проект выходного дня и платный продукт обращаются к одному и тому же API, получают одни и те же данные и подпадают под одни и те же [условия](https://amodb.dev/ru/terms/). Вот что на нем строят.

- **Стриминговые приложения и списки к просмотру:** постеры, трейлеры, сезоны и серии, а также пять рейтингов для сортировки и фильтрации.
- **Боты для Telegram и Discord:** поиск в стиле OMDb по названию или IMDb id возвращает готовый ответ за один вызов.
- **Медиасерверы и плагины:** сборщики метаданных, которые уже работают с TMDB v3, сохраняют свой клиент и получают оценки IMDb и Rotten Tomatoes.
- **Сайты и блоги о кино:** названия и описания на 14 языках, поэтому у каждого рынка своя страница.
- **Рекомендательные системы:** измерители настроения оценивают страх, юмор, насилие и другое по шкале от 0 до 10: это сигналы, которых одни жанры не дают.
- **ИИ-агенты и чат-боты:** отвечают на вопрос «что посмотреть сегодня вечером» с реальными рейтингами, настроением, актерами и сеансами.

## Тарифы различаются запросами в минуту

Каждый тариф дает доступ к одним и тем же данным: эндпоинтам TMDB и OMDb, всем 14 языкам, изображениям и расширениям. Pro+ получает еще и `/3/all`: все о фильме, сериале или персоне в одном запросе. Вы платите один раз за 1, 3, 6, 12 или 24 месяцев, и чем длиннее период, тем дешевле месяц. Бесплатного тарифа и автоматического продления нет.

| Функция                            | Lite    | Pro     | Pro+     |
| ---------------------------------- | ------- | ------- | -------- |
| Запросов в минуту                  | 20      | 40      | 120      |
| Запросов в день на полной скорости | 28 800  | 57 600  | 172 800  |
| Цена за 1 месяц                    | 5,19 $  | 6,19 $  | 7,19 $   |
| Цена за 3 месяца                   | 14,01 $ | 16,71 $ | 19,41 $  |
| Цена за 6 месяцев                  | 24,91 $ | 29,71 $ | 34,51 $  |
| Цена за 12 месяцев                 | 43,60 $ | 52,00 $ | 60,40 $  |
| Цена за 24 месяца                  | 74,74 $ | 89,14 $ | 103,54 $ |

## Рассчитано на рабочую нагрузку

Популярные списки кэшируются на 30 минут, детальные данные на 6 часов, а `configuration` на 24 часа.
Каждый ответ содержит `X-RateLimit-Limit`, `X-RateLimit-Remaining` и `X-RateLimit-Reset`. Ответ 429 добавляет `Retry-After`.
Ошибки возвращают `success`, `status_code` и `status_message`, поэтому существующая обработка ошибок продолжает работать.
Постеры и фоны загружаются с `img.amodb.dev/t/p/{size}/{file}` во всех размерах TMDB и кэшируются на 30 дней.

## Вопросы и ответы

### Бесплатен ли TMDB API для коммерческого использования?

Нет. Ключ TMDB бесплатен, пока проект ничего не зарабатывает. По словам сотрудников TMDB, любой доход от рекламы, покупок в приложении, пожертвований или подписок делает приложение коммерческим, а коммерческий тариф стоит $149 в месяц для компаний с выручкой до $1M. В amodb коммерческое использование входит в каждый тариф.

### Сколько стоит TMDB API?

Для некоммерческого использования он бесплатен. Для коммерческого приложения сотрудники TMDB называют $149 в месяц при годовой выручке до $1M и индивидуальную цену выше этого порога. Тарифы amodb стоят несколько долларов в месяц и различаются в основном числом запросов в минуту.

### Зачем платить за amodb, если TMDB API бесплатен?

Потому что платное приложение на TMDB уже не бесплатно. amodb обходится в малую долю от коммерческого тарифа TMDB в $149, не требует логотипа на ваших экранах и возвращает рейтинги IMDb, Rotten Tomatoes, Metacritic и Kinopoisk в том же ответе. Один ключ работает и с форматом TMDB v3, и с форматом OMDb, поэтому вы используете один API вместо двух.

### Бесплатен ли OMDb для коммерческого использования?

На юридической странице OMDb сервис описан как предназначенный для личного некоммерческого использования, а его содержимое лицензировано по CC BY-NC 4.0. amodb отвечает на те же параметры OMDb с теми же именами полей, и коммерческое использование включено.

### Нужно ли менять код клиента TMDB?

Нет. Направьте базовый URL на https://api.amodb.dev/3 и передавайте ключ amodb как api_key или как Bearer токен. Пути, параметры запроса и поля JSON остаются такими же, как в TMDB v3.

### Подходит ли тот же ключ для вызовов в стиле OMDb?

Да. Передайте его как apikey на https://api.amodb.dev/omdb/. Параметры i, t, s, type, y, plot и page работают как в OMDb, а ответ использует имена полей OMDb.

### Есть ли бесплатный тариф или пробный период?

Нет. amodb работает только по предоплате. Вы выбираете тариф и период, платите один раз картой, через Apple Pay, Google Pay, криптовалютой или через Patreon, и ключ работает до конца периода. Автоматического продления нет.

### Чем отличаются тарифы?

Скоростью запросов: 20, 40 или 120 запросов в минуту. Каждый тариф дает доступ к одним и тем же данным, ко всем 14 языкам, изображениям, рейтингам и остальным расширениям amodb. Pro+ получает еще и /3/all: все о фильме, сериале или персоне в одном запросе.

### Какие языки поддерживаются?

Английский, русский, украинский, белорусский, китайский, португальский, болгарский, иврит, чешский, румынский, французский, польский, итальянский и испанский. Передайте тег в стиле TMDB, например ru-RU; любой другой язык откатывается на английский.

## Связанные страницы

- [Быстрый старт](https://amodb.dev/ru/quickstart/): Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут.
- [Цены](https://amodb.dev/ru/pricing/): Тарифы amodb различаются только запросами в минуту: 20, 40 или 120. В каждом все данные в стиле TMDB v3 и OMDb. Предоплата, без продления и пробного периода.
- [amodb против TMDB](https://amodb.dev/ru/amodb-vs-tmdb/): Сравнение amodb и TMDB: совместимость эндпоинтов, пути, которых нет в amodb, бесплатные и платные условия, 14 языков, расширения и лимиты запросов.
- [Альтернатива TMDB API](https://amodb.dev/ru/tmdb-api-alternative/): Нужна альтернатива TMDB API? Сверьте условия, лимиты, языки и рейтинги, затем перейдите на платный API, где работает большинство путей чтения и JSON TMDB v3.

Обновлено: 2026-10-19. Source: https://amodb.dev/ru/