Вернет случайный фильм с учетом фильтров по году и жанрам

get_random_movie.py

import requests
import random

headers = {"X-API-KEY": "Your token ..."}

def get_random_movie(genres, year_range):
    response = requests.get(
        'https://api.kinopoisk.dev/v1.4/movie',
        params={
            "genres.name": genres,
            "limit": 1,
            "page": 1,
            "year": year_range
        },
        headers=headers
    )
    movies = response.json()
    total_pages = movies["total"] // movies["limit"] + (1 if movies["total"] % movies["limit"] > 0 else 0)

    random_page = random.randint(1, total_pages)

    response = requests.get(
        'https://api.kinopoisk.dev/v1/movie',
        params={
            "genres.name": genres,
            "limit": 1,
            "page": random_page,
            "year": year_range
        },
        headers=headers
    )
    movies = response.json()
    return movies["docs"][0]

# year_range = "2023"
year_range = "2020-2023"

# genres = ["боевик", "драма"]
# или чтобы исключить жанр
# genres = ["!боевик"]
genres = ["боевик"]
movie = get_random_movie(genres, year_range)
print(movie)