Sign in

v2

latestOpenAPI 3.0.3Proprietary2026-07-26232599.0 KB
Title

Get title episodes

Get episodes for a TV series or mini-series, including streaming sources for each episode. For paid plans, includes deep links to watch each episode on streaming services. Use season and episode for granular retrieval, or limit and offset to page through large series. Episode localization is opt-in with episode_language; unavailable fields fall back to English.

get/title/{title_id}/episodes

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

regionsstring
Example:US,CA

Filter episode sources by region (2-letter country code). Comma-separated for multiple. Requested regions must be enabled for your plan. If omitted, returns sources from regions enabled for your plan.

seasoninteger

Return episodes from this displayed season number only.

episodeinteger

Return this episode number within season. Requires season.

episode_idinteger

Return the episode with this Watchmode episode ID. For a single-object response, use /title/{title_id}/episodes/{episode_id}.

episode_languagestring
Example:nl

Preferred BCP-47 language for episode names and overviews. Localized fields fall back to English when unavailable. Existing requests remain English by default.

include_sourcesboolean

Set to false when streaming sources are not needed. This reduces response size and retrieval time.

limitinteger

Maximum number of episode rows to return.

offsetinteger

Number of episode rows to skip. Requires limit.

Response

List of episodes with sources

idinteger
namestring
episode_numberinteger
season_numberinteger
season_idinteger nullable
tmdb_idinteger nullable
imdb_idstring nullable
thumbnail_urlstring uri nullable

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

release_datestring date nullable
runtime_minutesinteger nullable
overviewstring nullable

Example response

[
  {
    "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"
      }
    ]
  }
]