get_top_rated_movies
filmaffinity.comRetrieves paginated top-rated movie rankings from https://filmaffinity.com. Supports genre, country, year-range, streaming-platform, and offset filters and returns rank, rating, votes, cast, director, and film metadata.
Playground
Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.
What is get_top_rated_movies?
Retrieves paginated top-rated movie rankings from https://filmaffinity.com. Supports genre, country, year-range, streaming-platform, and offset filters and returns rank, rating, votes, cast, director, and film metadata. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass genre, country, from_year, to_year, platform, offset and get the result back without maintaining a scraper.
Response
{
"count": 0,
"offset": 0,
"results": [
{
"cast": [
"<string>"
],
"rank": 0,
"year": 0,
"title": "<string>",
"votes": 0,
"rating": 0,
"country": "<string>",
"film_id": "<string>",
"director": [
"<string>"
],
"movie_url": "<string>",
"poster_url": "<string>",
"country_code": "<string>"
}
],
"has_more": true,
"next_offset": 0
}Call it
curl --location 'https://us-prod.notte.cc/functions/eb453594-5be7-4db7-a6ea-7a2922e8e58a/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"function_id": "eb453594-5be7-4db7-a6ea-7a2922e8e58a",
"variables": {
"genre": "",
"country": "",
"from_year": 1874,
"to_year": 2026,
"platform": "",
"offset": 0
}
}'Ask an agent
Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.
Use the Anything API MCP server (https://anything.notte.cc/mcp). Call run(function_id="eb453594-5be7-4db7-a6ea-7a2922e8e58a") — the "get_top_rated_movies" function, which retrieves paginated top-rated movie rankings from https://filmaffinity.com. Supports genre, country, year-range, streaming-platform, and offset filters and returns rank, rating, votes, cast, director, and film metadata.. It takes genre (str), country (str), from_year (int), to_year (int), platform (str), offset (int). Return the result as structured JSON.