API за метаданни за филми и сериали

API за филми с всички рейтинги, съвместим с TMDB и OMDb

Сменете един URL, запазете кода си за TMDB или OMDb и получавайте рейтинги от IMDb, Rotten Tomatoes, Metacritic и Kinopoisk в същия отговор.

GEThttps://api.amodb.dev/3/movie/550?language=en-US

200 OKapplication/json1,7 kBОтговор на живо

{  "id": 550,  "imdb_id": "tt0137523",  "title": "Fight Club",  "tagline": "Mischief. Mayhem. Soap.",  "release_date": "1999-10-15",  "runtime": 139,  "status": "Released",  "genres": [{ "id": 18, "name": "Drama" }, { "id": 53, "name": "Thriller" }],  "origin_country": ["US", "DE"],  "original_language": "en",  "budget": 63000000,  "revenue": 101209702,  "vote_average": 8.437,  "vote_count": 33042,  "popularity": 39.0054,  "poster_path": "/jSziioSwPVrOy9Yow3XhWIBDjq1.jpg",  "backdrop_path": "/b9HyPoxwxjxkWEUL5ErZdhApQe2.jpg"}

amodb предлага платен API за филми и сериали, който запазва пътищата и JSON от TMDB v3 и OMDb, затова кодът ви работи след смяна на базовия URL. Един ключ добавя рейтинги от IMDb, Rotten Tomatoes, Metacritic и Kinopoisk, измерители на настроение и саундтраци, а търговската употреба е включена във всеки предплатен план.

01 · /compare?tmdb&omdb

Защо да плащате за API за филми, щом TMDB е безплатен?

TMDB е безплатен, докато приложението ви не спечели първия си долар. След това TMDB изисква търговския си план: $149 на месец за компании с приходи под $1M. В TMDB няма и оценки от IMDb, Rotten Tomatoes и Metacritic, а OMDb, обичайният втори API, е лицензиран за нетърговска употреба. В amodb двата формата са с един ключ, а търговската употреба е включена от 3,11 щ.д. на месец.

КритерийTMDBOMDbamodb
Цена, когато приложението започне да печели$149 на месец при приходи под $1MУсловия за нетърговска употребаОт 3,11 щ.д. на месец
Пътища и JSON на TMDB v3ДаНеДа
Параметри и полета на OMDbНеДаДа
Рейтинги от IMDb, Rotten Tomatoes и MetacriticНе, само оценката на TMDBДаДа, плюс Kinopoisk и TMDB
Измерители на настроение, саундтраци и прожекцииНеНеДа
Без лого и бележка на екраните виНе, лого и бележка са задължителниНе е посоченоДа
Един ключ за двата форматаНеНеДа

Източници: условията на TMDB API, отговорите на служители на TMDB за търговските цени и за това кога приложението се смята за търговско, и правната страница на OMDb. Прочетено през октомври 2026 г.

02 · /3/movie/550

Сменете базовия URL, запазете кода си

amodb отговаря на същите пътища като TMDB v3. Заявка за филм 550 връща същите полета в JSON, които клиентът ви вече обработва: id, title, genres, release_date, poster_path и останалите.

Подавайте ключа като api_key в заявката или в заглавката Authorization: Bearer. И двата начина работят на всеки ендпойнт.

  1. Вземете ключ

    Изберете план и копирайте ключа от профила си.

    Authorization: Bearer $AMODB_KEY
  2. Сменете базовия URL

    Насочете клиента за TMDB или OMDb към api.amodb.dev.

    api.themoviedb.orgapi.amodb.dev
  3. Пускайте

    Връща се същият JSON, затова парсерът работи без промени.

    200 OKapplication/json
bashjspy
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
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);
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"
}

03 · /omdb/?i=tt0137523

Един ключ за извиквания в стил 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":"..."}.

bashjspy
curl "https://api.amodb.dev/omdb/?i=tt0137523&plot=short&apikey=$AMODB_KEY"
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);
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"
}

04 · append_to_response

Данни, които TMDB v3 не връща

