GET /search — tvdb-api-v4

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

get/search

Query parameters

querystring

The primary search string, which can include the main title for a record including all translations and aliases.

qstring

Alias of the "query" parameter. Recommend using query instead as this field will eventually be deprecated.

typestring

Restrict results to a specific entity type. Can be movie, series, person, or company.

yearnumber

Restrict results to a specific year. Currently only used for series and movies.

companystring

Restrict results to a specific company (original network, production company, studio, etc). As an example, "The Walking Dead" would have companies of "AMC", "AMC+", and "Disney+".

countrystring

Restrict results to a specific country of origin. Should contain a 3 character country code. Currently only used for series and movies.

directorstring

Restrict results to a specific director. Generally only used for movies. Should include the full name of the director, such as "Steven Spielberg".

languagestring

Restrict results to a specific primary language. Should include the 3 character language code. Currently only used for series and movies.

primaryTypestring

Restrict results to a specific type of company. Should include the full name of the type of company, such as "Production Company". Only used for companies.

networkstring

Restrict results to a specific network. Used for TV and TV movies, and functions the same as the company parameter with more specificity.

remote_idstring

Search for a specific remote id. Allows searching for an IMDB or EIDR id, for example.

offsetnumber

Offset results.

limitnumber

Limit results.

Response

response

statusstring

Example response

{
  "data": [
    {
      "overviews": {
        "ara": "تدور قصة المسلسل حول...",
        "ces": "Během letu č. 815 společnosti Oceanic...",
        "deu": "Im Bruchteil einer Sekunde gerät das Leben..."
      },
      "translations": {
        "ara": "تدور قصة المسلسل حول...",
        "ces": "Během letu č. 815 společnosti Oceanic...",
        "deu": "Im Bruchteil einer Sekunde gerät das Leben..."
      }
    }
  ]
}

Changes

Changed in 5 of the 50 revisions of this API.613

Jul 17, 20265d7caa274c722See the full diff
- ▲
  the response property links/prev became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property links/self became nullable for the status 200
  response-property-became-nullable
Feb 8, 20248cb67a07c1342See the full diff
- ▲
  the data/items/overviews response's property type/format changed from array/ to object/ for status 200
  response-property-type-changed
- ▲
  the data/items/translations response's property type/format changed from array/ to object/ for status 200
  response-property-type-changed
Aug 30, 20228d7e53c3d0231See the full diff
- ○
  added the non-success response with the status 400
  response-non-success-status-added
Aug 30, 2022eed7dd057e571See the full diff
- ○
  added the optional property links to the response with the 200 status
  response-optional-property-added
May 12, 2022e01e84a26def211See the full diff
- ▲
  the data/items/overviews response's property type/format changed from object/ to array/ for status 200
  response-property-type-changed
- ▲
  the data/items/translations response's property type/format changed from object/ to array/ for status 200
  response-property-type-changed
- ●
  removed the optional property links from the response with the 200 status
  response-optional-property-removed
- ○
  removed the non-success response with the status 400
  response-non-success-status-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history