Python-модуль для взаимодействия с неофициальным API КиноПоиска
pip install kinopoisk-dev
poetry add kinopoisk-dev
Для получения токена необходимо перейти kinopoisk.dev и написать по контактам.
Получить рандомный тайтл из базы
- Endpoint -
/v1/movie/random
- Примеры
import asyncio
from kinopoisk_dev import KinopoiskDev
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.arandom())
from kinopoisk_dev import KinopoiskDev
kp = KinopoiskDev(token=TOKEN)
item = kp.random()
Получить все возможные значения полей
- Endpoint -
/v1/movie/possible-values-by-field
- Примеры
import asyncio
from kinopoisk_dev import KinopoiskDev, PossValField
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.apossible_values_by_field(params=PossValField.GENRES))
from kinopoisk_dev import KinopoiskDev, PossValField
kp = KinopoiskDev(token=TOKEN)
item = kp.possible_values_by_field(params=PossValField.GENRES)
Поиск тайтлов
- Ендпоинт -
/v1/movie/
- Примеры
import asyncio
from kinopoisk_dev import KinopoiskDev, MovieParams, MovieField
kp = KinopoiskDev(token=TOKEN)
items = asyncio.run(kp.afind_many_movies(params=[
MovieParams(keys=MovieField.name, value="Аватар"),
MovieParams(keys=MovieField.page, value="1"),
MovieParams(keys=MovieField.limit, value="1000")
]))
from kinopoisk_dev import KinopoiskDev, MovieParams, MovieField
kp = KinopoiskDev(token=TOKEN)
items = kp.find_many_movies(params=[
MovieParams(keys=MovieField.name, value="Аватар"),
MovieParams(keys=MovieField.page, value="1"),
MovieParams(keys=MovieField.limit, value="1000")
])
Поиск по id
- Ендпоинт -
/v1/movie/{id}
- Примеры
import asyncio
from kinopoisk_dev import KinopoiskDev
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.afind_one_movie(666))
from kinopoisk_dev import KinopoiskDev
kp = KinopoiskDev(token=TOKEN)
item = kp.find_one_movie(666)
- Ендпоинт -
/v1/season
- Пример
import asyncio
from kinopoisk_dev import KinopoiskDev, SeasonParams, SeasonField
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.aseasons(params=[
SeasonParams(keys=SeasonField.PAGE, value=1),
SeasonParams(keys=SeasonField.LIMIT, value=100)
]))
from kinopoisk_dev import KinopoiskDev, SeasonParams, SeasonField
kp = KinopoiskDev(token=TOKEN)
item = kp.seasons(params=[
SeasonParams(keys=SeasonField.PAGE, value=1),
SeasonParams(keys=SeasonField.LIMIT, value=100)
])
- Ендпоинт -
/v1/review
- Пример
import asyncio
from kinopoisk_dev import KinopoiskDev, ReviewParams, ReviewField
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.areview(params=[
ReviewParams(keys=ReviewField.PAGE, value=1),
ReviewParams(keys=ReviewField.LIMIT, value=100)
]))
from kinopoisk_dev import KinopoiskDev, ReviewParams, ReviewField
kp = KinopoiskDev(token=TOKEN)
item = kp.review(params=[
ReviewParams(keys=ReviewField.PAGE, value=1),
ReviewParams(keys=ReviewField.LIMIT, value=100)
])
- Ендпоинт -
/v1/person
- Пример
import asyncio
from kinopoisk_dev import KinopoiskDev, PersonParams, PersonField
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.afind_many_person(params=[
PersonParams(keys=PersonField.PAGE, value=1),
PersonParams(keys=PersonField.LIMIT, value=100)
]))
from kinopoisk_dev import KinopoiskDev, PersonParams, PersonField
kp = KinopoiskDev(token=TOKEN)
item = kp.find_many_person(params=[
PersonParams(keys=PersonField.PAGE, value=1),
PersonParams(keys=PersonField.LIMIT, value=100)
])
- Ендпоинт -
/v1/person/{id}
- Пример
import asyncio
from kinopoisk_dev import KinopoiskDev
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.afind_one_person(24262))
from kinopoisk_dev import KinopoiskDev
kp = KinopoiskDev(token=TOKEN)
item = kp.find_one_person(24262)
- Ендпоинт -
/v1/image
- Пример
import asyncio
from kinopoisk_dev import KinopoiskDev, ImageParams, ImageField
kp = KinopoiskDev(token=TOKEN)
item = asyncio.run(kp.aimage(params=[
ImageParams(keys=ImageField.PAGE, value=1),
ImageParams(keys=ImageField.LIMIT, value=100)
]))
from kinopoisk_dev import KinopoiskDev, ImageParams, ImageField
kp = KinopoiskDev(token=TOKEN)
item = kp.image(params=[
ImageParams(keys=ImageField.PAGE, value=1),
ImageParams(keys=ImageField.LIMIT, value=100)
])