minimusdocs
Help center

TV shows

Search TMDB for a TV show

GET/tv/series/tmdb/search/

read Read: looks, changes nothing. Scopes

TV shows on TMDB whose title matches query (and year, if given), best first. Answers 400 with configured: false when no TMDB key is set (Settings → VOD).

Query parameters

  • querystringrequired

    The title to look for.

  • yearinteger

    Only titles of this year.

Response

200 OK

  • configuredbooleanrequired

    Always true here: a TMDB key is set.

  • resultsobject[]required
    • tmdb_idstringrequired
    • namestringrequired
    • original_namestringrequired
    • yearstringrequired

      Empty when TMDB has no date.

    • plotstringrequired
    • poster_urlstringrequiredcan be null
    • backdrop_urlstringrequiredcan be null
    • ratingnumberrequired

Errors

  • 400 No query, no TMDB key set, or TMDB did not answer.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means