IMDB Top Movies and TV Shows API

IMDB Top Movies and TV Shows API

Access IMDb’s most comprehensive ranking data through our powerful API! Get instant access to top-rated movies, TV shows, and even the lowest-rated titles for complete entertainment insights.

🌟 Key Features

  • Top 100 Movies Access: Instantly fetch IMDb’s highest-rated films
  • Top 100 TV Shows: Access the most popular television content
  • Combined Rankings: Get unified access to top movies and TV shows
  • Unique “Worst Rated” Access: Explore lowest-rated titles for complete analysis
  • Smart Filtering: Easy title search and pagination for all endpoints
  • Random Selection: Get random titles from any category for dynamic content

📚 API Endpoints

Top Movies

  • GET /v1/imdb/top/movies: Access IMDb’s top 100 movies list
  • GET /v1/imdb/top/movies/random: Get a random top-rated movie

Top TV Shows

  • GET /v1/imdb/top/tv-shows: Access IMDb’s top 100 TV shows
  • GET /v1/imdb/top/tv-shows/random: Get a random top-rated show

Combined Rankings

  • GET /v1/imdb/top/titles: Get combined top movies and TV shows
  • GET /v1/imdb/top/titles/random: Get a random top-rated title

Worst Rated

  • GET /v1/imdb/worst/titles: Access lowest-rated titles
  • GET /v1/imdb/worst/titles/random: Get a random lowest-rated title

📊 Response Data

Each title includes essential IMDb metadata:

  • id: Unique IMDb identifier
  • title: Name of the movie or show
  • type: Content category
  • genres: Array of genres
  • averageRating: IMDb rating
  • numVotes: Number of votes received
  • releaseYear: Year of release

🔍 Query Parameters

All list endpoints support:

  • name: Filter results by title name
  • page: Pagination (default: 1)

⚡ Status Codes

  • 200: Successful request
  • 400: Bad Request
  • 401: Unauthorized
  • 403: Forbidden
  • 404: Not Found
  • 500: Internal Server Error

💡 Perfect For

  • Movie review platforms
  • Entertainment websites
  • Content recommendation systems
  • Film analysis tools
  • TV show tracking apps
  • Movie criticism platforms
  • Entertainment data analytics
  • Content curation services