Sign in

v2

latestOpenAPI 3.0.3Proprietary2026-07-26232599.0 KB
Releases

Get Title Release Dates - Advanced

Get streaming and theatrical release dates for titles within a specified date range. Includes both historical and upcoming releases, as well as streaming premieres and theatrical releases.

Release dates are returned as normalized calendar dates in YYYY-MM-DD format. When an upstream source provides a midnight UTC availability timestamp that is stored in a US time zone, Watchmode normalizes it back to the intended UTC calendar date before filtering and returning results.

By default, this endpoint returns all region-specific release rows available to Watchmode. Use the regions parameter to filter results to specific countries. Some legacy streaming release-date sources are US-only; those rows are returned with region: "US".

Note: This endpoint requires a paid plan.

get/title-release-dates

Query parameters

start_dateinteger
Example:20240101

Filter releases on or after this normalized calendar date. Format: YYYYMMDD or YYYYMMDDHHMMSS

end_dateinteger
Example:20240131

Filter releases on or before this normalized calendar date. Format: YYYYMMDD or YYYYMMDDHHMMSS

regionsstring
Example:US,GB

Filter by region(s). Pass a single 2-character region code or multiple comma-separated codes (e.g., "US" or "US,GB,CA"). Use the /regions endpoint to get a list of valid region codes. If not provided, returns releases from all regions.

Response

List of upcoming release dates

idinteger
titlestring
title_type'movie' | 'tv_series' | 'tv_special' | 'tv_miniseries' | 'short_film' | 'tv_movie'
original_languagestring nullable

Original language code for the matched Watchmode title when available.

regionstring
type'streaming_movie_release' | 'streaming_tv_season_release' | 'theatrical_release'
release_datestring date
provider_idinteger nullable

Streaming provider ID (null for theatrical)

seasoninteger nullable

Season number (for TV releases)

Example response

[
  {
    "id": 1234567,
    "title": "Dune: Part Two",
    "title_type": "movie",
    "original_language": "en",
    "region": "US",
    "type": "theatrical_release",
    "release_date": "2024-03-01"
  }
]