Sign in

v2

latestOpenAPI 3.0.3Proprietary2026-07-26232599.0 KB
Title

Get title details

Get detailed information about a specific movie or TV show.

ID Formats Accepted:

  • Watchmode ID (e.g., 345534) - costs 1 credit
  • IMDB ID (e.g., tt0903747) - costs 2 credits
  • TMDB format (e.g., movie-278 or tv-1396) - costs 2 credits

Use append_to_response to include additional data in a single request.

get/title/{title_id}/details

Path parameters

title_idstring required
Example:3173903

Title identifier. Accepts:

  • Watchmode ID (e.g., 345534) - 1 credit
  • IMDB ID (e.g., tt0903747) - 2 credits
  • TMDB format (e.g., movie-278 or tv-1396) - 2 credits

Query parameters

append_to_responsestring
Example:sources,cast-crew

Include additional data. Comma-separated values. Each adds 1 credit.

  • sources - Streaming availability
  • seasons - Season list (TV only)
  • episodes - Episode list with sources (TV only)
  • cast-crew - Cast and crew
languagestring
Example:es

ISO 639-1 language code for localized title/overview (default en)

regionsstring
Example:US,CA

Filter sources by region when using append_to_response=sources or append_to_response=episodes. Comma-separated. Requested regions must be enabled for your plan. If omitted, returns sources from regions enabled for your plan.

Response

Title details

idinteger
titlestring
original_titlestring nullable
plot_overviewstring nullable

Plot overview (AI-enhanced when available)

will_you_like_thisstring nullable

AI-generated "Will you like this?" snippet

review_summarystring nullable

AI-generated summary of reviews

type'movie' | 'tv_series' | 'tv_special' | 'tv_miniseries' | 'short_film' | 'tv_movie'
runtime_minutesinteger nullable
yearinteger
end_yearinteger nullable

For TV series, the year the show ended

release_datestring date nullable
imdb_idstring nullable
tmdb_idinteger nullable
tmdb_type'movie' | 'tv' nullable
genresinteger[] nullable

Array of genre IDs

genre_namesstring[] nullable

Array of genre names

user_ratingnumber nullable

User rating (0-10)

critic_scoreinteger nullable

Critic score (0-100)

us_ratingstring nullable

US content rating

posterstring uri nullable

Poster image URL. May point to a third-party host. Watchmode does not grant any license to the underlying image.

posterMediumstring uri nullable

Medium poster image URL. May point to a third-party host. Watchmode does not grant any license to the underlying image.

posterLargestring uri nullable

Large poster image URL. May point to a third-party host. Watchmode does not grant any license to the underlying image.

backdropstring uri nullable

Backdrop image URL. May point to a third-party host. Watchmode does not grant any license to the underlying image.

original_languagestring nullable

ISO 639-1 language code

similar_titlesinteger[] nullable

Array of similar title IDs

networksinteger[] nullable

Network IDs (for TV)

network_namesstring[] nullable

Network names (for TV)

relevance_percentilenumber nullable

Relevance percentile (0-100)

popularity_percentilenumber nullable

Popularity percentile (0-100)

trailerstring uri nullable

YouTube trailer URL

trailer_thumbnailstring uri nullable

Trailer thumbnail URL

english_titlestring

English title (when language param is not EN)

Example response

{
  "id": 3173903,
  "title": "Breaking Bad",
  "original_title": "Breaking Bad",
  "plot_overview": "When Walter White, a New Mexico chemistry teacher...",
  "type": "tv_series",
  "runtime_minutes": 45,
  "year": 2008,
  "end_year": 2013,
  "release_date": "2008-01-20",
  "imdb_id": "tt0903747",
  "tmdb_id": 1396,
  "tmdb_type": "tv",
  "genres": [
    7
  ],
  "genre_names": [
    "Drama"
  ],
  "user_rating": 9.2,
  "critic_score": 85,
  "us_rating": "TV-MA",
  "poster": "http://www.some-poster-site.com/image.jpg",
  "posterMedium": "http://www.some-poster-site.com/image.jpg",
  "posterLarge": "http://www.some-poster-site.com/image.jpg",
  "backdrop": "http://www.some-poster-site.com/image.jpg",
  "original_language": "en",
  "similar_titles": [
    330884,
    343611
  ],
  "networks": [
    8
  ],
  "network_names": [
    "AMC"
  ],
  "relevance_percentile": 98.92,
  "popularity_percentile": 99.99,
  "trailer": "https://www.youtube.com/watch?v=5PSNL1qE6VY",
  "trailer_thumbnail": "http://www.some-poster-site.com/image.jpg",
  "sources": [
    {
      "source_id": 203,
      "name": "Netflix",
      "type": "sub",
      "region": "US",
      "format": "HD",
      "price": 3.99,
      "seasons": 5,
      "episodes": 62
    }
  ],
  "seasons": [
    {
      "id": 12345,
      "name": "Season 1",
      "number": 1,
      "air_date": "2008-01-20",
      "episode_count": 7
    }
  ],
  "episodes": [
    {
      "id": 1234567,
      "name": "Pilot",
      "episode_number": 1,
      "season_number": 1,
      "season_id": 12345,
      "tmdb_id": 54321,
      "imdb_id": "tt0959621",
      "release_date": "2008-01-20",
      "runtime_minutes": 58,
      "sources": [
        {
          "source_id": 203,
          "name": "Netflix",
          "type": "sub",
          "region": "US"
        }
      ]
    }
  ],
  "cast": [
    {
      "person_id": 7110004,
      "type": "Cast",
      "full_name": "Bryan Cranston",
      "role": "Walter White",
      "episode_count": 62,
      "order": 1
    }
  ]
}