# Документація 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/uk/quickstart/): Перший виклик amodb: отримайте ключ, запросіть деталі фільму в curl, JavaScript, Python, PHP чи Go і завантажте постер з img.amodb.dev. Менш ніж за 2 хвилини.
- [Автентифікація](https://amodb.dev/uk/authentication/): Як надсилати ключ amodb: api_key у запиті, заголовок Authorization Bearer або apikey для викликів OMDb. Формат ключа, зберігання, заміна та помилки 401.

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

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

### Довідник API

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

### Ресурси

- [Журнал змін](https://amodb.dev/uk/changelog/): Список змін API amodb, хоста зображень img.amodb.dev, тарифів і сайту за датами. Нові записи зверху: що змінилося і що потрібно зробити вам.

- [Статус](https://amodb.dev/uk/status/): Як перевірити, чи працює amodb: публічний ендпоінт стану, коди помилок, що вказують на інцидент, і як повідомити про проблему з потрібними нам подробицями.

- [Довідник API](https://amodb.dev/uk/reference/): Усі ендпоінти amodb зі шляхом, параметрами, прикладами запитів п'ятьма мовами та справжньою відповіддю JSON. Сумісні з TMDB v3 і OMDb.

- [Посібники](https://amodb.dev/uk/tutorials/): Покрокові посібники з API amodb: пошук, деталі, зображення, мови та виклики OMDb у популярних стеках, кожен із кодом, який можна скопіювати й запустити.

- [Порівняння amodb](https://amodb.dev/uk/compare/): Порівняння amodb з іншими API метаданих фільмів і серіалів: сумісність, мови, ліміти, зображення та ціни з цифрами, які можна перевірити.

- [Сценарії використання](https://amodb.dev/uk/use-cases/): Як команди використовують amodb для даних про фільми й серіали: каталоги, медіасервери, рекомендації, боти та дослідження, з ендпоінтами й лімітами для кожного.

## Пов'язані сторінки

- [Швидкий старт](https://amodb.dev/uk/quickstart/): Перший виклик amodb: отримайте ключ, запросіть деталі фільму в curl, JavaScript, Python, PHP чи Go і завантажте постер з img.amodb.dev. Менш ніж за 2 хвилини.
- [Автентифікація](https://amodb.dev/uk/authentication/): Як надсилати ключ amodb: api_key у запиті, заголовок Authorization Bearer або apikey для викликів OMDb. Формат ключа, зберігання, заміна та помилки 401.
- [Ціни](https://amodb.dev/uk/pricing/): Тарифи amodb різняться лише запитами на хвилину: 20, 40 або 120. Кожен дає всі дані, сумісні з TMDB v3 та OMDb. Передплата, без поновлення й пробного періоду.

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