Trakt['search']

class trakt.interfaces.search.SearchInterface(client)

lookup(id, service=None, media=None, extended=None, page=None, per_page=None, **kwargs)

Lookup items by their Trakt, IMDB, TMDB, TVDB, or TVRage ID.

Note: If you lookup an identifier without a media type specified it might return multiple items if the service is not globally unique.

Parameters:

• id (str or int) – Identifier value to lookup
• service (str) –

  Identifier service

  Possible values:

  • trakt
  • imdb
  • tmdb
  • tvdb
  • tvrage

• media (str or list of str) –

  Desired media type (or None to return all matching items)

  Possible values:

  • movie
  • show
  • episode
  • person
  • list

• extended (str) –

  Level of information to include in response

  Possible values:

  • None: Minimal (e.g. title, year, ids) (default)
  • full: Complete

• kwargs (dict) – Extra request options

Returns:

Results

Return type:

list of trakt.objects.media.Media

query(query, media=None, year=None, fields=None, extended=None, page=None, per_page=None, **kwargs)

Search by titles, descriptions, translated titles, aliases, and people.

Note: Results are ordered by the most relevant score.

Parameters:

• query (str) – Search title or description
• media (str or list of str) –

  Desired media type (or None to return all matching items)

  Possible values:

  • movie
  • show
  • episode
  • person
  • list

• year (str or int) – Desired media year (or None to return all matching items)
• fields (str or list) – Fields to search for query (or None to search all fields)
• extended (str) –

  Level of information to include in response

  Possible values:

  • None: Minimal (e.g. title, year, ids) (default)
  • full: Complete

• kwargs (dict) – Extra request options

Returns:

Results

Return type:

list of trakt.objects.media.Media