Sign in

v2

latestOpenAPI 3.0.3Proprietary2026-07-26232599.0 KB
Title

List and filter titles

Get a paginated list of titles matching specified criteria. This powerful endpoint allows granular filtering such as "Horror movies streaming on Netflix in the USA".

Quota Notes:

  • Each additional region costs 1 API credit
  • When using source_ids or source_types, only one region is allowed
get/list-titles

Query parameters

typesstring
Example:movie,tv_series

Filter by title type. Comma-separated for multiple values. Valid types: movie, tv_series, tv_movie, tv_special, tv_miniseries, short_film

regionsstring
Example:US

Filter by region (2-letter country code). Comma-separated for multiple.

source_typesstring
Example:sub,free

Filter by source type. Comma-separated values.

  • sub - Subscription
  • rent - Rental
  • buy - Purchase
  • free - Free
  • tve - TV Channel App (Cable Plan Required)
source_idsstring
Example:203,26

Filter by specific source IDs (from /sources endpoint). Comma-separated.

genresstring
Example:4,7

Filter by genre IDs (from /genres endpoint). Comma-separated.

network_idsstring
Example:1,8

Filter by network IDs (from /networks endpoint). Comma-separated.

languagesstring
Example:en,es

Filter by primary language (2-letter ISO 639 code). Comma-separated.

release_date_startinteger
Example:20200101

Filter by release date start (format YYYYMMDD)

release_date_endinteger
Example:20231231

Filter by release date end (format YYYYMMDD)

user_rating_lownumber

Minimum user rating (0-10)

user_rating_highnumber

Maximum user rating (0-10)

critic_score_lowinteger

Minimum critic score (0-100)

critic_score_highinteger

Maximum critic score (0-100)

person_idinteger
Example:7110004

Filter by person ID (actor, director, etc.)

sort_by'relevance_desc' | 'relevance_asc' | 'popularity_desc' | 'popularity_asc' | 'release_date_desc' | 'release_date_asc' | 'title_desc' | 'title_asc'

Sort order for results. Popularity options use Watchmode's normalized popularity percentile.

pageinteger

Page number for pagination

limitinteger

Results per page (1-250)

Response

Paginated list of titles

pageinteger

Current page number

total_resultsinteger

Total matching titles

total_pagesinteger

Total pages available

Example response

{
  "titles": [
    {
      "id": 1337513,
      "title": "Secret in Their Eyes",
      "year": 2015,
      "imdb_id": "tt1741273",
      "tmdb_id": 290751,
      "tmdb_type": "movie",
      "type": "movie",
      "popularity_percentile": 99.421
    }
  ],
  "page": 1,
  "total_results": 4592,
  "total_pages": 19
}