# Альтернатива TMDB API

> Шукайте альтернативу TMDB API, коли потрібна платна угода, ліміт запитів, під який можна планувати, або більше даних у кожній відповіді. amodb говорить протоколом TMDB v3 для читання, тож ви змінюєте лише базовий URL і ключ. Методів запису та кількох шляхів немає. Лишайтеся на TMDB, якщо його безкоштовні умови вам підходять.

## Який API обрати

TMDB пропонує безкоштовний API для відповідного використання за власними умовами, з ключами API v3 і токенами v4. Перед запуском прочитайте ці умови щодо комерційного використання та атрибуції. Обирайте альтернативу, коли потрібна платна угода, ліміт, під який можна планувати, або більше даних у кожній відповіді. amodb це незалежний API, що говорить протоколом TMDB v3 для читання, тож перехід означає новий базовий URL і новий ключ. Він працює лише на читання, а кількох шляхів TMDB немає, як перелічено нижче.

Лишайтеся на TMDB, якщо безкоштовні умови підходять вашому проєкту і нічого з наступного розділу вас не стосується.

## Ознаки того, що вам потрібна альтернатива

П'ять перевірок допоможуть ухвалити рішення. Проганяйте їх на власному трафіку й власному договорі, а не за списком можливостей.

| Ознака              | Що перевірити                                                                            | Відповідь amodb                                                                                 |
| ------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Комерційні умови    | Прочитайте умови API, яким користуєтеся нині, щодо комерційного використання й атрибуції | Платні тарифи, передплата, без автоматичного продовження                                        |
| Пікове навантаження | Порахуйте запити у вашу найзавантаженішу хвилину                                         | Фіксований ліміт 20, 40 або 120 запитів на хвилину на ключ                                      |
| Дані на екран       | Перелічіть додаткові виклики за однією сторінкою фільму                                  | `append_to_response` приймає також `ratings`, `moods`, `soundtracks`, `wikidata` та `showtimes` |
| Мова інтерфейсу     | Перевірте кожну мову, яку ви постачаєте                                                  | 14 мов, решта відкочується на `en`                                                              |
| Вартість виходу     | Порахуйте рядки коду, що називають постачальника                                         | Ті самі шляхи й JSON на підтримуваних ендпоінтах, тож вихід теж зводиться до зміни базового URL |

Влучання в кеш теж рахуються. Перевірка ключа й ліміт запитів виконуються перед edge-кешем, тож повторний запит усе одно витрачає один із ваших запитів на хвилину. Плануйте за загальною кількістю запитів, а не за промахами кешу.

## Порівняння можливостей

