# 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 USD на місяць.

| Критерій                                    | TMDB                                 | OMDb                                  | amodb                      |
| ------------------------------------------- | ------------------------------------ | ------------------------------------- | -------------------------- |
| Ціна, коли застосунок приносить дохід       | $149 на місяць за виручки до $1M     | Умови для некомерційного використання | Від 3,11 USD на місяць     |
| Шляхи та 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/uk/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 USD  | 6,19 USD  | 7,19 USD   |
| Ціна за 3 місяці                    | 14,01 USD | 16,71 USD | 19,41 USD  |
| Ціна за 6 місяців                   | 24,91 USD | 29,71 USD | 34,51 USD  |
| Ціна за 12 місяців                  | 43,60 USD | 52,00 USD | 60,40 USD  |
| Ціна за 24 місяці                   | 74,74 USD | 89,14 USD | 103,54 USD |

## Розраховано на робоче навантаження

Популярні списки кешуються на 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/uk/quickstart/): Перший виклик amodb: отримайте ключ, запросіть деталі фільму в curl, JavaScript, Python, PHP чи Go і завантажте постер з img.amodb.dev. Менш ніж за 2 хвилини.
- [Ціни](https://amodb.dev/uk/pricing/): Тарифи amodb різняться лише запитами на хвилину: 20, 40 або 120. Кожен дає всі дані, сумісні з TMDB v3 та OMDb. Передплата, без поновлення й пробного періоду.
- [amodb vs TMDB](https://amodb.dev/uk/amodb-vs-tmdb/): Пряме порівняння amodb і TMDB: збіг ендпоінтів, шляхи, яких немає в amodb, безкоштовні й платні умови, 14 мов, розширення та ліміти запитів.
- [Альтернатива TMDB API](https://amodb.dev/uk/tmdb-api-alternative/): Шукаєте альтернативу TMDB API? Перевірте умови, ліміти, мови й рейтинги та перейдіть на платний API, що зберігає більшість шляхів читання TMDB v3 і JSON.

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