Реализация 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.8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fc79c081afc4b820c7cd86ef837814dff1b578566d8f23189288e33b0ae6c056 |
|
MD5 | 4e4e75c8bebbffe887f04891e789d394 |
|
BLAKE2b-256 | 9f218ec0340e9a505a7b1c761107a79a4ab8777ab9b21be4c8fc5a847f133f0c |