Перейти к основному содержимому

Поиск медиа

Поиск работает через Kinopoisk API и возвращает унифицированный формат ответа:

{
"success": true,
"data": {
"results": [],
"total": 0,
"pages": 0
}
}

Базовый поиск

GET /api/v1/search?query=матрица

Пример элемента из data.results:

{
"id": "kp_326",
"title": "Матрица",
"originalTitle": "The Matrix",
"year": 1999,
"rating": 8.5,
"posterUrl": "/api/v1/images/kp_small/326",
"genres": [{ "id": "фантастика", "name": "фантастика" }],
"description": "...",
"type": "movie",
"externalIds": { "kp": 326, "tmdb": null, "imdb": "tt0133093" }
}

Пагинация

GET /api/v1/search?query=матрица&page=2

Популярное и топ

# Популярные
GET /api/v1/movies/popular?page=1

# Топ-250
GET /api/v1/movies/top-rated?page=1

Оба эндпоинта возвращают тот же формат SearchResponse в data.

Детали фильма/сериала

GET /api/v1/movie/326
GET /api/v1/movie/kp_326

Ошибки

Пустой или пробельный запрос вернет 400:

GET /api/v1/search?query=
# { "error": "query parameter is required" }