Получить ключ 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 месяцев, и чем длиннее период, тем дешевле месяц. Бесплатного тарифа и автоматического продления нет.

Цены

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

Нет. Направьте базовый 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"