Use cases
These pages show how amodb fits common products: catalogs, media servers, recommendation tools, chat bots and research. Each page lists the endpoints you need, the request rate that fits, and the plan that covers it. Every plan includes all data; plans differ only in requests per minute.
-
API фильмов для поиска, данных и рейтингов
amodb, платный API фильмов по адресу https://api.amodb.dev/3, использует те же пути и JSON, что TMDB v3. Найдите фильм через /search/movie, затем прочитайте его с append_to_response и получите актеров, трейлеры и рейтинги одним запросом. Ответы приходят на 14 языках, от 20 запросов в минуту.
-
API сериалов: сериалы, сезоны и серии
API сериалов возвращает сериал по адресу GET /3/tv/{series_id} со статусом, телесетями, списком сезонов и next_episode_to_air. Эндпоинты сезонов и серий добавляют даты выхода, продолжительность и кадры. JSON совпадает с TMDB v3, 14 языков, предоплатные тарифы на 20, 40 или 120 запросов в минуту.
-
API аниме с фильтрами discover
В amodb нет отдельного эндпоинта для аниме. Список аниме получают через /3/discover/tv или /3/discover/movie с жанром 16 и with_original_language=ja, а затем сужают его id ключевого слова anime из /3/search/keyword. Японский не входит в языки интерфейса, но original_name сохраняет оригинальное японское название.
-
API базы фильмов для вашего каталога
Используйте amodb как источник для собственной базы фильмов. Фильмы, люди, компании, коллекции, ключевые слова и жанры имеют общие числовые id, поэтому строки легко связываются. Заполняйте базу постраничным discover по окнам дат выхода, обновляйте строки по возрасту и сопоставляйте свои id через поиск по внешнему ID. JSON TMDB v3, от 20 до 120 запросов в минуту.
-
API постеров фильмов и CDN изображений
Постеры загружаются с https://img.amodb.dev/t/p/{size}/{file} без ключа API. Файловая часть: poster_path из ответа любого фильма, поиска или списка. Названия размеров идут от w92 до original, а параметр include_image_language выбирает постеры по языку. Ключ нужен только для вызовов JSON, которые возвращают имена файлов.
-
API трейлеров фильмов работает через GET /3/movie/{movie_id}/videos на api.amodb.dev. Каждое видео содержит тип, флаг official, язык и дату публикации, поэтому нужный официальный трейлер выбирается за один проход по списку. Сериалы возвращают ту же структуру. Пути и JSON совпадают с TMDB v3.
-
API актеров построен на семействе people из TMDB v3 по адресу api.amodb.dev/3. Получите человека через GET /3/person/{person_id}, добавьте combined_credits для полной фильмографии и images для фото профиля. Список популярных, поиск по имени и поиск по IMDb id работают с тем же ключом и в том же формате JSON.
-
Многоязычный API метаданных фильмов
Этот многоязычный API метаданных фильмов с одним ключом отдает названия, описания, слоганы, названия жанров и биографии на 14 языках: английском, русском, украинском, белорусском, китайском, португальском, болгарском, иврите, чешском, румынском, французском, польском, итальянском и испанском. Передайте тег TMDB, например ru-RU, в параметре language.
-
API сеансов кинотеатров: GET /3/movie/{movie_id}/showtimes?country=US. Он возвращает кинотеатры с адресом и часовым поясом, а для каждого сеанса время начала, форматы и ссылку на бронирование, где они известны. Без country приходят только счетчики по странам. Покрытие зависит от фильма, пустой массив results означает, что данных нет.
-
API списка серий возвращает все серии сериала через GET /3/tv/{tv_id}/season/{season_number}. У каждой серии есть название, описание, дата выхода, длительность и кадр. Список episode_groups называет альтернативные порядки, например DVD или сквозной. Пути и JSON совпадают с TMDB v3, поэтому готовым клиентам нужен только новый базовый URL.
Start with one key
Every plan includes all endpoints, all 14 languages and images. Plans differ only in requests per minute.