# Альтэрнатыва 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/be/pricing/)          |
| Сумяшчальнасць           | Вызначае пратакол v3                                                      | Большасць шляхоў чытання v3, плюс OMDb                                       |

## Чым адрозніваецца amodb

- **Ліміты, якія можна прачытаць.** Кожны адказ з ключом нясе `X-RateLimit-Limit`, `X-RateLimit-Remaining` і `X-RateLimit-Reset` у секундах. 429 дадае `Retry-After`. Лічбы тлумачацца на старонцы [ліміты запытаў](https://amodb.dev/be/rate-limits/).
- **Дадатковыя блокі ў адным выкліку.** Рэйтынгі з пяці крыніц, індыкатары настрою, саўндтрэкі, факты Wikidata і сеансы ў кінатэатрах прыходзяць праз `append_to_response`, таму адна старонка назвы можа выкарыстоўваць адзін запыт.
- **Больш крыніц вонкавых id.** `/3/find` апрацоўвае `imdb_id`, `tvdb_id`, `wikidata_id` і `kinopoisk_id`, а таксама `facebook_id`, `twitter_id` і `instagram_id`. Гл. [пошук па вонкавым ідэнтыфікатары](https://amodb.dev/be/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/be/amodb-vs-tmdb/).

| Выклік TMDB                                                             | Адказ amodb                     |
| ----------------------------------------------------------------------- | ------------------------------- |
| Запіс для акаўнта, сесій, ацэнак і спісаў                               | 405, `status_code` 37           |
| Changes, 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/be/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/be/quickstart/), а табліца ўпрыток ёсць на старонцы [amodb супраць TMDB](https://amodb.dev/be/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/be/errors/).

## Цэны

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

## Пытанні і адказы

### Ці з’яўляецца amodb простай заменай API TMDB?

Для большасці эндпоінтаў чытання так. Шляхі, параметры запыту і палі JSON адпавядаюць TMDB v3, і працуюць абедзве аўтэнтыфікацыі, api_key і Bearer. Метады запісу вяртаюць 405 са status_code 37. Стужкі changes, aggregate 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.

### Як кошт параўноўваецца з бясплатным API TMDB?

TMDB прапануе бясплатны API для кваліфікаванага выкарыстання па ўласных умовах. У amodb няма бясплатнага тарыфа і пробнага перыяду. Вы плаціце наперад за 1-24 месяцы па адным з трох планаў, а бягучыя сумы пералічаны на старонцы з цэнамі.

### Пад які ліміт планаваць?

Арыентуйцеся на сваю самую загружаную хвіліну. Планы дазваляюць 20, 40 або 120 запытаў у хвіліну на ключ у слізгальным 60-секундным акне, і кожны план вяртае ўсе даныя. Загалоўкі адказу паказваюць, колькі запытаў засталося.

## Звязаныя старонкі

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

Абноўлена: 2026-10-18. Source: https://amodb.dev/be/tmdb-api-alternative/