# Документация на amodb

> Започнете с бързия старт, за да направите първата си заявка за две минути. После прочетете как работят ключовете, лимитите на заявките, грешките, езиците и изображенията. amodb запазва пътищата и JSON на TMDB v3 и OMDb, затова повечето страници тук обясняват какво е същото, какво добавя amodb и малкото места, където се различава.

## Базови URL адреси

| Приложение           | Базов URL                                 | Параметър за ключа                    |
| -------------------- | ----------------------------------------- | ------------------------------------- |
| Стил TMDB v3         | `https://api.amodb.dev/3`                 | `api_key` или `Authorization: Bearer` |
| Стил OMDb            | `https://api.amodb.dev/omdb/`             | `apikey`                              |
| Изображения          | `https://img.amodb.dev/t/p/{size}/{file}` | няма                                  |
| Каталог на плановете | `https://api.amodb.dev/plans`             | няма                                  |

### Първи стъпки

- [Бърз старт](https://amodb.dev/bg/quickstart/): Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути.
- [Удостоверяване](https://amodb.dev/bg/authentication/): Как да изпратите ключа си за amodb: api_key в заявката, заглавка Authorization с Bearer или apikey за OMDb. Формат, съхранение, смяна на ключ и грешките 401.

### Основни понятия

- [Лимити на заявките](https://amodb.dev/bg/rate-limits/): amodb ограничава всеки ключ по заявки в минута в плъзгащ се прозорец от 60 секунди: 20, 40 или 120. Заглавки за лимита и обработка на 429 с Retry-After.
- [Грешки](https://amodb.dev/bg/errors/): Всяка грешка на amodb с HTTP статус, status_code на TMDB и съобщение, плюс формата на грешките на OMDb. Какво означава всяка и какво да направи клиентът ви.
- [Езици](https://amodb.dev/bg/languages/): amodb връща заглавия, описания и имена на 14 езика. Подайте таг в стил TMDB, например ru-RU или pt-BR, в language; всеки друг таг се заменя с английски.
- [Изображения](https://amodb.dev/bg/images/): Зареждайте постери, фонови изображения и снимки от img.amodb.dev с пътищата и размерите на TMDB, от w92 до original. Без ключ, кеш 30 дни, един шаблон на URL.

### Справочник за API

- [API за детайли на филм](https://amodb.dev/bg/movies/): API за детайли на филм със същите пътища и JSON като TMDB v3. Един филм по id, а актьори, рейтинги и настроения през append_to_response, на 14 езика.
- [API за сериали](https://amodb.dev/bg/tv-series/): API за сериали със същите пътища и JSON като TMDB v3. Сериал по id със сезони, мрежи и следващ епизод, плюс възрастови рейтинги и доставчици за гледане.
- [API за сезони и епизоди на сериали](https://amodb.dev/bg/tv-seasons-episodes/): API за сезони и епизоди със същите пътища и JSON като TMDB v3. Четете сезон с всичките му епизоди или един епизод с дата на излъчване, продължителност и кадър.
- [API за детайли на личност](https://amodb.dev/bg/people/): API за детайли на личност със същите пътища и JSON като TMDB v3. Актьор или член на екип по id с биография, филмография, външни id и списък с популярни.
- [API за участниците](https://amodb.dev/bg/credits/): API за участници със същите пътища и JSON като TMDB v3. Актьори и екип за филми, сериали, сезони и епизоди, с полета order, department и job.
- [API за търсене](https://amodb.dev/bg/search/): API за търсене със същите пътища и JSON като TMDB v3. Намира филми, сериали, личности, колекции, компании и ключови думи по текст, с филтър по година.
- [Discover API](https://amodb.dev/bg/discover/): Discover API със същите филтри като TMDB v3. Списък с филми и сериали по жанр, актьори, компания, ключова дума, година, рейтинг и продължителност със сортиране.
- [Ендпойнти за тенденции и списъци](https://amodb.dev/bg/trending-lists/): API за филми в тенденция с пътища на TMDB v3: класации за ден и седмица, списъци в кината, популярни, най-добри и предстоящи, кеш 30 минути.
- [Жанрове и справочни списъци](https://amodb.dev/bg/genres/): API за списък с жанрове с пътища на TMDB v3: id на жанрове за филми и сериали с преведени имена, списъци с държави, езици, длъжности, рейтинги и доставчици.
- [API за изображения и хост за изображения](https://amodb.dev/bg/images-api/): API за изображения на филми с пътища на TMDB v3: списъци с постери, фонови изображения, лога и кадри, после зареждане от img.amodb.dev в 10 размера без ключ.
- [API за видеа и трейлъри](https://amodb.dev/bg/videos-trailers/): API за видеа с пътища на TMDB v3: списък с трейлъри, тийзъри, клипове и featurette за филм или сериал, после филтриране по тип и език във вашия код.
- [API за преводи](https://amodb.dev/bg/translations/): API за преводи на филми с пътища на TMDB v3: четете всяко записано заглавие, описание и слоган на филм, сериал или епизод на всички негови езици наведнъж.
- [API за ключови думи](https://amodb.dev/bg/keywords/): API за ключови думи с пътища на TMDB v3: тагове на сюжета, търсене на ключова дума, филмите ѝ и комбиниране на id с with_keywords в discover.
- [API за колекции](https://amodb.dev/bg/collections/): API за колекции от филми с пътища на TMDB v3: франчайз по id с всичките му части, belongs_to_collection във филм и търсене на колекции по име.
- [Компании и мрежи](https://amodb.dev/bg/companies-networks/): Търсете продуцентски компании и мрежи с пътища на TMDB v3. Четете име, държава и лого по id, после филтрирайте discover по компания или мрежа.
- [Рейтинги на филми и сериали](https://amodb.dev/bg/ratings/): API за рейтинги на филми връща оценки от IMDb, Kinopoisk, Metacritic, Rotten Tomatoes и TMDB за заглавие с едно извикване, с null за неизвестен източник.
- [Търсене по външен идентификатор](https://amodb.dev/bg/find-by-external-id/): Търсете филм, сериал или личност по IMDb, TVDB, Wikidata или Kinopoisk id с ендпойнта find на TMDB и четете външни id и факти от Wikidata за заглавие.
- [Ендпойнт, съвместим с OMDb](https://amodb.dev/bg/omdb-endpoint/): OMDb API съвместим ендпойнт на api.amodb.dev/omdb/. Търсене по i или t, списък през s, масив Ratings. Сменете базовия URL и клиентът ви продължава да работи.
- [Индикатори за настроение](https://amodb.dev/bg/moods/): API за настроение с индикатори от 0 до 10 за заглавие. Вземете настроението на филм или сериал, добавете го с append_to_response=moods и направете значки.
- [Саундтраци](https://amodb.dev/bg/soundtracks/): API за саундтраци връща албума със саундтрака на филм или сериал със списък на песните. Извикайте ендпойнта или добавете append_to_response=soundtracks.
- [Прожекции в кината](https://amodb.dev/bg/showtimes/): API за прожекции на филми връща кина и часове на прожекции в една държава или обобщение по държави. Слейте го с детайлите или го съчетайте с now_playing.

### Ресурси

- [Списък с промените](https://amodb.dev/bg/changelog/): Списък по дати на промените в API на amodb, хоста img.amodb.dev, плановете и сайта. Най-новите са отгоре: какво се е променило и какво да направите.

- [Статус](https://amodb.dev/bg/status/): Как да проверите дали amodb работи: публичният ендпойнт за състоянието, кодовете на грешки, които сочат инцидент, и как да подадете сигнал с нужните ни данни.

- [Справочник за API](https://amodb.dev/bg/reference/): Всеки ендпойнт на amodb с път, параметри, примерни заявки на пет езика и реален JSON отговор. Съвместим с TMDB v3 и OMDb.

- [Уроци](https://amodb.dev/bg/tutorials/): Уроци стъпка по стъпка за API на amodb: търсене, детайли, изображения, езици и заявки към OMDb в често ползвани стекове, всеки с код за копиране и пускане.

- [Сравнения на amodb](https://amodb.dev/bg/compare/): Сравнения на amodb с други API за метаданни за филми и сериали: съвместимост, езици, лимити, изображения и цени, с числа, които можете да проверите.

- [Случаи на употреба](https://amodb.dev/bg/use-cases/): Как екипите ползват amodb за данни за филми и сериали: каталози, медийни сървъри, препоръки, ботове и проучвания, с ендпойнтите и лимитите за всеки случай.

## Свързани страници

- [Бърз старт](https://amodb.dev/bg/quickstart/): Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути.
- [Удостоверяване](https://amodb.dev/bg/authentication/): Как да изпратите ключа си за amodb: api_key в заявката, заглавка Authorization с Bearer или apikey за OMDb. Формат, съхранение, смяна на ключ и грешките 401.
- [Цени](https://amodb.dev/bg/pricing/): Планове на amodb, различни само по заявките в минута: 20, 40 или 120. Всеки включва всички данни, съвместими с TMDB v3 и OMDb. Предплатено, без подновяване.

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