Live

list_top_rated_by_year

filmaffinity.com

Returns FilmAffinity top-rated titles for a specific release year from https://filmaffinity.com, ordered by rating with rank, votes, credits, country, type, and poster data.

Entertainment Social Media

Parameters2

Runs6

Updated3d ago

Operational6 runs · 100% succeeded

30 days ago90 days agoranfailednot checkedtoday

Playground

GETlist_top_rated_by_year GETsearch_movies_advanced GETget_filmography_by_name GETsearch_titles GETget_top_rated_movies GETlist_user_reviews GETget_movie_rating_distribution GETget_movie_details GETlist_weekly_box_office GETget_full_credits GETlist_us_releases

Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.

Parameters

yearint= 2024

offsetint= 0

Need another parameter? Ask the agent →

Waiting on your first callSet the parameters on the left and test it — the real response shows up right here.

What is list_top_rated_by_year?

Returns FilmAffinity top-rated titles for a specific release year from https://filmaffinity.com, ordered by rating with rank, votes, credits, country, type, and poster data. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass year, offset and get the result back without maintaining a scraper.

Response

{
  "year": 0,
  "count": 0,
  "order": "<string>",
  "offset": 0,
  "results": [
    {}
  ],
  "has_more": true,
  "next_offset": 0,
  "total_count": 0
}

Call it

curl --location 'https://us-prod.notte.cc/functions/e65ffae5-d454-4b25-987f-6f6ed6e926a3/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "e65ffae5-d454-4b25-987f-6f6ed6e926a3",
    "variables": {
        "year": 2024,
        "offset": 0
    }
}'

Ask an agent

Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.

prompt

Use the Anything API MCP server (https://anything.notte.cc/mcp).

Call run(function_id="e65ffae5-d454-4b25-987f-6f6ed6e926a3") — the "list_top_rated_by_year" function, which returns FilmAffinity top-rated titles for a specific release year from https://filmaffinity.com, ordered by rating with rank, votes, credits, country, type, and poster data..

It takes year (int), offset (int). Return the result as structured JSON.