Catalog / IMDb Top-Rated Movies by Year

IMDb Top-Rated Movies by Year API

imdb.com

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.

  • Other
  • IMDb
  • movies
  • ratings
  • film
  • research
1 endpointDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

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.

Release year from 1900 through the current year

Optional parameters 4

Minimum IMDb vote count

Number of movies to return, maximum 250

Zero-based result offset

Optional one-based page number; use instead of offset

View call pricing
cURL · Movies top by year
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 · integer

Release year from 1900 through the current year

Example: 1994

min_votesOptionalQuery · integer, default: 25000

Minimum IMDb vote count

Example: 25000

limitOptionalQuery · integer, default: 50

Number of movies to return, maximum 250

Example: 50

offsetOptionalQuery · integer, default: 0

Zero-based result offset

Example: 0

pageOptionalQuery · integer | null

Optional one-based page number; use instead of offset

Example: 1

Response

pageinteger
yearinteger
itemsobject[]
items[].urlstring
items[].rankinteger
items[].yearinteger
items[].titlestring
items[].ratingnumber
items[].imdb_idstring
items[].vote_countinteger
limitinteger
totalinteger | null
offsetinteger
min_votesinteger
retrieved_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.