---
title: "List and filter titles"
method: GET
path: "/list-titles"
tags: ["Title"]
---

# List and filter titles

`GET /list-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

## Query parameters

- `types` string
- `regions` string
- `source_types` string
- `source_ids` string
- `genres` string
- `network_ids` string
- `languages` string
- `release_date_start` integer
- `release_date_end` integer
- `user_rating_low` number
- `user_rating_high` number
- `critic_score_low` integer
- `critic_score_high` integer
- `person_id` integer
- `sort_by` 'relevance_desc' | 'relevance_asc' | 'popularity_desc' | 'popularity_asc' | 'release_date_desc' | 'release_date_asc' | 'title_desc' | 'title_asc'
- `page` integer
- `limit` integer

## Response `200`

Paginated list of titles

- ListTitlesResponse
  - `titles` TitleListItem[]
    - `id` integer
    - `title` string
    - `year` integer
    - `imdb_id` string, nullable
    - `tmdb_id` integer, nullable
    - `tmdb_type` 'movie' | 'tv', nullable
    - `type` 'movie' | 'tv_series' | 'tv_special' | 'tv_miniseries' | 'short_film' | 'tv_movie'
    - `popularity_percentile` number, nullable — Normalized popularity percentile (0-100) used by popularity sorting
  - `page` integer — Current page number
  - `total_results` integer — Total matching titles
  - `total_pages` integer — Total pages available

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key

## Changes

> 4 revisions in range; 2 could not be searched.

- **2026-07-26** `9e306e252b81` — 1 info
  - added the optional property `titles/items/popularity_percentile` to the response with the `200` status

[Change history](https://skmtc.dev/watchmode/apis/watchmode-api/changes/list-titles/get.md)

---

[API](https://skmtc.dev/watchmode/apis/watchmode-api.md) · [All operations](https://skmtc.dev/watchmode/apis/watchmode-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/watchmode/watchmode-api/revisions/3215d2b959fa/schema)