---
title: "Autocomplete search"
method: GET
path: "/autocomplete-search"
tags: ["Search"]
---

# Autocomplete search

`GET /autocomplete-search`

Search for titles and/or people by name or partial name.
Optimized for building autocomplete/typeahead search interfaces.
Results include relevance scores and thumbnail images.

## Query parameters

- `search_value` string, required
- `search_type` 1 | 2 | 3 | 4 | 5

## Response `200`

Autocomplete results

- AutocompleteResponse
  - `results` AutocompleteResult[]
    - `name` string — Title or person name
    - `relevance` number — Relevance score
    - `type` string — Title type (for titles)
    - `id` integer — Watchmode ID
    - `year` integer, nullable — Release year (for titles)
    - `result_type` 'title' | 'person' — Whether result is a title or person
    - `imdb_id` string, nullable
    - `tmdb_id` integer, nullable
    - `tmdb_type` 'movie' | 'tv', nullable
    - `image_url` string, uri, nullable — Poster (titles) or headshot (people). May point to a third-party host. Watchmode does not grant any license to the underlying image.

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