---
title: "Search for titles and people"
method: GET
path: "/search"
tags: ["Search"]
---

# Search for titles and people

`GET /search`

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.

## Query parameters

- `search_field` 'name' | 'imdb_id' | 'tmdb_movie_id' | 'tmdb_tv_id' | 'tmdb_person_id', required
- `search_value` string, required
- `types` string

## Response `200`

Search results

- SearchResponse
  - `title_results` TitleSearchResult[]
    - `id` integer — Watchmode title ID
    - `name` string — Title name
    - `type` 'movie' | 'tv_series' | 'tv_special' | 'tv_miniseries' | 'short_film' | 'tv_movie'
    - `year` integer — Release year
    - `imdb_id` string, nullable — IMDB ID
    - `tmdb_id` integer, nullable — TMDB ID
    - `tmdb_type` 'movie' | 'tv', nullable — TMDB type
  - `people_results` PersonSearchResult[]
    - `id` integer — Watchmode person ID
    - `name` string — Person name
    - `main_profession` string, nullable — Primary profession
    - `imdb_id` string, nullable — IMDB person ID
    - `tmdb_id` integer, nullable — TMDB person ID

## Other responses

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

---

[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)