GetTrailer » API
Документация использования API

Уважаемые разработчики Вы можете воспользоваться нашим открытым API совершенно бесплатно. Даная страница содержит способы получения нужного трейлера по соответствующим параметрам. Существует несколько режимов API, с ними можно ознакомится ниже.

Все видео ролики предоставляются с видеохостинга YouTube и других открытых источников. Как Вы уже знаете, иногда ютуб блокирует своих пользователей или их видео, соответственно оно перестаёт быть доступным, наш алгоритм и команда следить за этим и в кротчайшие сроки обновляет источник видео, потому Вы можете быть уверены в том что нужный трейлер на ваших страницах сайта всегда будет доступный для просмотра.

Простой режим
Авторазмещение трейлера по ID Кинопоиска, ID IMBD

Этот способ подходит для любых CMS, в том числе самописных движков, все что нужно, просто вставить код на HTML страницу. Для максимально точного поиска главное условие - Кинопоиск ID или IMDB.

Пример с использованием параметра Кинопоиск ID:
	
<iframe src="https://gettrailer.online/embed/kinopoisk_id/XXXXXXX" frameborder="0" scrolling="no" allowfullscreen="" width="800" height="450"></iframe>
   

где XXXXXXX - ID Кинопоиска

Пример с использованием параметра IMBD ID:
	
<iframe src="https://gettrailer.online/embed/imdb_id/ttXXXXXX" frameborder="0" scrolling="no" allowfullscreen="" width="800" height="450"></iframe>
   

где ttXXXXXX - ID IMBD

Языковый параметр

Является не обязательным, если не указать, по умолчанию используется русский язык. Данный параметр возвращает плеер с кнопками управления и видео, если оно привязано и существует на указанном языке.

Пример с использованием параметра:
	
<iframe src="https://gettrailer.online/embed/kinopoisk_id/444/ISO 639" frameborder="0" scrolling="no" allowfullscreen="" width="800" height="450"></iframe>
   

где ISO 639 - Код языка

На данный момент поддерживаются:

ru - русский, можно не указывать, используется по умолчанию

uk - украинский

en - английский

Расширенный режим

Для того, чтобы получить информацию о фильме, сериале, аниме, аниме-сериале или tv-шоу требуется направить запрос на URL https://gettrailer.online/api.json с GET параметрами. Обьязательно указание вашего API user_key, который можно найти в профиле.

Список параметров, которые Вы можете использовать:

Параметр Описания Пример
user_key

Личный ключ пользователя API

kinopoisk_id

ID Кинопоиска

imdb_id

ID IMDB

title

Любое название фильма/сериала (на русском, оригинальное, альтернативное), как Вам удобно

limit

Данный параметре работает только с параметром title, максимальное значения - 10, по умолчанию - 5

list

Получить список всех доступных фильмов, сериалов, аниме и tv-шоу, обратите внимание, что данный метод поддерживает постраничную навигацию

lang

Данный параметр возвращает плеер с кнопками управления на указанном языке. Возвратит видео и постер, если они существует на указанном языке, либо те что используются по умолчанию. Указываем код языка в ISO 639 формате, на данный момент поддерживаются: ru, uk, en

Важно! При использовании данного параметра вместе с параметром list, возвратить только те результаты, которые переведены на соответствующий язык.

Пример успешного ответа:


	
{
    "status_code": "200",
    "response": {
        "message": "Запрос успешно обработан",
        "num_result": 1,
        "result": [
            {
                "kinopoisk_id": "444",
                "imdb_id": "tt0103064",
                "world_art_id": "",
                "tmdb_id": "280",
                "rating_kp": "8,3",
                "rating_imdb": "8,5",
                "premiere": "01-07-1991",
                "age_restrictions": "18",
                "year": "1991",
                "iframe_src": "https://gettrailer.online/embed/kinopoisk_id/444&user=2",
                "poster_src": "https://gettrailer.online/uploads/posts/2020-11/1606750044_444.jpg",
                "name": "Терминатор 2: Судный день",
                "original_name": "Terminator 2: Judgment Day",
                "genre": "Боевик, Триллер, Фантастика",
                "country": "Сша",
                "actors": "Арнольд Шварценеггер, Линда Хэмилтон, ",
                "directors": "Джеймс Кэмерон",
                "producers": "Джеймс Кэмерон, Стефани Остин",
                "tagline": "Same Make. Same Model. New Mission",
                "description": "Прошло более десяти лет с тех пор, как киборг из 2029 г...",
                "translation": {
                    "en": {
                        "iframe_src": "https://gettrailer.online/embed/kinopoisk_id/444/en&user=2",
                        "poster_src": "https://gettrailer.online/uploads/posts/2021-01/1610021734_mv5bmgu2nzrmzjutoguxys00zjdjlwewzwity2nlm2jhnjkxntfmxkeyxkfqcgdeqxvynju0otq0oty__v1_ux182_cr00182268_al_.jpg",
                        "name": "Terminator 2: Judgment Day",
                        "original_name": "Terminator 2: Judgment Day",
                        "genre": "Action, Thriller, Sci-Fi",
                        "country": "USA",
                        "actors": "Arnold Schwarzenegger, Linda Hamilton, ",
                        "directors": "James Cameron",
                        "producers": "James Cameron, Stephanie Austin",
                        "tagline": "Same Make. Same Model. New mission",
                        "description": "More than ten years have passed since the cyborg from 2029 t..."
                    },
                    "uk": {
                        "iframe_src": "https://gettrailer.online/embed/kinopoisk_id/444/uk&user=2",
                        "poster_src": "https://gettrailer.online/uploads/posts/2021-01/1610022007_unnamed.jpg",
                        "name": "Термінатор 2: Судний день",
                        "original_name": "Terminator 2: Judgment Day",
                        "genre": "Бойовик, Триллер, Фантастика",
                        "country": "Сша",
                        "actors": "Арнольд Шварценеггер, Лінда Хемілтон",
                        "directors": "Джеймс Кемерон",
                        "producers": "Джеймс Кемерон, Стефані Остін",
                        "tagline": "Same Make. Same Model. New Mission",
                        "description": "Минуло більше десяти років з тих пір, як кіборг з 2029 р..."
                    }
                },
                "report_url": "https://gettrailer.online/index.php?newsid=17408#report-video",
                "service": []
            }
        ]
    }
}

     

Коды ответа API:

Код Описания
200

Запрос успешно обработан. Необходимые данные возращены.

400

Неверный запрос, если параметр kinopoisk_id, imdb_id, title или list не установлено.

403

Если неверный ключ пользователя, пользователь не найден или пользователь забанен.

404

По соответствующим параметрам нечего не найдено.

503

API временно не доступно. Ведутся технические работы.