Реализация 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"),
])
Модели параметров
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.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 730f5c21d8e51bea206980fe77b8abe20e84d6566db07a9610db9b504b66c385 |
|
MD5 | eda9c6fa719aac97ee8b0df87a17a001 |
|
BLAKE2b-256 | a6157a8653f5b3f8fd53790d8d43baa3cab1d744df5411989c95d3244d4cbb73 |