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

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

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →