v2

latestOpenAPI 3.0.3Proprietary2026-07-26232599.0 KB
Search

Search for titles and people

Search for titles or people using an external ID (IMDB, TMDB) or by name. Returns matching titles and people with their Watchmode IDs. Useful for getting Watchmode IDs to use with other endpoints.

get/search

Query parameters

search_field'name' | 'imdb_id' | 'tmdb_movie_id' | 'tmdb_tv_id' | 'tmdb_person_id' required

The field to search in:

  • name - Search by title or person name
  • imdb_id - Search by IMDB ID (e.g., tt0944947)
  • tmdb_movie_id - Search by TMDB movie ID
  • tmdb_tv_id - Search by TMDB TV show ID
  • tmdb_person_id - Search by TMDB person ID
search_valuestring required
Example:Breaking Bad

The value to search for (e.g., "Breaking Bad", "tt0944947")

typesstring
Example:tv,movie

Filter results by type. Pass comma-separated values (e.g., tv,movie,person)

Response

Search results

Example response

{
  "title_results": [
    {
      "id": 3173903,
      "name": "Breaking Bad",
      "type": "tv_series",
      "year": 2008,
      "imdb_id": "tt0903747",
      "tmdb_id": 1396,
      "tmdb_type": "tv"
    }
  ],
  "people_results": [
    {
      "id": 710125611,
      "name": "Bryan Cranston",
      "main_profession": "actor",
      "imdb_id": "nm0186505",
      "tmdb_id": 17419
    }
  ]
}