POST /api/kinopoisk/films/discover
Price: 10 credits
Browse Kinopoisk movies or TV series with filters: genre, country, year, ordering. Returns a ranked list of titles with ratings, genres and countries.
Discover Kinopoisk titles by faceted filters instead of a keyword. Filter by genre, country, year and whether to browse series; order by votes or rating. Each result has id, type, url, name, original_name, year, duration, rating, rating_count, genres, countries and image. Set count to control how many results to return.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)genre string nullable — Filter by genre (one of: "Аниме", "Биографии", "Боевики", "Вестерны", "Военные", "Детективы", "Детские", "Документальные", "Драмы", "Игры", "Исторические", "Комедии", "Концерты", "Короткометражки", "Криминал", "Мелодрамы", "Музыкальные", "Мультфильмы", "Мюзиклы", "Новости", "Приключения", "Реальное ТВ", "Семейные", "Спортивные", "Ток-шоу", "Триллеры", "Ужасы", "Фантастика", "Фильмы-нуар", "Фэнтези", "Церемонии")country string nullable — Filter by production country (one of: "Россия", "СССР", "США", "Франция", "Италия", "Испания", "Великобритания", "Германия", "Корея Южная", "Япония", "Австралия", "Австрия", "Азербайджан", "Албания", "Алжир", "Американские Виргинские острова", "Американское Самоа", "Ангола", "Андорра", "Антарктида", "Антигуа и Барбуда", "Антильские Острова", "Аргентина", "Армения", "Аруба", "Афганистан", "Багамы", "Бангладеш", "Барбадос", "Бахрейн", "Беларусь", "Белиз", "Бельгия", "Бенин", "Берег Слоновой кости", "Бермуды", "Бирма", "Болгария", "Боливия", "Босния", "Босния и Герцеговина", "Ботсвана", "Бразилия", "Бруней-Даруссалам", "Буркина-Фасо", "Бурунди", "Бутан", "Вануату", "Ватикан", "Венгрия", "Венесуэла", "Виргинские Острова", "Внешние малые острова США", "Вьетнам", "Вьетнам Северный", "Габон", "Гаити", "Гайана", "Гамбия", "Гана", "Гваделупа", "Гватемала", "Гвинея", "Гвинея-Бисау", "Германия (ГДР)", "Германия (ФРГ)", "Гибралтар", "Гондурас", "Гонконг", "Гренада", "Гренландия", "Греция", "Грузия", "Гуам", "Дания", "Джибути", "Доминика", "Доминикана", "Египет", "Заир", "Замбия", "Западная Сахара", "Зимбабве", "Израиль", "Индия", "Индонезия", "Иордания", "Ирак", "Иран", "Ирландия", "Исландия", "Йемен", "Кабо-Верде", "Казахстан", "Каймановы острова", "Камбоджа", "Камерун", "Канада", "Катар", "Кения", "Кипр", "Кирибати", "Китай", "Колумбия", "Коморы", "Конго", "Конго (ДРК)", "Корея", "Корея Северная", "Косово", "Коста-Рика", "Кот-д’Ивуар", "Куба", "Кувейт", "Кыргызстан", "Лаос", "Латвия", "Лесото", "Либерия", "Ливан", "Ливия", "Литва", "Лихтенштейн", "Люксембург", "Маврикий", "Мавритания", "Мадагаскар", "Макао", "Македония", "Малави", "Малайзия", "Мали", "Мальдивы", "Мальта", "Марокко", "Мартиника", "Маршалловы острова", "Масаи", "Мексика", "Мелкие отдаленные острова США", "Мозамбик", "Молдова", "Монако", "Монголия", "Монтсеррат", "Мьянма", "Намибия", "Непал", "Нигер", "Нигерия", "Нидерланды", "Никарагуа", "Новая Зеландия", "Новая Каледония", "Норвегия", "ОАЭ", "Оккупированная Палестинская территория", "Оман", "Остров Мэн", "Остров Святой Елены", "Острова Кука", "острова Теркс и Кайкос", "Пакистан", "Палау", "Палестина", "Панама", "Папуа - Новая Гвинея", "Парагвай", "Перу", "Польша", "Португалия", "Пуэрто Рико", "Реюньон", "Российская империя", "Руанда", "Румыния", "Сальвадор", "Самоа", "Сан-Марино", "Сан-Томе и Принсипи", "Саудовская Аравия", "Северная Македония", "Сейшельские острова", "Сенегал", "Сент-Винсент и Гренадины", "Сент-Китс и Невис", "Сент-Люсия ", "Сербия", "Сербия и Черногория", "Сиам", "Сингапур", "Сирия", "Словакия", "Словения", "Соломоновы Острова", "Сомали", "Судан", "Суринам", "Сьерра-Леоне", "Таджикистан", "Таиланд", "Тайвань", "Танзания", "Тимор-Лесте", "Того", "Тонга", "Тринидад и Тобаго", "Тувалу", "Тунис", "Туркменистан", "Турция", "Уганда", "Узбекистан", "Украина", "Уоллис и Футуна", "Уругвай", "Фарерские острова", "Федеративные Штаты Микронезии", "Фиджи", "Филиппины", "Финляндия", "Фолклендские острова", "Французская Гвиана", "Французская Полинезия", "Хорватия", "ЦАР", "Чад", "Черногория", "Чехия", "Чехословакия", "Чили", "Швейцария", "Швеция", "Шпицберген и Ян-Майен", "Шри-Ланка", "Эквадор", "Экваториальная Гвинея", "Эритрея", "Эсватини", "Эстония", "Эфиопия", "ЮАР", "Югославия", "Югославия (ФР)", "Ямайка")year integer nullable — Filter by production year (min: 1890; max: 2030)series boolean — Browse TV series instead of movies (default: false)sort string — Result ordering (default: "votes"; one of: "votes", "rating")count integer required — Max number of results to return (min: 1)@type string (default: "KinopoiskListItem")id integer requiredtype string requiredurl string requiredname string nullableoriginal_name string nullableyear integer nullableduration integer nullablerating number nullablerating_count integer nullablegenres array (default: [])countries array (default: [])image string nullable422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.