# 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. Без ключ.
- **Търсене по всеки външен идентификатор**: Подайте 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/bg/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/bg/quickstart/): Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути.
- [Цени](https://amodb.dev/bg/pricing/): Планове на amodb, различни само по заявките в минута: 20, 40 или 120. Всеки включва всички данни, съвместими с TMDB v3 и OMDb. Предплатено, без подновяване.
- [amodb срещу TMDB](https://amodb.dev/bg/amodb-vs-tmdb/): Лице в лице: amodb срещу TMDB. Паритет на ендпойнтите, пътищата, които amodb не предлага, безплатни и платени условия, 14 езика, разширения и лимити.
- [Алтернатива на TMDB API](https://amodb.dev/bg/tmdb-api-alternative/): Търсите алтернатива на TMDB API? Сравнете условия, лимити, езици и рейтинги, после минете към платено API с пътищата за четене на TMDB v3 и JSON.

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