IMDb Top-Rated Movies by Year API
Live, read-only rankings of IMDb feature films for a release year. Results use IMDb's anonymous advancedTitleSearch GraphQL response, filtered to movies and sorted locally by rating descending then vote count descending.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the IMDb Top-Rated Movies by Year API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/c725653c-d829-4e02-a4d9-889b899ce4e1/api/movies/top-by-year' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY" \
--data-urlencode 'year=1994'Endpoints
Inputs and response fields for every endpoint in this API.
GETMovies top by year/api/movies/top-by-year
Fetches live IMDb data. `offset` is zero-based; alternatively, `page` is one-based. The fixed source title type is movie (IMDb feature films). Empty years return an empty list.
Input
yearRequiredQuery · integerRelease year from 1900 through the current year
Example: 1994
min_votesOptionalQuery · integer, default: 25000Minimum IMDb vote count
Example: 25000
limitOptionalQuery · integer, default: 50Number of movies to return, maximum 250
Example: 50
offsetOptionalQuery · integer, default: 0Zero-based result offset
Example: 0
pageOptionalQuery · integer | nullOptional one-based page number; use instead of offset
Example: 1
Response
pageintegeryearintegeritemsobject[]items[].urlstringitems[].rankintegeritems[].yearintegeritems[].titlestringitems[].ratingnumberitems[].imdb_idstringitems[].vote_countintegerlimitintegertotalinteger | nulloffsetintegermin_votesintegerretrieved_atstring (date-time)Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.