# Дакументацыя 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/be/quickstart/): Першы выклік да amodb: атрымайце ключ, запытайце дэталі фільма ў curl, JavaScript, Python, PHP або Go і загрузіце постэр з img.amodb.dev. Менш за 2 хвіліны. - [Аўтэнтыфікацыя](https://amodb.dev/be/authentication/): Як перадаваць ключ amodb: api_key у запыце, загаловак Authorization Bearer або apikey для выклікаў OMDb. Фармат ключа, захоўванне, замена і памылкі 401. ### Асноўныя паняцці - [Ліміты запытаў](https://amodb.dev/be/rate-limits/): amodb абмяжоўвае ключ па запытах у хвіліну ў слізгальным акне 60 секунд: 20, 40 або 120 па плане. Чытайце загалоўкі лімітаў і апрацоўвайце 429 праз Retry-After. - [Памылкі](https://amodb.dev/be/errors/): Усе памылкі amodb з HTTP-статусам, TMDB status_code і паведамленнем, а таксама форма памылкі OMDb. Што азначае кожная і што рабіць вашаму кліенту далей. - [Мовы](https://amodb.dev/be/languages/): amodb аддае назвы, апісанні і імёны на 14 мовах. Перадайце тэг у стылі TMDB, напрыклад ru-RU або pt-BR, у language; любы іншы тэг замяняецца англійскай мовай. - [Выявы](https://amodb.dev/be/images/): Загружайце постэры, фонавыя выявы і фота персон з img.amodb.dev па шляхах і памерах TMDB, ад w92 да original. Ключ не патрэбны, кэш 30 дзён, адзін шаблон URL. ### Даведнік API - [API дэталяў фільма](https://amodb.dev/be/movies/): API дэталяў фільма з тымі ж шляхамі і JSON, што ў TMDB v3. Адзін фільм па id, а акцёры, рэйтынгі і настрой праз append_to_response, на 14 мовах. - [API серыялаў](https://amodb.dev/be/tv-series/): API серыялаў з тымі ж шляхамі і JSON, што ў TMDB v3. Серыял па id з сезонамі, тэлеканаламі і наступным эпізодам, плюс узроставыя рэйтынгі і сэрвісы прагляду. - [API сезонаў і эпізодаў серыялаў](https://amodb.dev/be/tv-seasons-episodes/): API сезонаў і эпізодаў з тымі ж шляхамі і JSON, што ў TMDB v3. Чытайце сезон з усімі эпізодамі або адзін эпізод з датай эфіру, працягласцю і кадрам. - [API дэталяў персоны](https://amodb.dev/be/people/): API дэталяў персоны з тымі ж шляхамі і JSON, што ў TMDB v3. Акцёр ці член групы па id з біяграфіяй, фільмаграфіяй, вонкавымі id і спісам папулярных. - [API ўдзельнікаў](https://amodb.dev/be/credits/): API ўдзельнікаў з тымі ж шляхамі і JSON, што ў TMDB v3. Акцёры і здымачная група фільмаў, серыялаў, сезонаў і эпізодаў з палямі order, department і job. - [API пошуку](https://amodb.dev/be/search/): API пошуку з шляхамі і JSON як у TMDB v3. Фільмы, серыялы, персоны, калекцыі, кампаніі і ключавыя словы па тэксце, з фільтрамі па годзе і старонкамі. - [Discover API](https://amodb.dev/be/discover/): Discover API з фільтрамі TMDB v3. Спіс фільмаў і серыялаў па жанры, акцёрах, кампаніі, ключавым слове, годзе, рэйтынгу і працягласці з сартаваннем. - [Эндпоінты трэндаў і спісаў](https://amodb.dev/be/trending-lists/): API трэндавых фільмаў з шляхамі TMDB v3: чарты за дзень і тыдзень, спісы зараз у пракаце, папулярных, лепшых і хутка ў пракаце, кэш 30 хвілін. - [Жанры і даведачныя спісы](https://amodb.dev/be/genres/): API спіса жанраў з шляхамі TMDB v3: id жанраў фільмаў і серыялаў з перакладзенымі назвамі, а таксама спісы краін, моў, пасад, узроставых рэйтынгаў і сэрвісаў. - [API выяў і хост выяў](https://amodb.dev/be/images-api/): API выяў фільмаў з шляхамі TMDB v3: спісы постэраў, фонавых выяў, лагатыпаў і кадраў назвы, а потым загрузка з img.amodb.dev у 10 памерах без ключа. - [API відэа і трэйлераў](https://amodb.dev/be/videos-trailers/): API відэа з шляхамі TMDB v3: спіс трэйлераў, тызераў, кліпаў і фічарэтаў для фільма або серыяла, а потым фільтр па тыпе і мове ў вашым кодзе. - [API перакладаў](https://amodb.dev/be/translations/): API перакладаў фільмаў з шляхамі TMDB v3: чытайце ўсе захаваныя назвы, апісанні і слоганы фільма, серыяла або эпізода на ўсіх мовах за адзін раз. - [API ключавых слоў](https://amodb.dev/be/keywords/): API ключавых слоў з шляхамі TMDB v3: тэгі сюжэта фільма або серыяла, пошук ключавога слова, яго фільмы і спалучэнне id з with_keywords у discover. - [API калекцый](https://amodb.dev/be/collections/): API калекцый фільмаў з шляхамі TMDB v3: чытайце франшызу па id з усімі часткамі, belongs_to_collection у фільме і шукайце калекцыі па назве. - [Кампаніі і тэлеканалы](https://amodb.dev/be/companies-networks/): Шукайце кінакампаніі і тэлеканалы па шляхах TMDB v3. Чытайце назву, краіну і лагатып па id, потым фільтруйце discover па id кампаніі або тэлеканала. - [Рэйтынгі фільмаў і серыялаў](https://amodb.dev/be/ratings/): API рэйтынгаў фільмаў вяртае ацэнкі IMDb, Kinopoisk, Metacritic, Rotten Tomatoes і TMDB для назвы адным выклікам, з null для крыніцы, якая невядомая. - [Пошук па вонкавым ідэнтыфікатары](https://amodb.dev/be/find-by-external-id/): Шукайце фільм, серыял або персону па IMDb, TVDB, Wikidata ці Kinopoisk id праз эндпоінт find TMDB і чытайце вонкавыя id і факты Wikidata для назвы. - [Эндпоінт, сумяшчальны з OMDb](https://amodb.dev/be/omdb-endpoint/): Эндпоінт, сумяшчальны з OMDb API, па адрасе api.amodb.dev/omdb/. Пошук па i або t, спіс праз s, масіў Ratings. Змяніце базавы URL, і кліент працуе далей. - [Індыкатары настрою](https://amodb.dev/be/moods/): API настрою з індыкатарамі ад 0 да 10 для кожнай назвы. Дадавайце настрой фільма ці серыяла праз append_to_response=moods і будуйце значкі або фільтры. - [Саўндтрэкі](https://amodb.dev/be/soundtracks/): API саўндтрэкаў вяртае альбом саўндтрэка фільма або серыяла са спісам трэкаў. Выклічце эндпоінт або дадайце append_to_response=soundtracks да дэталяў. - [Сеансы ў кінатэатрах](https://amodb.dev/be/showtimes/): API сеансаў фільмаў вяртае кінатэатры і час сеансаў фільма ў адной краіне або зводку па краінах. Далучайце яго да дэталяў або спалучайце з now_playing. ### Рэсурсы - [Спіс змен](https://amodb.dev/be/changelog/): Спіс змен у API amodb, на хосце выяў img.amodb.dev, у планах і на сайце па датах. Новыя запісы ўверсе: што змянілася і што вам трэба зрабіць. - [Статус](https://amodb.dev/be/status/): Як праверыць, ці працуе amodb: публічны эндпоінт health, коды памылак, што паказваюць на інцыдэнт, і як паведаміць пра праблему з патрэбнымі нам звесткамі. - [Даведнік API](https://amodb.dev/be/reference/): Усе эндпоінты amodb: шлях, параметры, прыклады запытаў на пяці мовах праграмавання і рэальны адказ JSON. Сумяшчальнасць з TMDB v3 і OMDb. - [Падручнікі](https://amodb.dev/be/tutorials/): Падручнікі па API amodb крок за крокам: пошук, дэталі, выявы, мовы і запыты OMDb у распаўсюджаных стэках, з кодам, які можна скапіраваць і запусціць. - [Параўнанні amodb](https://amodb.dev/be/compare/): Параўнанні amodb з іншымі API метаданых фільмаў і серыялаў: сумяшчальнасць, мовы, ліміты, выявы і цэны з лікамі, якія можна праверыць. - [Сцэнары выкарыстання](https://amodb.dev/be/use-cases/): Як каманды выкарыстоўваюць amodb для даных пра фільмы і серыялы: каталогі, медыясерверы, рэкамендацыі, боты і даследаванні, з патрэбнымі эндпоінтамі і лімітамі. ## Звязаныя старонкі - [Хуткі старт](https://amodb.dev/be/quickstart/): Першы выклік да amodb: атрымайце ключ, запытайце дэталі фільма ў curl, JavaScript, Python, PHP або Go і загрузіце постэр з img.amodb.dev. Менш за 2 хвіліны. - [Аўтэнтыфікацыя](https://amodb.dev/be/authentication/): Як перадаваць ключ amodb: api_key у запыце, загаловак Authorization Bearer або apikey для выклікаў OMDb. Фармат ключа, захоўванне, замена і памылкі 401. - [Цэны](https://amodb.dev/be/pricing/): Планы amodb адрозніваюцца толькі лікам запытаў у хвіліну: 20, 40 або 120. Усе даныя TMDB v3 і OMDb у кожным плане. Аплата наперад, без аўтапрадаўжэння. Абноўлена: 2026-10-18. Source: https://amodb.dev/be/docs/