IMDbOT API

⭐ Beginner's Pick Video / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)

Overview

IMDbOT is an unofficial, free REST API that provides movie and TV series information sourced from IMDb data — no API key required. You can retrieve titles, ratings, cast, posters, and plot summaries with a simple GET request using an IMDb ID or a search query. It is great for quickly building movie lookup tools or practising API integration without registration.

💡

Beginner Tip

IMDb IDs always start with "tt" followed by digits (e.g. tt0111161 for The Shawshank Redemption); use these IDs in the /id endpoint for exact lookups instead of relying on search.

Available Data

movie title and year
director and cast
plot summary
IMDb rating
poster image URL
genre and runtime

Example Response

JSON Response
{
  "Title": "Inception",
  "Year": "2010",
  "Rated": "PG-13",
  "Runtime": "148 min",
  "Genre": "Action, Adventure, Sci-Fi",
  "Director": "Christopher Nolan",
  "Actors": "Leonardo DiCaprio, Joseph Gordon-Levitt",
  "Plot": "A thief who steals corporate secrets through dream-sharing technology...",
  "imdbRating": "8.8",
  "Poster": "https://example.com/inception.jpg"
}

Field Reference

#TITLE Title of the movie or TV series
#YEAR Release year of the title
#IMDB_ID Unique IMDb identifier starting with tt
#IMDB_URL Direct link to the title page on imdb.com
#IMG_POSTER URL to the official movie or series poster image
AKA List of alternative titles or translations for the title

Implementation Example

const url = "https://github.com/SpEcHiDe/IMDbOT";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Connection refused or timeout The unofficial API host may be temporarily down or rate-limiting your IP
Wait a few minutes and retry; check the GitHub repo for uptime status or alternative hosted instances
null fields in response Some IMDb pages lack structured data for certain fields like boxOffice or awards
Always check if a field is null before using it in your app to avoid null reference errors
404 Not Found The IMDb ID provided does not match any known title in the dataset
Verify the ID on imdb.com first and ensure you include the full tt prefix (e.g. tt0111161)

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 78ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Video
Difficulty Beginner
Verified: 2026-04-07

Similar APIs

View All →