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

Абноўлена: 2026-10-19. Source: https://amodb.dev/be/