Всеки ключ може да извиква разширенията на amodb на същия базов URL. Добавяйте ги с append_to_response или ги извиквайте отделно.

  • Измерители на настроение

    Страх, хумор, тъга, насилие и други показатели по скала от 0 до 10, с една допълнителна заявка.

    GET /3/tv/1396/moods
  • Рейтинги с една заявка

    IMDb, TMDB и още три оценки с брой гласове, от един ендпойнт.

    GET /3/movie/550/ratings
  • Лимит, който се вижда

    Всеки отговор показва колко заявки остават за тази минута.

    X-RateLimit-Limit: 40
  • Всички размери изображения на TMDB

    От миниатюри w92 до оригинални файлове на img.amodb.dev. Без ключ.

    img.amodb.dev/t/p/w500/…
  • Търсене по всеки външен идентификатор

    Подайте IMDb id или друг външен идентификатор и вземете записа от TMDB.

    GET /3/find/tt0137523
  • Прожекции в кината

    Прожекции по държави за заглавия, които се дават в кината, когато са известни.

    GET /3/movie/550/showtimes?country=US
  • Саундтраци

    Песните от филм или сериал, на същия базов URL.

    GET /3/movie/157336/soundtracks

05 · ?language=uk-UA

Заглавия и описания на 14 езика

Подайте в language таг в стил TMDB, например ru-RU или pt-BR. amodb обслужва 14 основни езика и за всеки друг таг се връща към английски, така че заявката никога не се проваля заради език.

Език

Spirited Away

Унесённые призраками

Віднесені привидами

Скрадзеныя прывідамі

千与千寻

A Viagem de Chihiro

Отнесени от духове

המסע המופלא

Cesta do fantazie

Călătoria lui Chihiro

Le Voyage de Chihiro

Spirited Away: W krainie Bogów

La città incantata

El viaje de Chihiro

  • en English Spirited Away
  • ru Русский Унесённые призраками
  • uk Українська Віднесені привидами
  • be Беларуская Скрадзеныя прывідамі
  • zh 中文 千与千寻
  • pt Português A Viagem de Chihiro
  • bg Български Отнесени от духове
  • he עברית המסע המופלא
  • cs Čeština Cesta do fantazie
  • ro Română Călătoria lui Chihiro
  • fr Français Le Voyage de Chihiro
  • pl Polski Spirited Away: W krainie Bogów
  • it Italiano La città incantata
  • es Español El viaje de Chihiro

Подходящо за лични и търговски проекти

Уикенд проектът и платеният продукт използват един и същ API, получават едни и същи данни и се подчиняват на едни и същи условия. Ето какво се изгражда с него.

  • Стрийминг приложения и списъци за гледане Постери, трейлъри, сезони и епизоди, плюс пет рейтинга за сортиране и филтриране.
  • Ботове за Telegram и Discord Търсене в стил OMDb по заглавие или IMDb id връща готов отговор с едно извикване.
  • Медийни сървъри и добавки Инструменти за метаданни, които вече работят с TMDB v3, запазват клиента си и получават оценки от IMDb и Rotten Tomatoes.
  • Филмови сайтове и блогове Заглавия и описания на 14 езика, така че всеки пазар получава своя страница.
  • Системи за препоръки Измерителите на настроение оценяват страх, хумор, насилие и други по скала от 0 до 10: това са сигнали, които жанровете сами не дават.
  • ИИ агенти и чатботове Отговарят на въпроса „какво да гледам тази вечер“ с реални рейтинги, настроения, актьори и прожекции.

06 · /plans

Плановете се различават по заявките в минута

Всеки план дава достъп до едни и същи данни: ендпойнтите на TMDB и OMDb, всичките 14 езика, изображенията и разширенията. Pro+ получава и /3/all: всичко за филм, сериал или личност в една заявка. Плащате веднъж за 1, 3, 6, 12 или 24 месеца, а по-дългият период излиза по-евтино на месец. Безплатен план и автоматично подновяване няма.

Цени

07 · X-RateLimit-Remaining

Създадено за работа с реален трафик

  • Споделен edge кеш

    Популярните списъци се кешират за 30 минути, подробностите за 6 часа, а configuration за 24 часа.

  • Ясни лимити на заявките

    Всеки отговор съдържа X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset. Отговор 429 добавя Retry-After.

  • Грешки в стил TMDB

    Грешките връщат 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; всеки друг език се заменя с английски.

Започнете с един ключ

Всеки план дава достъп до едни и същи данни, всичките 14 езика и изображенията. Плановете се различават по заявките в минута, а Pro+ получава и /3/all: всичко за филм, сериал или личност в една заявка.

$ curl https://api.amodb.dev/3/movie/550 -H "Authorization: Bearer $AMODB_KEY"