Knowledge & Fun

IMDB Top Movies and TV Shows API

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.

Subscribe on RapidAPI

Request Headers

Name	Required	Description
`X-RapidAPI-Key`	required	Your RapidAPI key. Get one free.
`X-RapidAPI-Host`	required	`imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com`

Endpoints

GET /v1/imdb/top/movies

Top Movies

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/movies' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/movies";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/movies"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

GET /v1/imdb/top/movies/random

Top Movies

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/movies/random' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/movies/random";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/movies/random"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

GET /v1/imdb/top/tv-shows

Top TV Shows

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/tv-shows' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/tv-shows";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/tv-shows"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

GET /v1/imdb/top/tv-shows/random

Top TV Shows

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/tv-shows/random' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/tv-shows/random";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/tv-shows/random"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

GET /v1/imdb/top/titles

Combined Rankings

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/titles' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/titles";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/titles"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

GET /v1/imdb/top/titles/random

Combined Rankings

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/titles/random' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/titles/random";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/top/titles/random"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

GET /v1/imdb/worst/titles

Worst Rated

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/worst/titles' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/worst/titles";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/worst/titles"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

GET /v1/imdb/worst/titles/random

Worst Rated

Code Examples

curl --request GET \
  --url 'https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/worst/titles/random' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com'

const url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/worst/titles/random";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com/v1/imdb/worst/titles/random"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "imdb-top-movies-and-tv-shows-api-by-apirobots.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

Interactive Example

imdb-top-movies-and-tv-shows

$ GET /v1/imdb/top/movies
{
  "message": "Success"
}

Integration & Usage Guide

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

Subscribe & License

Access this API with commercial-ready tiers on RapidAPI. Flexible plans designed for side-projects, startups, and high-volume production architectures.

View Pricing & Subscribe

Developer Support

Need help integrating or have a custom endpoint request? Our engineering team is here to assist with authentication, payload schemas, and high-frequency rate limit increases.

Contact API Engineering

System Performance

Monitored 24/7 with a 99.9% uptime SLA. Built atop cloud-native microservices with globally distributed edge caching to ensure ultra-low latency response times.

All Systems Operational