Watchmode API

⭐ Beginner's Pick Video / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

Watchmode is an API that lets you check where movies and TV shows are currently available for streaming. You can look up content by title and get a list of streaming platforms like Netflix, Hulu, or Amazon Prime where it can be watched. It is perfect for building a streaming availability tracker or a content discovery app.

💡

Beginner Tip

Start by searching for a title using the /search endpoint and grab the returned titleId, then pass it to the /title/{id}/sources endpoint to get streaming availability. Register for a free API key on the Watchmode website to get started immediately.

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

id Unique identifier for the title in the Watchmode database.
name The title name of the movie or TV show.
type Whether the entry is a movie or a TV series.
sources List of streaming services where the title is currently available.
source_id Numeric identifier for a specific streaming service provider.
region Country code indicating the region for which streaming availability applies.

Implementation Example

const url = "https://api.watchmode.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
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

401 Unauthorized Missing or invalid API key in the request.
Make sure you pass your API key as the apiKey query parameter in every request.
404 Not Found The title ID does not exist in the Watchmode database.
Use the /search endpoint first to get a valid titleId before querying sources or details.
429 Too Many Requests You have exceeded your monthly request quota on the free tier.
Slow down your requests, cache results locally, or upgrade to a paid plan for higher limits.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Video
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →