# Алтернатива на 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/bg/pricing/)              |
| Съвместимост       | Определя протокола v3                                                    | Повечето пътища за четене на v3, плюс OMDb                                            |

## С какво се различава amodb

- **Лимити, които можете да прочетете.** Всеки отговор с ключ носи `X-RateLimit-Limit`, `X-RateLimit-Remaining` и `X-RateLimit-Reset` в секунди. 429 добавя `Retry-After`. Числата са обяснени на страницата [лимити на заявките](https://amodb.dev/bg/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/bg/find-by-external-id/).
- **OMDb на същия ключ.** `https://api.amodb.dev/omdb/` отговаря на извиквания в стил OMDb с параметър `apikey`, което помага, когато две ваши системи ползват различни протоколи.
- **Известни срокове на кеша.** Детайлите и участниците стоят 6 часа на edge, тенденциите и 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/bg/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/bg/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/bg/quickstart/), а таблица лице в лице е на страницата [amodb срещу TMDB](https://amodb.dev/bg/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/bg/errors/).

## Цени

amodb е предплатен. Изберете период от 1, 3, 6, 12 или 24 месеца с отстъпка 0, 10, 20, 30 или 40 процента и един от три плана за 20, 40 или 120 заявки в минута. Всеки план получава всички данни и нищо не се подновява автоматично. Няма безплатен план и пробен период. Текущите суми са на страницата с [цените](https://amodb.dev/bg/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/bg/amodb-vs-tmdb/): Лице в лице: amodb срещу TMDB. Паритет на ендпойнтите, пътищата, които amodb не предлага, безплатни и платени условия, 14 езика, разширения и лимити.
- [Алтернатива на OMDb API](https://amodb.dev/bg/omdb-api-alternative/): Стигнахте дневния лимит на OMDb или ви трябва повече от един запис на извикване? amodb отговаря в стил OMDb и дава ендпойнти на TMDB v3 със същия ключ.
- [API за база данни за филми за вашия каталог](https://amodb.dev/bg/movie-database-api/): API за база данни за филми за локално копие: филми, личности, компании, колекции и ключови думи със свързани id, прозорци в discover и търсене по id.
- [Бърз старт](https://amodb.dev/bg/quickstart/): Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути.
- [Лимити на заявките](https://amodb.dev/bg/rate-limits/): amodb ограничава всеки ключ по заявки в минута в плъзгащ се прозорец от 60 секунди: 20, 40 или 120. Заглавки за лимита и обработка на 429 с Retry-After.
- [Цени](https://amodb.dev/bg/pricing/): Планове на amodb, различни само по заявките в минута: 20, 40 или 120. Всеки включва всички данни, съвместими с TMDB v3 и OMDb. Предплатено, без подновяване.

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