| Можливість              | TMDB                                                                       | amodb                                                                          |
| ----------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Модель цін              | Безкоштовний API для відповідного використання за власними умовами         | Передплачені періоди 1, 3, 6, 12 або 24 місяці                                 |
| Безкоштовний тариф      | Так, для відповідного використання                                         | Немає, пробного періоду теж немає                                              |
| Автентифікація          | Ключ v3 у `api_key` або токен v4 як Bearer                                 | `api_key` або Bearer, ключ із 32 шістнадцяткових символів                      |
| Формат відповіді        | JSON                                                                       | JSON у формі TMDB v3                                                           |
| Мови                    | Дивіться їхню документацію                                                 | 14 мов інтерфейсу                                                              |
| Фільми                  | Так                                                                        | Так                                                                            |
| Серіали                 | Так                                                                        | Так, із сезонами та серіями                                                    |
| Персони                 | Так                                                                        | Так                                                                            |
| Зображення              | Так, зі свого хоста зображень                                              | `img.amodb.dev`, ті самі токени розмірів, без ключа                            |
| Рейтинги                | Оцінка користувачів TMDB, інші джерела дивіться в їхній документації       | Оцінка TMDB плюс IMDb, Kinopoisk, Metacritic і Rotten Tomatoes, де вони відомі |
| Методи запису           | Методи для акаунтів, списків і оцінок                                      | Не пропонуються, відповідають 405                                              |
| Ліміт запитів           | Дивіться їхню документацію                                                 | 20, 40 або 120 на хвилину на ключ                                              |
| Комерційне використання | Умови щодо комерційного використання й атрибуції дивіться в їхніх правилах | Продається як платний API, див. [ціни](https://amodb.dev/uk/pricing/)          |
| Сумісність              | Визначає протокол v3                                                       | Більшість шляхів читання v3, а також OMDb                                      |

## Чим відрізняється amodb

- **Ліміти, які можна прочитати.** Кожна відповідь на запит із ключем містить `X-RateLimit-Limit`, `X-RateLimit-Remaining` і `X-RateLimit-Reset` у секундах. Відповідь 429 додає `Retry-After`. Ці числа пояснено на сторінці [ліміти запитів](https://amodb.dev/uk/rate-limits/).
- **Додаткові блоки в одному виклику.** Рейтинги з п'яти джерел, шкали настрою, саундтреки, факти Wikidata та сеанси кінотеатрів надходять через `append_to_response`, тож одна сторінка фільму може обійтися одним запитом.
- **Більше джерел зовнішніх id.** `/3/find` розпізнає `imdb_id`, `tvdb_id`, `wikidata_id` і `kinopoisk_id`, а також `facebook_id`, `twitter_id` та `instagram_id`. Див. [пошук за зовнішнім ID](https://amodb.dev/uk/find-by-external-id/).
- **OMDb з тим самим ключем.** `https://api.amodb.dev/omdb/` відповідає на виклики у стилі OMDb із параметром `apikey`, що допомагає, коли дві ваші системи використовують різні протоколи.
- **Відомі терміни кешу.** Деталі та акторський склад зі знімальною групою лишаються в edge-кеші 6 годин, тренди й discover 30 хвилин, пошук 10 хвилин, конфігурація 24 години, а зображення 30 днів.

## Коли TMDB підходить краще

- **Безкоштовні проєкти.** Якщо ваш випадок підпадає під безкоштовні умови, TMDB нічого не коштує, і amodb цього не перевершить.
- **Користувацькі методи запису.** TMDB пропонує методи запису для акаунтів, сесій, оцінок і списків. amodb відповідає на них 405 і status_code 37, тож застосунок, у якому люди входять і оцінюють фільми, має лишити TMDB для цієї частини.
- **Стрічки змін.** TMDB перелічує id, що змінилися. В amodb такої стрічки немає, тож оновлюйте дані за власним розкладом.
- **Мови понад 14.** amodb не віддає текст інтерфейсу німецькою, японською чи корейською й відкочується на англійську. Оригінальні назви все одно надходять у `original_title` та `original_name`. Про інші мови в TMDB дивіться їхню документацію.
- **Умови, які ви вже прийняли.** Якщо юридичну перевірку для TMDB вже пройдено, перехід вимагатиме ще однієї.

## Чого amodb не пропонує

Перед переходом звірте свій код із цим списком. Повну таблицю подано на сторінці [amodb проти TMDB](https://amodb.dev/uk/amodb-vs-tmdb/).

| Виклик TMDB                                                              | Відповідь amodb                  |
| ------------------------------------------------------------------------ | -------------------------------- |
| Запис для акаунтів, сесій, оцінок і списків                              | 405, `status_code` 37            |
| Зміни, aggregate credits, пошук за credit та review, вміст груп епізодів | 404, `status_code` 34            |
| Переклади персон, зображення та переклади колекцій, компаній і телемереж | 404, `status_code` 34            |
| Список рецензій до фільму чи серіалу                                     | 200, порожній для більшості назв |
| Зображення, відео та переклади сезону                                    | 200, порожньо                    |
| Зовнішні id сезонів та епізодів                                          | 200, усі null                    |

Дві поведінки тихі. Назва `append_to_response`, якої amodb не знає, наприклад `aggregate_credits`, ігнорується без помилки. Параметр `include_adult` теж ігнорується, бо матеріали та персони для дорослих не віддаються ніколи.

## Міграція на amodb

1. Оберіть тариф на сторінці [ціни](https://amodb.dev/uk/pricing/) і створіть ключ у панелі вашого акаунта.
2. Замініть базовий URL і ключ в одному місці, як показано нижче.
3. Читайте `images.secure_base_url` з `/3/configuration`, щоб посилання на зображення вказували на `img.amodb.dev`.
4. Приберіть виклики методів запису та шляхів із таблиці вище.
5. Обробляйте 429, чекаючи стільки секунд, скільки вказано в `Retry-After`.

```js
const config = {
  // before: baseUrl held your current TMDB v3 base URL
  baseUrl: 'https://api.amodb.dev/3',
  apiKey: process.env.AMODB_KEY,
};

const res = await fetch(`${config.baseUrl}/movie/550?language=en-US`, {
  headers: { Authorization: `Bearer ${config.apiKey}` },
});
if (!res.ok) throw new Error(`request failed with status ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

Проганяйте наявні тести з обома базовими URL перед переходом. Однакова форма не гарантує однакових значень, тож порівняйте вибірку власних фільмів. Повний покроковий опис дивіться у [швидкому старті](https://amodb.dev/uk/quickstart/), а таблицю прямого порівняння на сторінці [amodb проти TMDB](https://amodb.dev/uk/amodb-vs-tmdb/).

### Обробка помилок лишається тією самою

Невдалі виклики повертають тіло TMDB `{"success": false, "status_code": N, "status_message": "..."}`, тож код, який розгалужується за `status_code`, переписувати не треба.

| HTTP | status_code | Типова причина                                   |
| ---- | ----------- | ------------------------------------------------ |
| 401  | 7           | Ключ відсутній або з помилкою                    |
| 401  | 10          | Ключ призупинено                                 |
| 402  | 36          | Передплачений період закінчився                  |
| 404  | 34          | Id не знайдено або шлях, якого amodb не пропонує |
| 405  | 37          | Метод запису, який ваш код досі викликає         |
| 429  | 25          | Більше запитів, ніж тариф дозволяє за 60 секунд  |

Сприймайте 402 як сигнал продовжити вручну, бо автоматично нічого не продовжується. Повний перелік подано на сторінці [помилки](https://amodb.dev/uk/errors/).

## Ціни

amodb працює за передплатою. Оберіть період 1, 3, 6, 12 або 24 місяці, що дає знижку 0, 10, 20, 30 або 40 відсотків, та один із трьох тарифів на 20, 40 або 120 запитів на хвилину. Кожен тариф відкриває всі дані, і нічого не продовжується автоматично. Безкоштовного тарифу й пробного періоду немає. Актуальні суми дивіться на сторінці [ціни](https://amodb.dev/uk/pricing/).

## Запитання й відповіді

### Чи може amodb повністю замінити TMDB API?

Для більшості ендпоінтів читання так. Шляхи, параметри запиту й поля JSON відповідають TMDB v3, а автентифікація працює і через api_key, і через Bearer. Методи запису повертають 405 зі status_code 37. Стрічки змін, агреговані credits, пошук за credit та review й кілька інших шляхів повертають 404 зі status_code 34.

### Чи працюватимуть мої URL зображень TMDB?

Форма шляху й токени розмірів лишаються тими самими, але хост тепер img.amodb.dev, і ключ не потрібен. Читайте images.secure_base_url з ендпоінта конфігурації замість жорстко заданого хоста, і більше нічого в коді зображень міняти не доведеться.

### Чи приймає amodb заголовок Bearer, як TMDB?

Так. Надсилайте Authorization: Bearer зі своїм ключем amodb або передайте параметр запиту api_key. Ключ складається з 32 шістнадцяткових символів у нижньому регістрі, так само як ключ TMDB v3.

### Як вартість порівнюється з безкоштовним TMDB API?

TMDB пропонує безкоштовний API для відповідного використання за власними умовами. В amodb немає ні безкоштовного тарифу, ні пробного періоду. Ви оплачуєте наперед від 1 до 24 місяців одного з трьох тарифів, а актуальні суми вказано на сторінці цін.

### На який ліміт запитів орієнтуватися?

Орієнтуйтеся на свою найзавантаженішу хвилину. Тарифи дозволяють 20, 40 або 120 запитів на хвилину на ключ у ковзному вікні на 60 секунд, і кожен тариф повертає всі дані. Заголовки відповіді показують, скільки запитів лишилося.

## Пов'язані сторінки

- [amodb vs TMDB](https://amodb.dev/uk/amodb-vs-tmdb/): Пряме порівняння amodb і TMDB: збіг ендпоінтів, шляхи, яких немає в amodb, безкоштовні й платні умови, 14 мов, розширення та ліміти запитів.
- [Альтернатива OMDb API](https://amodb.dev/uk/omdb-api-alternative/): Добовий ліміт OMDb тісний або потрібен не один запис на виклик? amodb відповідає на запити у стилі OMDb і обслуговує ендпоінти TMDB v3 на одному ключі.
- [API бази фільмів для вашого каталогу](https://amodb.dev/uk/movie-database-api/): API бази фільмів для власної локальної копії: фільми, персони, компанії, колекції та ключові слова зі зв'язаними id, вікна дат у discover і пошук за id.
- [Швидкий старт](https://amodb.dev/uk/quickstart/): Перший виклик amodb: отримайте ключ, запросіть деталі фільму в curl, JavaScript, Python, PHP чи Go і завантажте постер з img.amodb.dev. Менш ніж за 2 хвилини.
- [Ліміти запитів](https://amodb.dev/uk/rate-limits/): amodb обмежує кожен ключ запитами на хвилину в ковзному вікні 60 секунд: 20, 40 або 120 за тарифом. Читайте заголовки ліміту й обробляйте 429 із Retry-After.
- [Ціни](https://amodb.dev/uk/pricing/): Тарифи amodb різняться лише запитами на хвилину: 20, 40 або 120. Кожен дає всі дані, сумісні з TMDB v3 та OMDb. Передплата, без поновлення й пробного періоду.

Оновлено: 2026-10-18. Source: https://amodb.dev/uk/tmdb-api-alternative/