Реализация Api для сервиса kinopoisk.dev
Project description
Kinopoisk Dev Api
Python-модуль для взаимодействия с неофициальным API КиноПоиска
Установка
$ pip install kinopoisk-dev
Получение токена
Для получения токена необходимо перейти kinopoisk.dev и написать по контактам.
Movie
Методы для работы с данными о фильмах
Получить данные о фильме по Kinopoisk ID
Возвращает информацию о фильме.
Эндпоинт
- /movieМетод
- movie
from kinopoisk_dev import KinopoiskDev, Field
kp = KinopoiskDev(token=TOKEN)
item = kp.movie(field=Field.KP, search="301")
Сложная поисковая конструкция
Можно задавать сложные конструкции для поиска.
Эндпоинт
- /movieМетод
- movies
Пример из документации
Представим что нам нужно найти сериалы typeNumber - 2 с рейтингом kp от 7 до 10 которые были выпущены с 2017 по 2020 год. При этом мы ходим чтобы они были осортированы по году в порядке возрастания, но при этом были отсортированы по голосам на imdb в порядке убывания. Для этого нам придется подготовить параметры
from kinopoisk_dev import KinopoiskDev, Field, MovieParams
kp = KinopoiskDev(token=TOKEN)
items = kp.movies([
MovieParams(field='rating.kp', search='7-10'),
MovieParams(field=Field.YEAR, search="2017-2020"),
MovieParams(field="typeNumber", search="2"),
MovieParams(sortField="year", sortType=1),
MovieParams(sortField="votes.imdb", sortType=-1),
], limit=1000, page=1)
Получить информацию о списке фильмов
from kinopoisk_dev import KinopoiskDev, Field, MovieParams
kp = KinopoiskDev(token=TOKEN)
items = kp.movies([
MovieParams(field='id', search='301'),
MovieParams(field=Field.KP, search="326"),
])
Season
Методы для работы с сезонами сериалов
Получить сезоны сериалы
Возвращает информацию о сезонах
Эндпоиск
- /seasonМетод
- season
from kinopoisk_dev import KinopoiskDev, Field, SeasonParams
kp = KinopoiskDev(token=TOKEN)
season = kp.season(field=Field.MOVIE_ID, search="1316601")
Получить сезоны списка сериалов
Возвращает информацию о сезонах списка сериалов
Эндпоиск
- /seasonМетод
- seasons
from kinopoisk_dev import KinopoiskDev, Field, SeasonParams
kp = KinopoiskDev(token=TOKEN)
seasons = kp.seasons(params=[
SeasonParams(field=Field.MOVIE_ID, search="1316601"),
SeasonParams(field="movieId", search="4407805"),
SeasonParams(field=Field.MOVIE_ID, search="4476467"),
SeasonParams(field=Field.MOVIE_ID, search="4489470"),
SeasonParams(field=Field.MOVIE_ID, search="4670531"),
SeasonParams(field=Field.MOVIE_ID, search="571335"),
], limit=1000, page=1, )
Модели параметров
MovieParams
Имеет следующие поля
Поля | Тип данных | Описание |
---|---|---|
field | str/Field | Поле по которому происходит поиск |
search | str | Данные по которым происходит поиск |
sortField | str | По какому полю происходит сортировка |
sortType | int | В каком порядке выводить(1-1) |
Заготовленные поля
Field
Поля | Значение | Описание |
---|---|---|
KP | id | Поиск по id kinopoisk |
IMDB | externalId.imdb | Поиск по id imdb |
TMDB | externalId.tmdb | Поиск по id tmdb |
TYPE | type | Поиск по типу |
NAME | name | Поиск по имени |
YEAR | year | Поиск по году |
TYPE_NUMBER | typeNumber | Поиск по typeNumber |
MOVIE_ID | movieId | Поиск по movieId |
LANGUAGE | language | Поиск по языку |
STATUS | status | Поиск по статусу |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for kinopoisk_dev-0.1.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | af3a2a96874670643ecf7674f27023e770fcf735dac3e1337731e8f89f31bb31 |
|
MD5 | f134206a4becadbbdcddfa1ffc9ca055 |
|
BLAKE2b-256 | e541e6343382395f4c3b14a5196c29660b5ae292e0bae1c29c8f4075f9cf1567 |