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

# GET /search

`GET /search`

Our search index includes series, movies, people, and companies. Search is limited to 5k results max.

## Query parameters

- `query` string
- `q` string
- `type` string
- `year` number
- `company` string
- `country` string
- `director` string
- `language` string
- `primaryType` string
- `network` string
- `remote_id` string
- `offset` number
- `limit` number

## Response `200`

response

- object
  - `data` SearchResult[]
    - `aliases` string[]
    - `companies` string[]
    - `companyType` string
    - `country` string
    - `director` string
    - `first_air_time` string
    - `genres` string[]
    - `id` string
    - `image_url` string
    - `name` string
    - `is_official` boolean
    - `name_translated` string
    - `network` string
    - `objectID` string
    - `officialList` string
    - `overview` string
    - `overviews` TranslationSimple — translation simple record
    - `overview_translated` string[]
    - `poster` string
    - `posters` string[]
    - `primary_language` string
    - `remote_ids` RemoteID[]
      - `id` string
      - `type` integer
      - `sourceName` string
    - `status` string
    - `slug` string
    - `studios` string[]
    - `title` string
    - `thumbnail` string
    - `translations` TranslationSimple — translation simple record
    - `translationsWithLang` string[]
    - `tvdb_id` string
    - `type` string
    - `year` string
  - `status` string
  - `links` Links — Links for next, previous and current record
    - `prev` string, nullable
    - `self` string, nullable
    - `next` string
    - `total_items` integer
    - `page_size` integer

## Other responses

- `400` — Max results overflow
- `401` — Unauthorized

## Changes

- **2026-07-17** `5d7caa274c72` — 2 breaking
  - the response property `links/prev` became nullable for the status `200`
  - the response property `links/self` became nullable for the status `200`
- **2024-02-08** `8cb67a07c134` — 2 breaking
  - the `data/items/overviews` response's property type/format changed from `array`/`` to `object`/`` for status `200`
  - the `data/items/translations` response's property type/format changed from `array`/`` to `object`/`` for status `200`
- **2022-08-30** `8d7e53c3d023` — 1 info
  - added the non-success response with the status `400`
- **2022-08-30** `eed7dd057e57` — 1 info
  - added the optional property `links` to the response with the `200` status
- **2022-05-12** `e01e84a26def` — 2 breaking, 1 warning, 1 info
  - the `data/items/overviews` response's property type/format changed from `object`/`` to `array`/`` for status `200`
  - the `data/items/translations` response's property type/format changed from `object`/`` to `array`/`` for status `200`
  - removed the optional property `links` from the response with the `200` status
  - removed the non-success response with the status `400`

[Change history](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/changes/search/get.md)

---

[API](https://skmtc.dev/thetvdb/apis/tvdb-api-v4.md) · [All operations](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thetvdb/tvdb-api-v4/revisions/5d7caa274c72/schema)