Отримати ключ API

API метаданих фільмів і серіалів

Дані про фільми й серіали, сумісні з TMDB та OMDb

Ті самі шляхи й JSON, що в TMDB v3 та OMDb. Змініть базовий URL, а код залиште як є.

Отримати ключ API Відкрити швидкий старт
BASE_URL
  • https://api.themoviedb.org/3
  • https://api.amodb.dev/3
  • https://www.omdbapi.com/
  • https://api.amodb.dev/omdb/

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. Один ключ підходить для обох стилів, 14 мов і постерів на img.amodb.dev. Кожен тариф містить усі дані, а відрізняються тарифи лише запитами на хвилину.

01 · /3/movie/550

Змініть базовий URL, а код залиште

amodb відповідає за тими самими шляхами, що й TMDB v3. Запит фільму 550 повертає ті самі поля JSON, які ваш клієнт уже розбирає: id, title, genres, release_date, poster_path та інші.

  1. Отримайте ключ

    Оберіть тариф і скопіюйте ключ в особистому кабінеті.

    Authorization: Bearer $AMODB_KEY

  2. Змініть базовий URL

    Спрямуйте клієнт TMDB або OMDb на api.amodb.dev.

    api.themoviedb.orgapi.amodb.dev

  3. Запускайте

    Повертається той самий JSON, тож парсер працює без змін.

    200 OKapplication/json

Передавайте ключ як api_key у запиті або в заголовку Authorization: Bearer. Обидва способи працюють на кожному ендпоінті.

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"
}

02 · /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"
}

03 · append_to_response

Дані, яких немає в TMDB v3

Кожен ключ може викликати розширення amodb на тому самому базовому URL. Додавайте їх через append_to_response або викликайте окремо.

  • Індикатори настрою

    Страх, гумор, смуток, насильство та інші показники за шкалою від 0 до 10, одним додатковим викликом.

    GET /3/tv/1396/moods

  • Рейтинги одним викликом

    IMDb, TMDB і ще три оцінки з кількістю голосів з одного ендпоінта.

    GET /3/movie/550/ratings

  • Ліміт, який видно

    Кожна відповідь повідомляє, скільки запитів залишилося цієї хвилини.

  • Усі розміри зображень TMDB

    Від мініатюр w92 до оригінальних файлів на img.amodb.dev. Ключ не потрібен.

    img.amodb.dev/t/p/w500/…

  • Пошук за будь-яким зовнішнім ID

    Надішліть id IMDb або інший зовнішній id і отримайте запис TMDB.

    GET /3/find/tt0137523

  • Сеанси в кінотеатрах

    Сеанси за країнами для фільмів у кінотеатрах, коли вони відомі.

    GET /3/movie/550/showtimes?country=US

  • Саундтреки

    Пісні з фільму чи серіалу на тому самому базовому URL.

    GET /3/movie/157336/soundtracks

04 · ?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

05 · /plans

Тарифи відрізняються лише запитами на хвилину

Кожен тариф містить усі ендпоінти, усі 14 мов, зображення та розширення. Ви платите один раз за 1, 3, 6, 12 або 24 міс., а довший період коштує менше на місяць. Безкоштовного тарифу й автоматичного подовження немає.

  • Lite

    20 запитів на хвилину

    від 3,11 USD на місяць

    Обрати Lite

  • Pro

    40 запитів на хвилину

    від 3,71 USD на місяць

    Обрати Pro

  • Pro+

    120 запитів на хвилину

    від 4,31 USD на місяць

    Обрати Pro+
Ціни

06 · X-RateLimit-Remaining

Розраховано на робоче навантаження

  • Спільний кеш на периферії

    Популярні списки кешуються на 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?

Ні. Спрямуйте базовий 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 працює лише за передплатою. Ви обираєте тариф і період, платите один раз, і ключ діє до кінця періоду. Автоматичного подовження немає.

Чим відрізняються тарифи?

Лише швидкістю запитів: 20, 40 або 120 запитів на хвилину. Кожен тариф містить усі ендпоінти, усі 14 мов, зображення та розширення amodb.

Якими мовами віддаються дані?

Англійською, російською, українською, білоруською, китайською, португальською, болгарською, івритом, чеською, румунською, французькою, польською, італійською та іспанською. Передайте тег у стилі TMDB, наприклад ru-RU; будь-яка інша мова переходить на англійську.

Почніть з одного ключа

Кожен тариф містить усі ендпоінти, усі 14 мов і зображення. Тарифи відрізняються лише запитами на хвилину.

Отримати ключ API Відкрити швидкий старт
$ curl https://api.amodb.dev/3/movie/550 -H "Authorization: Bearer $AMODB_KEY"