tmdb package

Documentation of API methods. Most of these are a 1:1 mapping to the TMDB API.

To get started you need an api_key from TMDB, please see the TMDB website for such a key.

After you have obtained your api_key you can start querying the API from Python by doing the following simple steps:

import tmdb

api = tmdb.API(api_key)

results = api.search_movie(query="rocky")

# Do things with results here

Notes

  • There are several methods currently in the API marked as a get request while they are actually post requests. These do not work currently.
  • There is currently no caching in the library, it is suggested you do this yourself for now
  • There is currently no throttling of requests, it is suggested you do this yourself for now

List of API methods

class tmdb.API(api_key)

Bases: object

account(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.account(<parameters>)
{u'id': 36,
 u'include_adult': False,
 u'iso_3166_1': u'US',
 u'iso_639_1': u'en',
 u'name': u'John Doe',
 u'username': u'johndoe'}
account_favorite(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • favorite (str) – true | false
  • Required JSON Body (str) –
  • movie_id (int) –
  • id (int) –
  • session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.account_favorite(<parameters>)
{u'status_code': 12,
 u'status_message': u'The item/record was updated successfully'}
account_favorite_movies(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • id (int) –
  • session_id (str) –

Optional

Parameters:
  • sort_order (str) – asc | desc
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
  • sort_by (str) – Only ‘created_at` is currently supported.
Usage:
>>> api = tmdb.API(api_key)
>>> api.account_favorite_movies(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/wrKcSXtHz4LedgEf1aW5e4ZVyHJ.jpg',
               u'id': 9806,
               u'original_title': u'The Incredibles',
               u'poster_path': u'/9k4sgKD79q0MDHSWIqNnHqOfOEV.jpg',
               u'release_date': u'2004-11-05',
               u'title': u'The Incredibles',
               u'vote_average': 8.6,
               u'vote_count': 46},
              {u'backdrop_path': u'/uAVdwu4vEx0TwuC4ewp9RqplKEV.jpg',
               u'id': 1452,
               u'original_title': u'Superman Returns',
               u'poster_path': u'/qpsarVxFcxJxtCK5dAoHLt3365R.jpg',
               u'release_date': u'2006-06-21',
               u'title': u'Superman Returns',
               u'vote_average': 6.6,
               u'vote_count': 20},
              {u'backdrop_path': u'/x9a4Q6Qlgh9Fk1f5z6K4r5OeLd9.jpg',
               u'id': 8960,
               u'original_title': u'Hancock',
               u'poster_path': u'/dsCxSr4w3g2ylhlZg3v5CB5Pid7.jpg',
               u'release_date': u'2008-07-02',
               u'title': u'Hancock',
               u'vote_average': 7.0,
               u'vote_count': 34},
              {u'backdrop_path': u'/oPE44KcuRBKfuE15RD8sC2awh3P.jpg',
               u'id': 9741,
               u'original_title': u'Unbreakable',
               u'poster_path': u'/ndb1jugavBmgcfZKrfHXxC0T6al.jpg',
               u'release_date': u'2000-11-14',
               u'title': u'Unbreakable',
               u'vote_average': 7.8,
               u'vote_count': 25},
              {u'backdrop_path': u'/7u3pxc0K1wx32IleAkLv78MKgrw.jpg',
               u'id': 603,
               u'original_title': u'The Matrix',
               u'poster_path': u'/gynBNzwyaHKtXqlEKKLioNkjKgN.jpg',
               u'release_date': u'1999-03-31',
               u'title': u'The Matrix',
               u'vote_average': 9.1,
               u'vote_count': 249},
              {u'backdrop_path': u'/af98P1bc7lJsFjhHOVWXQgNNgSQ.jpg',
               u'id': 424,
               u'original_title': u"Schindler's List",
               u'poster_path': u'/I2lJ7ens7Rzlm3x5HfDbwF3ykh.jpg',
               u'release_date': u'1993-11-30',
               u'title': u"Schindler's List",
               u'vote_average': 8.7,
               u'vote_count': 41},
              {u'backdrop_path': u'/6kVVfNT0auG6fU5SFQ1zbayNWUC.jpg',
               u'id': 7191,
               u'original_title': u'Cloverfield',
               u'poster_path': u'/as01o40tJ2FhtheqeXf7bVZ0EQO.jpg',
               u'release_date': u'2008-01-16',
               u'title': u'Cloverfield',
               u'vote_average': 7.2,
               u'vote_count': 35},
              {u'backdrop_path': u'/6yFoLNQgFdVbA8TZMdfgVpszOla.jpg',
               u'id': 218,
               u'original_title': u'The Terminator',
               u'poster_path': u'/q8ffBuxQlYOHrvPniLgCbmKK4Lv.jpg',
               u'release_date': u'1984-10-26',
               u'title': u'The Terminator',
               u'vote_average': 8.6,
               u'vote_count': 67},
              {u'backdrop_path': u'/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg',
               u'id': 550,
               u'original_title': u'Fight Club',
               u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
               u'release_date': u'1999-10-15',
               u'title': u'Fight Club',
               u'vote_average': 9.1,
               u'vote_count': 175},
              {u'backdrop_path': u'/siKq2bQo09YGLTiqvKR1pXJ5li9.jpg',
               u'id': 23483,
               u'original_title': u'Kick-Ass',
               u'poster_path': u'/gtfggr5n3ED1neoTqVYmsVCoSS.jpg',
               u'release_date': u'2010-04-16',
               u'title': u'Kick-Ass',
               u'vote_average': 8.3,
               u'vote_count': 108},
              {u'backdrop_path': u'/419GfpzSip2cXf17x8FKIRHSSPK.jpg',
               u'id': 679,
               u'original_title': u'Aliens',
               u'poster_path': u'/qet8RDq99dRteBfSRfGeZeqY9xe.jpg',
               u'release_date': u'1986-07-18',
               u'title': u'Aliens',
               u'vote_average': 8.8,
               u'vote_count': 107},
              {u'backdrop_path': u'/sCtmAY3DgrFOjlrDh6mP7luUO7t.jpg',
               u'id': 489,
               u'original_title': u'Good Will Hunting',
               u'poster_path': u'/3yHtbRfp32AouPSwYESoJM3cOeQ.jpg',
               u'release_date': u'1997-12-05',
               u'title': u'Good Will Hunting',
               u'vote_average': 8.8,
               u'vote_count': 32},
              {u'backdrop_path': u'/5YF6MwuuKBRKLUE2dz3wetkgxAE.jpg',
               u'id': 453,
               u'original_title': u'A Beautiful Mind',
               u'poster_path': u'/79L8f0qbawvmdXE4ThVstC5sOxP.jpg',
               u'release_date': u'2001-12-13',
               u'title': u'A Beautiful Mind',
               u'vote_average': 8.5,
               u'vote_count': 28},
              {u'backdrop_path': u'/bYtrTSGDqvd2KlHTO78b4Y3S4E9.jpg',
               u'id': 807,
               u'original_title': u'Se7en',
               u'poster_path': u'/zgB9CCTDlXRv50Z70ZI4elJtNEk.jpg',
               u'release_date': u'1995-09-22',
               u'title': u'Se7en',
               u'vote_average': 8.9,
               u'vote_count': 96},
              {u'backdrop_path': u'/6HbOqP1GUElNLdX8Bx2uP542CIP.jpg',
               u'id': 180,
               u'original_title': u'Minority Report',
               u'poster_path': u'/h3lpltSn7Rj1eYTPQO1lYGdw4Bz.jpg',
               u'release_date': u'2002-06-21',
               u'title': u'Minority Report',
               u'vote_average': 8.3,
               u'vote_count': 34},
              {u'backdrop_path': u'/i9A0UMFg1hI2kLyCCwnmSbpT2cd.jpg',
               u'id': 73,
               u'original_title': u'American History X',
               u'poster_path': u'/fXepRAYOx1qC3wju7XdDGx60775.jpg',
               u'release_date': u'1998-10-30',
               u'title': u'American History X',
               u'vote_average': 8.7,
               u'vote_count': 61},
              {u'backdrop_path': u'/5XPPB44RQGfkBrbJxmtdndKz05n.jpg',
               u'id': 19995,
               u'original_title': u'Avatar',
               u'poster_path': u'/s66l83fTQp0FAJsJqY0xUmkamcx.jpg',
               u'release_date': u'2009-12-18',
               u'title': u'Avatar',
               u'vote_average': 7.9,
               u'vote_count': 516},
              {u'backdrop_path': u'/e1uECwkwbD5Zpm9Gc6eb5mbG4C4.jpg',
               u'id': 38,
               u'original_title': u'Eternal Sunshine of the Spotless Mind',
               u'poster_path': u'/gutwXkVChJkpIrclokNESybj0GC.jpg',
               u'release_date': u'2004-03-19',
               u'title': u'Eternal Sunshine of the Spotless Mind',
               u'vote_average': 8.7,
               u'vote_count': 57},
              {u'backdrop_path': u'/tv8J6uCTKsTlASa8luJqrFiJlBX.jpg',
               u'id': 78,
               u'original_title': u'Blade Runner',
               u'poster_path': u'/ewq1lwhOT8GqBcQH1w8D1BagwTh.jpg',
               u'release_date': u'1982-06-25',
               u'title': u'Blade Runner',
               u'vote_average': 9.0,
               u'vote_count': 147},
              {u'backdrop_path': u'/2nFyTvssbtJMLC6eyYwwZ88gALD.jpg',
               u'id': 10681,
               u'original_title': u'WALL\xb7E',
               u'poster_path': u'/9cJETuLMc6R0bTWRA5i7ctY9bxk.jpg',
               u'release_date': u'2008-06-27',
               u'title': u'WALL\xb7E',
               u'vote_average': 8.7,
               u'vote_count': 164}],
 u'total_pages': 2,
 u'total_results': 34}
account_lists(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • id (int) –
  • session_id (str) –

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.account_lists(<parameters>)
{u'page': 1,
 u'results': [{u'description': u'A list of "frightful flicks waiting to be rediscovered" -- compiled by the self-described leading name in the world of horror: Fangoria magazine.',
               u'favorite_count': 2,
               u'id': u'50a6724919c295084b000028',
               u'iso_639_1': u'en',
               u'item_count': 101,
               u'list_type': u'movie',
               u'name': u"Fangoria's 101 Best Horror Movies You've Never Seen",
               u'poster_path': u'/3sL73Vy4kkrH4P61RA0n6UyYGlQ.jpg'},
              {u'description': u"Part of the AFI 100 Years\u2026 series, AFI's 100 Years\u2026100 Thrills is a list of the top 100 heart-pounding movies in American cinema. The list was unveiled by the American Film Institute on June 12, 2001, during a CBS special hosted by Harrison Ford.",
               u'favorite_count': 2,
               u'id': u'50a54d01760ee32e1400000b',
               u'iso_639_1': u'en',
               u'item_count': 100,
               u'list_type': u'movie',
               u'name': u"AFI's 100 Most Thrilling American Films",
               u'poster_path': u'/tayO4gCLyEo8Uul8FHkJGy3Kppb.jpg'},
              {u'description': u'A list of films that earned its actresses the Razzie Award for Worst Actress of the year.',
               u'favorite_count': 2,
               u'id': u'509fca90760ee3490f000a12',
               u'iso_639_1': u'en',
               u'item_count': 40,
               u'list_type': u'movie',
               u'name': u'Films featuring a Razzie winning Worst Actress Performance',
               u'poster_path': u'/eL61XP1l8H0qrBPJoKqhXdxumkw.jpg'},
              {u'description': u'A list of all films in the Star Wars universe including the theatrical motion picture releases.',
               u'favorite_count': 2,
               u'id': u'509fc02119c295114a0007cb',
               u'iso_639_1': u'en',
               u'item_count': 14,
               u'list_type': u'movie',
               u'name': u'Star Wars Expanded Universe',
               u'poster_path': u'/rf6uEcD5V8zs4J7Huo5L9sYgSki.jpg'},
              {u'description': u"Here's my list of best picture winners for the Oscars. Thought it would be neat to see them all together. There's a lot of movies here I have never even heard of.",
               u'favorite_count': 1,
               u'id': u'509ec17c19c2950a0600050e',
               u'iso_639_1': u'en',
               u'item_count': 84,
               u'list_type': u'movie',
               u'name': u'Best Picture Winners - The Academy Awards',
               u'poster_path': u'/efBm2Nm2v5kQnO0w3hYcW6hVsJU.jpg'},
              {u'description': u'A list of the films that were nominated at the 2008 Oscars for best picture.',
               u'favorite_count': 1,
               u'id': u'509ec007760ee36f0c000917',
               u'iso_639_1': u'en',
               u'item_count': 5,
               u'list_type': u'movie',
               u'name': u'80th Academy Awards (2008) - Best Picture Nominations',
               u'poster_path': u'/nWwFabqFaBbukXdkUCmtnrFxPNh.jpg'},
              {u'description': u"The View Askewniverse is a fictional universe created by writer/director Kevin Smith, featured in several films, comics and a television series; it is named for Smith's production company, View Askew Productions.",
               u'favorite_count': 2,
               u'id': u'509691b119c29532730008fb',
               u'iso_639_1': u'en',
               u'item_count': 6,
               u'list_type': u'movie',
               u'name': u'The View Askewniverse',
               u'poster_path': u'/tGmU66LL8edoRm1RO7sbrz1xuhr.jpg'},
              {u'description': u"Name pretty much says it all, here's the top 50 grossing films of all time.",
               u'favorite_count': 2,
               u'id': u'50957b1419c295013800023e',
               u'iso_639_1': u'en',
               u'item_count': 50,
               u'list_type': u'movie',
               u'name': u'Top 50 Grossing Films of All Time (Worldwide)',
               u'poster_path': u'/sRbZeVtRKIWybTOVpCRPZtzW5bd.jpg'},
              {u'description': u'A list of the films that were nominated at the 2009 Oscars for best picture.',
               u'favorite_count': 2,
               u'id': u'50957064760ee3698a001fc1',
               u'iso_639_1': u'en',
               u'item_count': 5,
               u'list_type': u'movie',
               u'name': u'81st Academy Awards (2009) - Best Picture Nominations',
               u'poster_path': u'/gShtwIvdSHgCEQRZfymNkEUEwFm.jpg'},
              {u'description': u'A list of the films that were nominated at the 2010 Oscars for best picture.',
               u'favorite_count': 2,
               u'id': u'50956fd2760ee3698a001fb1',
               u'iso_639_1': u'en',
               u'item_count': 10,
               u'list_type': u'movie',
               u'name': u'82nd Academy Awards (2010) - Best Picture Nominations',
               u'poster_path': u'/8iwe0iP49A6Gqcv31jBleZDZqI4.jpg'},
              {u'description': u"A list of the theatrical releases for Marvel's Avengers characters that are in the latest Avengers movie.",
               u'favorite_count': 3,
               u'id': u'50953114760ee34b91000293',
               u'iso_639_1': u'en',
               u'item_count': 7,
               u'list_type': u'movie',
               u'name': u'The Avengers',
               u'poster_path': u'/2i89ujVkhJebuoB2zy6QZcwbr2N.jpg'},
              {u'description': u'A list of the films that were nominated at the 2011 Oscars for best picture.',
               u'favorite_count': 1,
               u'id': u'509431ad19c2950b01000004',
               u'iso_639_1': u'en',
               u'item_count': 10,
               u'list_type': u'movie',
               u'name': u'83rd Academy Awards (2011) - Best Picture Nominations',
               u'poster_path': u'/iAHDZPyLD3NW7GuNV6U1TVtb0hN.jpg'},
              {u'description': u"Here's a list of the films that take place in the DC Comics universe.",
               u'favorite_count': 2,
               u'id': u'5094147819c2955e4c00006b',
               u'iso_639_1': u'en',
               u'item_count': 22,
               u'list_type': u'movie',
               u'name': u'The DC Comics Universe',
               u'poster_path': u'/4H1jWsgEQOgTs4KeG5j5BorKMfX.jpg'},
              {u'description': u'A list of the films that were nominated at the 2012 Oscars for best picture.',
               u'favorite_count': 1,
               u'id': u'50941340760ee35da9000054',
               u'iso_639_1': u'en',
               u'item_count': 9,
               u'list_type': u'movie',
               u'name': u'84th Academy Awards (2012) - Best Picture Nominations',
               u'poster_path': u'/zRqBleU93WncYnIwt8LAanQerZ7.jpg'},
              {u'description': u'The idea behind this list is to collect the live action comic book movies from within the Marvel franchise.',
               u'favorite_count': 5,
               u'id': u'50941077760ee35e1500000d',
               u'iso_639_1': u'en',
               u'item_count': 33,
               u'list_type': u'movie',
               u'name': u'The Marvel Universe',
               u'poster_path': u'/w2JbuNpBnfevl0yCcYEm6vNFWdi.jpg'}],
 u'total_pages': 1,
 u'total_results': 15}
account_movie_watchlist(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • movie_watchlist (str) – true | false
  • Required JSON Body (str) –
  • movie_id (int) –
  • id (int) –
  • session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.account_movie_watchlist(<parameters>)
{u'status_code': 1, u'status_message': u'Success'}
account_rated_movies(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • id (int) –
  • session_id (str) –

Optional

Parameters:
  • sort_order (str) – asc | desc
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
  • sort_by (str) – Only ‘created_at` is currently supported.
Usage:
>>> api = tmdb.API(api_key)
>>> api.account_rated_movies(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/tjMZ4RBLhvk670gYJPxIN8SBfnB.jpg',
               u'id': 13,
               u'original_title': u'Forrest Gump',
               u'poster_path': u'/iZvCkb34CAmV9BETIrHY4yiS115.jpg',
               u'rating': 8.0,
               u'release_date': u'1994-06-23',
               u'title': u'Forrest Gump',
               u'vote_average': 8.9,
               u'vote_count': 84},
              {u'backdrop_path': u'/e1uECwkwbD5Zpm9Gc6eb5mbG4C4.jpg',
               u'id': 38,
               u'original_title': u'Eternal Sunshine of the Spotless Mind',
               u'poster_path': u'/gutwXkVChJkpIrclokNESybj0GC.jpg',
               u'rating': 9.0,
               u'release_date': u'2004-03-19',
               u'title': u'Eternal Sunshine of the Spotless Mind',
               u'vote_average': 8.7,
               u'vote_count': 57},
              {u'backdrop_path': u'/gTFGr8q5YzYYiRyDYaEMNB6QRuL.jpg',
               u'id': 106,
               u'original_title': u'Predator',
               u'poster_path': u'/gUpto7r2XwoM5eW7MUvd8hl1etB.jpg',
               u'rating': 6.0,
               u'release_date': u'1987-06-12',
               u'title': u'Predator',
               u'vote_average': 8.4,
               u'vote_count': 49},
              {u'backdrop_path': u'/cNLZ7YGRikb4IsLblrzu86ndZPw.jpg',
               u'id': 107,
               u'original_title': u'Snatch',
               u'poster_path': u'/on9JlbGEccLsYkjeEph2Whm1DIp.jpg',
               u'rating': 8.0,
               u'release_date': u'2000-12-06',
               u'title': u'Snatch',
               u'vote_average': 8.6,
               u'vote_count': 55},
              {u'backdrop_path': u'/pIUvQ9Ed35wlWhY2oU6OmwEsmzG.jpg',
               u'id': 120,
               u'original_title': u'The Lord of the Rings: The Fellowship of the Ring',
               u'poster_path': u'/9HG6pINW1KoFTAKY3LdybkoOKAm.jpg',
               u'rating': 8.0,
               u'release_date': u'2001-12-19',
               u'title': u'The Lord of the Rings: The Fellowship of the Ring',
               u'vote_average': 8.8,
               u'vote_count': 125},
              {u'backdrop_path': u'/nnMC0BM6XbjIIrT4miYmMtPGcQV.jpg',
               u'id': 155,
               u'original_title': u'The Dark Knight',
               u'poster_path': u'/1hRoyzDtpgMU7Dz4JF22RANzQO7.jpg',
               u'rating': 9.0,
               u'release_date': u'2008-07-18',
               u'title': u'The Dark Knight',
               u'vote_average': 8.8,
               u'vote_count': 269},
              {u'backdrop_path': u'/uv5BRIaJKfcPBPEBV8qfTjD6PuY.jpg',
               u'id': 12,
               u'original_title': u'Finding Nemo',
               u'poster_path': u'/zjqInUwldOBa0q07fOyohYCWxWX.jpg',
               u'rating': 8.0,
               u'release_date': u'2003-05-30',
               u'title': u'Finding Nemo',
               u'vote_average': 8.7,
               u'vote_count': 41},
              {u'backdrop_path': u'/kriCxQiDhdosxzYXEf5JApMdmyq.jpg',
               u'id': 187,
               u'original_title': u'Sin City',
               u'poster_path': u'/eCJkepVJslq1nEtqURLaC1zLPAL.jpg',
               u'rating': 8.0,
               u'release_date': u'2005-04-01',
               u'title': u'Sin City',
               u'vote_average': 8.4,
               u'vote_count': 64},
              {u'backdrop_path': u'/6xKCYgH16UuwEGAyroLU6p8HLIn.jpg',
               u'id': 238,
               u'original_title': u'The Godfather',
               u'poster_path': u'/d4KNaTrltq6bpkFS01pYtyXa09m.jpg',
               u'rating': 9.0,
               u'release_date': u'1972-03-24',
               u'title': u'The Godfather',
               u'vote_average': 9.2,
               u'vote_count': 125},
              {u'backdrop_path': u'/iX99sWgGZCnjPpDgG29E0HomMLI.jpg',
               u'id': 275,
               u'original_title': u'Fargo',
               u'poster_path': u'/gO0Q7TMuu8PJ9Y736VTgvY02rVD.jpg',
               u'rating': 8.0,
               u'release_date': u'1996-03-15',
               u'title': u'Fargo',
               u'vote_average': 8.2,
               u'vote_count': 29},
              {u'backdrop_path': u'/d9AqtruwS8nljKjL5aYzM42hQJr.jpg',
               u'id': 280,
               u'original_title': u'Terminator 2: Judgment Day',
               u'poster_path': u'/2y4dmgWYRMYXdD1UyJVcn2HSd1D.jpg',
               u'rating': 8.0,
               u'release_date': u'1991-07-01',
               u'title': u'Terminator 2: Judgment Day',
               u'vote_average': 9.1,
               u'vote_count': 106},
              {u'backdrop_path': u'/xRqsFFteJrvLHxswk78NzU7zOrU.jpg',
               u'id': 289,
               u'original_title': u'Casablanca',
               u'poster_path': u'/sm1QVZu5RKe1vXVHZooo4SZyHMx.jpg',
               u'rating': 8.0,
               u'release_date': u'1942-11-26',
               u'title': u'Casablanca',
               u'vote_average': 8.5,
               u'vote_count': 27},
              {u'backdrop_path': u'/heNbD1JojBNz6kfHWr3O8Uk0a3a.jpg',
               u'id': 296,
               u'original_title': u'Terminator 3: Rise of the Machines',
               u'poster_path': u'/lz4xYdF1n09lyiCfZWtWT44SZiG.jpg',
               u'rating': 7.0,
               u'release_date': u'2003-06-30',
               u'title': u'Terminator 3: Rise of the Machines',
               u'vote_average': 6.7,
               u'vote_count': 44},
              {u'backdrop_path': u'/wH8vtnsmU4olFJ5wSRHo8RXRhKF.jpg',
               u'id': 310,
               u'original_title': u'Bruce Almighty',
               u'poster_path': u'/oHA5eAeJh7ChPsHnSsppNx4ta6L.jpg',
               u'rating': 8.0,
               u'release_date': u'2003-05-23',
               u'title': u'Bruce Almighty',
               u'vote_average': 7.7,
               u'vote_count': 25},
              {u'backdrop_path': u'/tUGSLoMcxNWZ0OIRSqDaB2jNbdE.jpg',
               u'id': 503,
               u'original_title': u'Poseidon',
               u'poster_path': u'/kHrdehzlhyyb190D3RvH8mdX1y2.jpg',
               u'rating': 6.0,
               u'release_date': u'2006-05-12',
               u'title': u'Poseidon',
               u'vote_average': 6.2,
               u'vote_count': 9},
              {u'backdrop_path': u'/tBCOpjphzSLzC6oOjqzTEg6bJ7q.jpg',
               u'id': 534,
               u'original_title': u'Terminator Salvation',
               u'poster_path': u'/hxDfhavtxA2Ayx7O9BsQMcZRdG0.jpg',
               u'rating': 6.0,
               u'release_date': u'2009-05-21',
               u'title': u'Terminator Salvation',
               u'vote_average': 7.0,
               u'vote_count': 57},
              {u'backdrop_path': u'/6TlMTnjtBcXFq7rSCcdQoBjTNPd.jpg',
               u'id': 571,
               u'original_title': u'The Birds',
               u'poster_path': u'/8tGRhGAbIZE97bnUAWrYSdqq71t.jpg',
               u'rating': 6.0,
               u'release_date': u'1963-03-28',
               u'title': u'The Birds',
               u'vote_average': 8.1,
               u'vote_count': 6},
              {u'backdrop_path': u'/7u3pxc0K1wx32IleAkLv78MKgrw.jpg',
               u'id': 603,
               u'original_title': u'The Matrix',
               u'poster_path': u'/gynBNzwyaHKtXqlEKKLioNkjKgN.jpg',
               u'rating': 9.0,
               u'release_date': u'1999-03-31',
               u'title': u'The Matrix',
               u'vote_average': 9.1,
               u'vote_count': 249},
              {u'backdrop_path': u'/jB9nQa6zJIZQ0htH5827Og7Mfsw.jpg',
               u'id': 615,
               u'original_title': u'The Passion of the Christ',
               u'poster_path': u'/6KyvP5bDmwTYdLLnhEn10NFPDIZ.jpg',
               u'rating': 6.0,
               u'release_date': u'2004-02-25',
               u'title': u'The Passion of the Christ',
               u'vote_average': 7.5,
               u'vote_count': 15},
              {u'backdrop_path': u'/nO0GtGFQmEuuOyAQVpHjJlWBU8O.jpg',
               u'id': 616,
               u'original_title': u'The Last Samurai',
               u'poster_path': u'/cRz4FRx731ulws6zHuQVaDXpx73.jpg',
               u'rating': 8.0,
               u'release_date': u'2003-12-05',
               u'title': u'The Last Samurai',
               u'vote_average': 8.1,
               u'vote_count': 26}],
 u'total_pages': 12,
 u'total_results': 239}
authentication_guest_session_new(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Usage:
>>> api = tmdb.API(api_key)
>>> api.authentication_guest_session_new(<parameters>)
{u'expires_at': u'2012-12-04 22:51:19 UTC',
 u'guest_session_id': u'0c550fd5da2fc3f321ab3bs9b60ca108',
 u'success': True}
authentication_session_new(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:request_token (str) – The request token parameter is the token you generated for the user to approve. The token needs to be approved by the user before being used here. You can read more about this here.
Usage:
>>> api = tmdb.API(api_key)
>>> api.authentication_session_new(<parameters>)
{u'session_id': u'80b2bf99520cd795ff54e31af97917bc9e3a7c8c', u'success': True}
authentication_token_new(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Usage:
>>> api = tmdb.API(api_key)
>>> api.authentication_token_new(<parameters>)
{u'expires_at': u'2012-02-09 19:50:25 UTC',
 u'request_token': u'641bf16c663db167c6cffcdff41126039d4445bf',
 u'success': True}
base_url = u'https://api.themoviedb.org'
certification_movie_list(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Usage:
>>> api = tmdb.API(api_key)
>>> api.certification_movie_list(<parameters>)
{u'certifications': {u'AU': [{u'certification': u'E',
                              u'meaning': u'Exempt from classification. Films that are exempt from classification must not contain contentious material (i.e. material that would ordinarily be rated M or higher).',
                              u'order': 1},
                             {u'certification': u'G',
                              u'meaning': u'General. The content is very mild in impact.',
                              u'order': 2},
                             {u'certification': u'PG',
                              u'meaning': u'Parental guidance recommended. There are no age restrictions. The content is mild in impact.',
                              u'order': 2},
                             {u'certification': u'M',
                              u'meaning': u'Recommended for mature audiences. There are no age restrictions. The content is moderate in impact.',
                              u'order': 3},
                             {u'certification': u'MA15+',
                              u'meaning': u'Mature Accompanied. Unsuitable for children younger than 15. Children younger than 15 years must be accompanied by a parent or guardian. The content is strong in impact.',
                              u'order': 5},
                             {u'certification': u'R18+',
                              u'meaning': u'Restricted to 18 years and over. Adults only. The content is high in impact.',
                              u'order': 6},
                             {u'certification': u'X18+',
                              u'meaning': u'Restricted to 18 years and over. Films with this rating have pornographic content. Films classified as X18+ are banned from being sold or rented in all Australian states and are only legally available in the Australian Capital Territory and the Northern Territory. However, importing X18+ material from the two territories to any of the Australian states is legal.The content is sexually explicit in impact.',
                              u'order': 7},
                             {u'certification': u'RC',
                              u'meaning': u'Refused Classification. Banned from sale or hire in Australia; also generally applies to importation (if inspected by and suspicious to Customs). Private Internet viewing is unenforced and attempts to legally censor such online material has resulted in controversy. Films are rated RC if their content exceeds the guidelines. The content is very high in impact.',
                              u'order': 8}],
                     u'CA': [{u'certification': u'G',
                              u'meaning': u'All ages.',
                              u'order': 1},
                             {u'certification': u'PG',
                              u'meaning': u'Parental guidance advised. There is no age restriction but some material may not be suitable for all children.',
                              u'order': 2},
                             {u'certification': u'14A',
                              u'meaning': u'Persons under 14 years of age must be accompanied by an adult.',
                              u'order': 3},
                             {u'certification': u'18A',
                              u'meaning': u'Persons under 18 years of age must be accompanied by an adult. In the Maritimes & Manitoba, children under the age of 14 are prohibited from viewing the film.',
                              u'order': 4},
                             {u'certification': u'R',
                              u'meaning': u'Admittance restricted to people 18 years of age or older.',
                              u'order': 5},
                             {u'certification': u'A',
                              u'meaning': u'Admittance restricted to people 18 years of age or older. Sole purpose of the film is the portrayal of sexually explicit activity and/or explicit violence.',
                              u'order': 5}],
                     u'DE': [{u'certification': u'0',
                              u'meaning': u'No age restriction.',
                              u'order': 1},
                             {u'certification': u'6',
                              u'meaning': u'No children younger than 6 years admitted.',
                              u'order': 2},
                             {u'certification': u'12',
                              u'meaning': u'Children 12 or older admitted, children between 6 and 11 only when accompanied by parent or a legal guardian.',
                              u'order': 3},
                             {u'certification': u'16',
                              u'meaning': u'Children 16 or older admitted, nobody under this age admitted.',
                              u'order': 4},
                             {u'certification': u'18',
                              u'meaning': u'No youth admitted, only adults.',
                              u'order': 5}],
                     u'FR': [{u'certification': u'U',
                              u'meaning': u'(Tous publics) valid for all audiences.',
                              u'order': 1},
                             {u'certification': u'10',
                              u'meaning': u'(D\xe9conseill\xe9 aux moins de 10 ans) unsuitable for children younger than 10 (this rating is only used for TV); equivalent in theatres : "avertissement" (warning), some scenes may be disturbing to young children and sensitive people; equivalent on video : "accord parental" (parental guidance).',
                              u'order': 2},
                             {u'certification': u'12',
                              u'meaning': u'(Interdit aux moins de 12 ans) unsuitable for children younger than 12 or forbidden in cinemas for under 12.',
                              u'order': 3},
                             {u'certification': u'16',
                              u'meaning': u'(Interdit aux moins de 16 ans) unsuitable for children younger than 16 or forbidden in cinemas for under 16.',
                              u'order': 4},
                             {u'certification': u'18',
                              u'meaning': u'(Interdit aux mineurs) unsuitable for children younger than 18 or forbidden in cinemas for under 18.',
                              u'order': 5}],
                     u'GB': [{u'certification': u'U',
                              u'meaning': u'All ages admitted, there is nothing unsuitable for children.',
                              u'order': 1},
                             {u'certification': u'PG',
                              u'meaning': u'All ages admitted, but certain scenes may be unsuitable for young children. May contain mild language and sex/drugs references. May contain moderate violence if justified by context (e.g. fantasy).',
                              u'order': 2},
                             {u'certification': u'12A',
                              u'meaning': u'Films under this category are considered to be unsuitable for very young people. Those aged under 12 years are only admitted if accompanied by an adult, aged at least 18 years, at all times during the motion picture. However, it is generally not recommended that children under 12 years should watch the film. Films under this category can contain mature themes, discrimination, soft drugs, moderate swear words, infrequent strong language and moderate violence, sex references and nudity. Sexual activity may be briefly and discreetly portrayed. Sexual violence may be implied or briefly indicated.',
                              u'order': 3},
                             {u'certification': u'12',
                              u'meaning': u'Home media only since 2002. 12A-rated films are usually given a 12 certificate for the VHS/DVD version unless extra material has been added that requires a higher rating. Nobody younger than 12 can rent or buy a 12-rated VHS, DVD, Blu-ray Disc, UMD or game. The content guidelines are identical to those used for the 12A certificate.',
                              u'order': 4},
                             {u'certification': u'15',
                              u'meaning': u'Only those over 15 years are admitted. Nobody younger than 15 can rent or buy a 15-rated VHS, DVD, Blu-ray Disc, UMD or game, or watch a film in the cinema with this rating. Films under this category can contain adult themes, hard drugs, frequent strong language and limited use of very strong language, strong violence and strong sex references, and nudity without graphic detail. Sexual activity may be portrayed but without any strong detail. Sexual violence may be shown if discreet and justified by context.',
                              u'order': 5},
                             {u'certification': u'18',
                              u'meaning': u'Only adults are admitted. Nobody younger than 18 can rent or buy an 18-rated VHS, DVD, Blu-ray Disc, UMD or game, or watch a film in the cinema with this rating. Films under this category do not have limitation on the bad language that is used. Hard drugs are generally allowed, and explicit sex references along with detailed sexual activity are also allowed. Scenes of strong real sex may be permitted if justified by the context. Very strong, gory, and/or sadistic violence is usually permitted. Strong sexual violence is permitted unless it is eroticised or excessively graphic.',
                              u'order': 6},
                             {u'certification': u'R18',
                              u'meaning': u'Can only be shown at licensed adult cinemas or sold at licensed sex shops, and only to adults, those aged 18 or over. Films under this category are always hard-core pornography, defined as material intended for sexual stimulation and containing clear images of real sexual activity, strong fetish material, explicit animated images, or sight of certain acts such as triple simultaneous penetration and snowballing. There remains a range of material that is often cut from the R18 rating: strong images of injury in BDSM or spanking works, urolagnia, scenes suggesting incest even if staged, references to underage sex or childhood sexual development and aggressive behaviour such as hair-pulling or spitting on a performer are not permitted. More cuts are demanded in this category than any other category.',
                              u'order': 7}],
                     u'IN': [{u'certification': u'U',
                              u'meaning': u'Unrestricted Public Exhibition throughout India, suitable for all age groups. Films under this category should not upset children over 4. Such films may contain educational, social or family-oriented themes. Films under this category may also contain fantasy violence and/or mild bad language.',
                              u'order': 0},
                             {u'certification': u'UA',
                              u'meaning': u'All ages admitted, but it is advised that children below 12 be accompanied by a parent as the theme or content may be considered intense or inappropriate for young children. Films under this category may contain mature themes, sexual references, mild sex scenes, violence with brief gory images and/or infrequent use of crude language.',
                              u'order': 1},
                             {u'certification': u'A',
                              u'meaning': u'Restricted to adult audiences (18 years or over). Nobody below the age of 18 may buy/rent an A-rated DVD, VHS, UMD or watch a film in the cinema with this rating. Films under this category may contain adult/disturbing themes, frequent crude language, brutal violence with blood and gore, strong sex scenes and/or scenes of drug abuse which is considered unsuitable for minors.',
                              u'order': 2}],
                     u'NZ': [{u'certification': u'G',
                              u'meaning': u'Suitable for general audiences.',
                              u'order': 1},
                             {u'certification': u'PG',
                              u'meaning': u'Parental guidance recommended for younger viewers.',
                              u'order': 2},
                             {u'certification': u'M',
                              u'meaning': u'Suitable for (but not restricted to) mature audiences 16 years and up.',
                              u'order': 3},
                             {u'certification': u'13',
                              u'meaning': u'Restricted to persons 13 years of age and over.',
                              u'order': 4},
                             {u'certification': u'15',
                              u'meaning': u'Restricted to persons 15 years of age and over.',
                              u'order': 5},
                             {u'certification': u'16',
                              u'meaning': u'Restricted to persons 16 years of age and over.',
                              u'order': 6},
                             {u'certification': u'18',
                              u'meaning': u'Restricted to persons 18 years of age and over.',
                              u'order': 7},
                             {u'certification': u'R',
                              u'meaning': u'Restricted to a particular class of persons, or for particular purposes, or both.',
                              u'order': 8}],
                     u'US': [{u'certification': u'NR',
                              u'meaning': u'No rating information.',
                              u'order': 0},
                             {u'certification': u'G',
                              u'meaning': u'All ages admitted. There is no content that would be objectionable to most parents. This is one of only two ratings dating back to 1968 that still exists today.',
                              u'order': 1},
                             {u'certification': u'PG',
                              u'meaning': u'Some material may not be suitable for children under 10. These films may contain some mild language, crude/suggestive humor, scary moments and/or violence. No drug content is present. There are a few exceptions to this rule. A few racial insults may also be heard.',
                              u'order': 2},
                             {u'certification': u'PG-13',
                              u'meaning': u'Some material may be inappropriate for children under 13. Films given this rating may contain sexual content, brief or partial nudity, some strong language and innuendo, humor, mature themes, political themes, terror and/or intense action violence. However, bloodshed is rarely present. This is the minimum rating at which drug content is present.',
                              u'order': 3},
                             {u'certification': u'R',
                              u'meaning': u'Under 17 requires accompanying parent or adult guardian 21 or older. The parent/guardian is required to stay with the child under 17 through the entire movie, even if the parent gives the child/teenager permission to see the film alone. These films may contain strong profanity, graphic sexuality, nudity, strong violence, horror, gore, and strong drug use. A movie rated R for profanity often has more severe or frequent language than the PG-13 rating would permit. An R-rated movie may have more blood, gore, drug use, nudity, or graphic sexuality than a PG-13 movie would admit.',
                              u'order': 4},
                             {u'certification': u'NC-17',
                              u'meaning': u'These films contain excessive graphic violence, intense or explicit sex, depraved, abhorrent behavior, explicit drug abuse, strong language, explicit nudity, or any other elements which, at present, most parents would consider too strong and therefore off-limits for viewing by their children and teens. NC-17 does not necessarily mean obscene or pornographic in the oft-accepted or legal meaning of those words.',
                              u'order': 5}]}}
collection(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any collection method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.collection(<parameters>)
{u'backdrop_path': u'/mOTtuakUTb1qY6jG6lzMfjdhLwc.jpg',
 u'id': 10,
 u'name': u'Star Wars Collection',
 u'parts': [{u'backdrop_path': u'/mOTtuakUTb1qY6jG6lzMfjdhLwc.jpg',
             u'id': 11,
             u'poster_path': u'/qoETrQ73Jbd2LDN8EUfNgUerhzG.jpg',
             u'release_date': u'1977-12-27',
             u'title': u'Star Wars: Episode IV: A New Hope'},
            {u'backdrop_path': None,
             u'id': 1891,
             u'poster_path': None,
             u'release_date': u'1980-05-21',
             u'title': u'Star Wars: Episode V: The Empire Strikes Back'},
            {u'backdrop_path': None,
             u'id': 1892,
             u'poster_path': None,
             u'release_date': u'1983-05-25',
             u'title': u'Star Wars: Episode VI: Return of the Jedi'},
            {u'backdrop_path': None,
             u'id': 1893,
             u'poster_path': None,
             u'release_date': u'1999-05-19',
             u'title': u'Star Wars: Episode I: The Phantom Menace'},
            {u'backdrop_path': None,
             u'id': 1894,
             u'poster_path': None,
             u'release_date': u'2002-05-16',
             u'title': u'Star Wars: Episode II: Attack of the Clones'},
            {u'backdrop_path': None,
             u'id': 1895,
             u'poster_path': None,
             u'release_date': u'2005-05-19',
             u'title': u'Star Wars: Episode III: Revenge of the Sith'}],
 u'poster_path': u'/6rddZZpxMQkGlpQYVVxb2LdQRI3.jpg'}
collection_images(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • include_image_language (str) – Comma separated, a valid ISO 69-1.
  • append_to_response (str) – Comma separated, any collection method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.collection_images(<parameters>)
{u'backdrops': [{u'aspect_ratio': 1.78,
                 u'file_path': u'/mOTtuakUTb1qY6jG6lzMfjdhLwc.jpg',
                 u'height': 1080,
                 u'iso_639_1': None,
                 u'width': 1920},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/6dSG8wQBuZ9s0HhKspneFFZI58j.jpg',
                 u'height': 1080,
                 u'iso_639_1': None,
                 u'width': 1920}],
 u'id': 11,
 u'posters': [{u'aspect_ratio': 0.67,
               u'file_path': u'/qoETrQ73Jbd2LDN8EUfNgUerhzG.jpg',
               u'height': 1500,
               u'iso_639_1': u'en',
               u'width': 1000},
              {u'aspect_ratio': 0.67,
               u'file_path': u'/fiPNADHtDsOBvOIye79cLui3aEQ.jpg',
               u'height': 1500,
               u'iso_639_1': None,
               u'width': 1000},
              {u'aspect_ratio': 0.67,
               u'file_path': u'/rUCmBo09lVZbbzCR5zbAMWazvOa.jpg',
               u'height': 1500,
               u'iso_639_1': None,
               u'width': 1000},
              {u'aspect_ratio': 0.67,
               u'file_path': u'/7b95oMhjiWby189P9DwutN5k374.jpg',
               u'height': 1350,
               u'iso_639_1': u'de',
               u'width': 900}]}
company(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:append_to_response (str) – Comma separated, any company method
Usage:
>>> api = tmdb.API(api_key)
>>> api.company(<parameters>)
{u'description': None,
 u'headquarters': u'San Francisco, California',
 u'homepage': u'http://www.lucasfilm.com',
 u'id': 1,
 u'logo_path': u'/8rUnVMVZjlmQsJ45UGotD0Uznxj.png',
 u'name': u'Lucasfilm',
 u'parent_company': None}
company_movies(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any company method
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.company_movies(<parameters>)
{u'id': 1,
 u'page': 1,
 u'results': [{u'backdrop_path': u'/gmLMaDXi4lFWG8WitaCYOJS5GtL.jpg',
               u'id': 12180,
               u'original_title': u'Star Wars: The Clone Wars',
               u'poster_path': u'/xd6yhmtS6mEURZLwUDT5raEMbf.jpg',
               u'release_date': u'2008-08-15',
               u'title': u'Star Wars: The Clone Wars',
               u'vote_average': 7.7,
               u'vote_count': 12},
              {u'backdrop_path': u'/alNMTW47nZABwvwz3Gjwarl4btE.jpg',
               u'id': 217,
               u'original_title': u'Indiana Jones and the Kingdom of the Crystal Skull',
               u'poster_path': u'/6Lv49E0aEusW9vKEMgQgLdetlmO.jpg',
               u'release_date': u'2008-05-22',
               u'title': u'Indiana Jones and the Kingdom of the Crystal Skull',
               u'vote_average': 6.7,
               u'vote_count': 48},
              {u'backdrop_path': u'/gZxY7VDOI48gjhnDJK1E6n9uHWk.jpg',
               u'id': 42979,
               u'original_title': u'Robot Chicken: Star Wars',
               u'poster_path': u'/3vcBL7zNVMhLdFSEh3xiquhdp1x.jpg',
               u'release_date': u'2007-07-17',
               u'title': u'Robot Chicken: Star Wars',
               u'vote_average': 8.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/zHrxWn6P6Zjip9fJmmuEbzDd76o.jpg',
               u'id': 1895,
               u'original_title': u'Star Wars: Episode III - Revenge of the Sith',
               u'poster_path': u'/tgr5Pdy7ehZYBqBkN2K7Q02xgOb.jpg',
               u'release_date': u'2005-05-19',
               u'title': u'Star Wars: Episode III - Revenge of the Sith',
               u'vote_average': 7.9,
               u'vote_count': 59},
              {u'backdrop_path': u'/560F7BPaxRy8BsOfVU6cW4ivM46.jpg',
               u'id': 1894,
               u'original_title': u'Star Wars: Episode II - Attack of the Clones',
               u'poster_path': u'/2vcNFtrZXNwIcBgH5e2xXCmVR8t.jpg',
               u'release_date': u'2002-05-16',
               u'title': u'Star Wars: Episode II - Attack of the Clones',
               u'vote_average': 7.6,
               u'vote_count': 69},
              {u'backdrop_path': u'/4KD7RynRLIGqWjDvwwta5iBDvgS.jpg',
               u'id': 47025,
               u'original_title': u'R2-D2: Beneath the Dome',
               u'poster_path': u'/wTqLGbnUn5yMgh3fD3HUWrv0gKl.jpg',
               u'release_date': u'2001-11-25',
               u'title': u'R2-D2: Beneath the Dome',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/rtG5TRrQXf11jlO9WqcYTq46jKa.jpg',
               u'id': 1893,
               u'original_title': u'Star Wars: Episode I - The Phantom Menace',
               u'poster_path': u'/n8V09dDc02KsSN6Q4hC2BX6hN8X.jpg',
               u'release_date': u'1999-05-19',
               u'title': u'Star Wars: Episode I - The Phantom Menace',
               u'vote_average': 7.2,
               u'vote_count': 74},
              {u'backdrop_path': u'/sBAyZPvS3RmX6SFr0fJ9bDeRmP5.jpg',
               u'id': 74823,
               u'original_title': u'Star Wars: Droids - Treasure of the Hidden Planet',
               u'poster_path': u'/sFQatyz7dCONSlQg6NP3F3kJ0QP.jpg',
               u'release_date': u'1997-02-11',
               u'title': u'Star Wars: Droids - Treasure of the Hidden Planet',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': None,
               u'id': 75380,
               u'original_title': u'Star Wars: Droids - The Pirate and the Prince',
               u'poster_path': u'/tzMyVe7heytMepJJCJq21n6FGWV.jpg',
               u'release_date': u'1997-02-11',
               u'title': u'Star Wars: Droids - The Pirate and the Prince',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/pY7VAT4gtvVy38UuVEPhTPyfiYJ.jpg',
               u'id': 89,
               u'original_title': u'Indiana Jones and the Last Crusade',
               u'poster_path': u'/1xlQmxqKbkCb2THC9rwgr75p25B.jpg',
               u'release_date': u'1989-05-24',
               u'title': u'Indiana Jones and the Last Crusade',
               u'vote_average': 8.8,
               u'vote_count': 58},
              {u'backdrop_path': u'/n1wLikbs9EjLbZXOPcymEsrJctZ.jpg',
               u'id': 847,
               u'original_title': u'Willow',
               u'poster_path': u'/5iara9JMotSn9r7TM4tL7LFyfdu.jpg',
               u'release_date': u'1988-05-20',
               u'title': u'Willow',
               u'vote_average': 8.0,
               u'vote_count': 11},
              {u'backdrop_path': u'/9zNu80EjtkvDImE4goHFsI6z3JW.jpg',
               u'id': 10372,
               u'original_title': u'Ewoks: The Battle for Endor',
               u'poster_path': u'/qKWa0i67AY2XNzvg7yXfGLX1Vcf.jpg',
               u'release_date': u'1985-11-24',
               u'title': u'Ewoks: The Battle for Endor',
               u'vote_average': 10.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/dmLfnPklVIXpOYbJaUKF3pgXsWk.jpg',
               u'id': 1884,
               u'original_title': u'The Ewok Adventure',
               u'poster_path': u'/y6HdTlqgcZ6EdsKR1uP03WgBe0C.jpg',
               u'release_date': u'1984-11-25',
               u'title': u'The Ewok Adventure',
               u'vote_average': 10.0,
               u'vote_count': 4},
              {u'backdrop_path': u'/uG6AChg2FA3EmRuJDezDqoIpQzB.jpg',
               u'id': 87,
               u'original_title': u'Indiana Jones and the Temple of Doom',
               u'poster_path': u'/c8wjjTnqxnG835iSEeWUJJifSVp.jpg',
               u'release_date': u'1984-05-23',
               u'title': u'Indiana Jones and the Temple of Doom',
               u'vote_average': 7.8,
               u'vote_count': 40},
              {u'backdrop_path': u'/i4Qh3cHNS3vcJAJoGoVSXePMGQV.jpg',
               u'id': 36751,
               u'original_title': u'Twice Upon a Time',
               u'poster_path': u'/r9kyqDYhzgelcnSakBp0w5C5i7z.jpg',
               u'release_date': u'1983-08-05',
               u'title': u'Twice Upon a Time',
               u'vote_average': 8.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/bvJOpyHYWACDusvQvXxKEHFNjce.jpg',
               u'id': 1892,
               u'original_title': u'Star Wars: Episode VI - Return of the Jedi',
               u'poster_path': u'/jx5p0aHlbPXqe3AH9G15NvmWaqQ.jpg',
               u'release_date': u'1983-05-25',
               u'title': u'Star Wars: Episode VI - Return of the Jedi',
               u'vote_average': 8.7,
               u'vote_count': 105},
              {u'backdrop_path': u'/i5ubqxYkkqZpwgw6nHHUudOuGTh.jpg',
               u'id': 85,
               u'original_title': u'Raiders of the Lost Ark',
               u'poster_path': u'/tjGpsV0vKKHECtdsQoVwIXsDj3.jpg',
               u'release_date': u'1981-06-12',
               u'title': u'Raiders of the Lost Ark',
               u'vote_average': 8.7,
               u'vote_count': 59},
              {u'backdrop_path': u'/AkE7LQs2hPMG5tpWYcum847Knre.jpg',
               u'id': 1891,
               u'original_title': u'Star Wars: Episode V - The Empire Strikes Back',
               u'poster_path': u'/dKz98Lyda4m1QaUUUsUpXFpYCXN.jpg',
               u'release_date': u'1980-05-21',
               u'title': u'Star Wars: Episode V - The Empire Strikes Back',
               u'vote_average': 9.0,
               u'vote_count': 144},
              {u'backdrop_path': u'/r0v9dayXd1IH5WPWFBWv52tGHkB.jpg',
               u'id': 11,
               u'original_title': u'Star Wars: Episode IV - A New Hope',
               u'poster_path': u'/tvSlBzAdRE29bZe5yYWrJ2ds137.jpg',
               u'release_date': u'1977-05-25',
               u'title': u'Star Wars: Episode IV - A New Hope',
               u'vote_average': 9.0,
               u'vote_count': 149},
              {u'backdrop_path': u'/qCECROwx3TRUEgoZv2Mz2D723QC.jpg',
               u'id': 10,
               u'original_title': u'Star Wars Collection',
               u'poster_path': u'/ghd5zOQnDaDW1mxO7R5fXXpZMu.jpg',
               u'release_date': None,
               u'title': u'Star Wars Collection',
               u'vote_average': 0.0,
               u'vote_count': 0}],
 u'total_pages': 1,
 u'total_results': 20}
configuration(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Usage:
>>> api = tmdb.API(api_key)
>>> api.configuration(<parameters>)
{u'change_keys': [u'adult',
                  u'also_known_as',
                  u'alternative_titles',
                  u'biography',
                  u'birthday',
                  u'budget',
                  u'cast',
                  u'character_names',
                  u'crew',
                  u'deathday',
                  u'general',
                  u'genres',
                  u'homepage',
                  u'images',
                  u'imdb_id',
                  u'name',
                  u'original_title',
                  u'overview',
                  u'plot_keywords',
                  u'production_companies',
                  u'production_countries',
                  u'releases',
                  u'revenue',
                  u'runtime',
                  u'spoken_languages',
                  u'status',
                  u'tagline',
                  u'title',
                  u'trailers',
                  u'translations'],
 u'images': {u'backdrop_sizes': [u'w300', u'w780', u'w1280', u'original'],
             u'base_url': u'http://image.tmdb.org/t/p/',
             u'logo_sizes': [u'w45',
                             u'w92',
                             u'w154',
                             u'w185',
                             u'w300',
                             u'w500',
                             u'original'],
             u'poster_sizes': [u'w92',
                               u'w154',
                               u'w185',
                               u'w342',
                               u'w500',
                               u'original'],
             u'profile_sizes': [u'w45', u'w185', u'h632', u'original'],
             u'secure_base_url': u'https://image.tmdb.org/t/p/'}}
credit(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:credit_id (str) –

Optional

Parameters:language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.credit(<parameters>)
{u'credit_type': u'cast',
 u'department': u'Actors',
 u'id': u'5240760b5dbf5b0c2c0139db',
 u'job': u'Actor',
 u'media': {u'character': u'',
            u'episodes': [{u'air_date': u'1994-11-17',
                           u'episode_number': 8,
                           u'name': u'The Mom & Pop Store',
                           u'overview': u'A salesman convinces George to buy a convertible once owned by "Jon Voight." Kramer tries to save a small shoe-repair business, but his good intentions affect Jerry in a big way. Elaine wins tickets for Mr. Pitt, who\'s always wanted to participate in the Macy\'s Thanksgiving Day Parade.',
                           u'season_number': 6,
                           u'still_path': None},
                          {u'air_date': u'1995-01-19',
                           u'episode_number': 12,
                           u'name': u'The Label Maker',
                           u'overview': u'Elaine and Jerry are suspicious of a friend\'s gift, when a gift Elaine gave him, a label maker, is given to Jerry in return for some Superbowl tickets Jerry has but can\'t use because "The Drake" is getting married on Superbowl Sunday and he is in the wedding party. George convinces his girlfriend to get her male roommate to move out, that he soon regrets. Kramer takes playing a game of Risk against Newman seriously. The Superbowl tickets pass through several hands and Jerry sees the game with his worst nightmare.',
                           u'season_number': 6,
                           u'still_path': None},
                          {u'air_date': u'1997-04-24',
                           u'episode_number': 19,
                           u'name': u'The Yada Yada',
                           u'overview': u'George\'s girlfriend is big on using the phrase "yada yada"; Jerry says at least she is succinct. Jerry\'s dentist just became Jewish and he is already making jokes that make Jerry uncomfortable. Kramer and Mickey double date but they can\'t decide which of the women is right for them. Elaine is a character reference for a couple who is trying to adopt; a story she tells during the interview destroys all hope of adoption. George drops by Jerry\'s dental appointment. Mickey and Kramer continue to fight over who gets Karen or Julie. George determines that his girlfriend might be leaving out some significant details with her overuse of the phrase "yada yada." He gets her to fill in the details and discovers more than he wants to know. Jerry confesses to a priest about what he thinks about Tim\'s conversion. George drops by Jerry\'s confession. Kramer decides on the right woman and Mickey also decides to make his a commitment. Tim hears about Jerry\'s dental joke. After hearing Jerry\'s complaints about Tim, Kramer accuses Jerry of being an "anti-dentite." Elaine lobbies on behalf of Beth and Arnie and makes a sacrifice to try getting them a child. Meanwhile, Beth comes to Jerry for help when her marriage is falling apart. It does and she accompanies Jerry to Mickey\'s wedding where she reveals an unknown side of her personality.',
                           u'season_number': 8,
                           u'still_path': None},
                          {u'air_date': u'1997-12-18',
                           u'episode_number': 10,
                           u'name': u'The Strike',
                           u'overview': u'George, Elaine and Jerry attend Tim Whatley\'s Hanukkah party. Jerry meets an attractive woman with whom he sets up a date. Elaine meets a man in a bad denim vest and gives him her fake number. George is offended by Whatley\'s gift to him, a donation in his name to a charity. George is also reminded of the Festivus holiday his father created many years ago. Elaine\'s quest to become a submarine captain and get her free sub sandwich is ruined when she realizes she used her punch card at the party to give her fake number to the denim vested guy. Kramer gets word he can return to his job at the bagel place, it seems he has been on strike for the past 12 years. Elaine goes to the place, an off-track betting parlor, that her fake number reaches. She wanted to give them her real number, so when the denim vest guy calls, she can connect with him. The men at the parlor are interested in connecting with her, so she gives the number for the bagel shop where Kramer is working. Jerry meets his date, Gwen, at a restaurant, but it turns out she is two-faced. Sometimes Gwen looks great, other times she\'s plain; it all depends on the viewer\'s angle and the lighting. George decides to use the Whatley approach when giving out Christmas gifts at Krugers; however, he makes up his own charity called the "Human Fund." Kramer is intrigued by the concept of the Festivus holiday and contacts Frank, who becomes excited at the prospect of rekindling "Festivus for the rest-of-us." Kramer asks to get the 23rd of December off, when he can\'t get it, he resumes the strike; meanwhile Elaine waits at the bagel place for a phone call from the denim vest guy. The look of Jerry\'s girlfriend keeps changing.\nJerry decides that Gwen looks best in the back booth at Monk\'s, something she grows to dislike. George passes out his gifts at Krugers and reaps great rewards. Kramer warns Elaine about the sabotage he committed; the bagel place becomes very steamy and makes Elaine look ugly. Kruger gives George a check for donates $20,000 to the "Human Fund" and later accounting informs him the charity doesn\'t exist. Gwen finds out from Kramer that Jerry is seeing another woman, Kramer has seen her and she\'s not Gwen. Gwen thinks Jerry is two-timing her with an ugly woman. George tries to convince Kruger that he passed out the fake gift cards because he didn\'t want to be ridiculed for the holiday his family traditionally celebrates, Festivus. To prove it, George brings Kruger to his father\'s Festivus dinner, where everyone comes together.',
                           u'season_number': 9,
                           u'still_path': None},
                          {u'air_date': u'1998-05-14',
                           u'episode_number': 23,
                           u'name': u'The Finale, Part 1',
                           u'overview': u'Jerry and George discuss the movies and George\'s desire to get his fifteen minutes of fame. Kramer is off to the beach. Elaine calls a friend, whose father is in the hospital, with her cell phone; Jerry and George tell her that is a social faux pas. Jerry gets a message from NBC that they want to talk about the pilot. So Jerry and George go to meet with the new vice president of programming, who is interested in turning their pilot into a 13 episode series. Jerry and George begin to make plans to move to California. Jerry interrupts Elaine\'s phone call to her friend to tell her about the NBC deal. When he finds out what she did, he tells her that was an even greater faux pas than the cell phone. Jerry and George\'s parents are excited by the news about the NBC deal. NBC offers Jerry George a perk, free use of one of their private jets to anywhere they want. Kramer returns from the beach, but has a little bit of water trapped in his ear. Kramer warns they\'ll never come back from LA, "she\'s a seductress." Hey! He did. The foursome decides where they want to take the private jet. They finally decide on Paris. As they are ready to leave, Elaine plans to call her friend again; Jerry tells her it is not right to rush that kind of phone call. Elaine avoids a faux pas. Newman begs to be brought along, when Jerry denies him, he vows to be there at Jerry\'s day of reckoning. The private jet, except for George who wanted the one Ted Danson would have gotten impresses everyone. With water still in his ear, Kramer tries to get it out mid-flight. He stumbles into the cockpit and the plane starts going into a crash dive. During the descent, George confesses he cheated during "the contest" and Elaine and Jerry are about to tell each other something important, when the plane corrects itself. The plane puts down in the small town of Latham, Massachusetts for a checkup. The foursome goes into town and debates about if they are going to get back on the plane. They witness the robbery of a fat guy, which they all mock and Kramer videotapes. They are arrested under the Good Samaritan law established by the town. They are looking at a fine of a maximum of $85,000 and up to five years in prison. The guard assumes they are going to be prosecuted since this is the first offense of this kind in the country. Jackie Chiles is called in for their defense. The prosecution decides to look into the past of these four and build a case that will destroy their characters. Rivera Live covers the trial. Jerry and George\'s parents prepare to go to Latham for the trial. Newman (who\'s absolutely delighted), Uncle Leo, Peterman, Puddy, Mickey, Bania, Mr. Mrs. Ross, Rabbi Glickman, Keith Hernandez and George Steinbrenner also make their way to Latham. Jackie tries to give George a moral compass. The judge, Arthur Vandelay, begins the trial. George thinks the name might be a good sign. The trial begins with opening arguments.',
                           u'season_number': 9,
                           u'still_path': None}],
            u'id': 5,
            u'name': u'Seinfeld',
            u'original_name': u'Seinfeld',
            u'seasons': []},
 u'media_type': u'tv',
 u'person': {u'id': 17419, u'name': u'Bryan Cranston'}}
discover_movie(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • vote_average.gte (str) – Only include movies that are equal to, or have a higher average rating than this value. Expected value is a float.
  • release_date.lte (str) – The maximum release to include. Expected format is YYYY-MM-DD.
  • language (str) – ISO 639-1 code.
  • primary_release_year (str) – Filter the results so that only the primary release date year has this value. Expected value is a year.
  • certification_country (str) – Only include movies with certifications for a specific country. When this value is specified, ‘certification.lte’ is required. A ISO 3166-1 is expected.
  • vote_count.gte (str) – Only include movies that are equal to, or have a vote count higher than this value. Expected value is an integer.
  • include_adult (str) – Toggle the inclusion of adult titles. Expected value is a boolean, true or false
  • sort_by (str) – Available options are vote_average.desc, vote_average.asc, release_date.desc, release_date.asc, popularity.desc, popularity.asc
  • with_genres (str) – Only include movies with the specified genres. Expected value is an integer (the id of a genre). Multiple values can be specified. Comma separated indicates an ‘AND’ query, while a pipe (|) separated value indicates an ‘OR’.
  • release_date.gte (str) – The minimum release to include. Expected format is YYYY-MM-DD.
  • certification.lte (str) – Only include movies with this certification and lower. Expected value is a valid certification for the specificed ‘certification_country’.
  • with_companies (str) – Filter movies to include a specific company. Expected value is an integer (the id of a company). They can be comma separated to indicate an ‘AND’ query.
  • year (str) – Filter the results release dates to matches that include this value. Expected value is a year.
  • page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.discover_movie(<parameters>)
{u'page': 1,
 u'results': [{u'adult': False,
               u'backdrop_path': u'/cKw3HY835PMp6bzse3LMivIY5Nl.jpg',
               u'id': 1884,
               u'original_title': u'The Ewok Adventure',
               u'popularity': 0.72905031478,
               u'poster_path': u'/x2nKP0FCJwNLHgCyUI1cL8bF6nL.jpg',
               u'release_date': u'1984-11-25',
               u'title': u'The Ewok Adventure',
               u'vote_average': 10.0,
               u'vote_count': 4},
              {u'adult': False,
               u'backdrop_path': u'/s0LjxgmzKdTny2CiuHNBjV8urmf.jpg',
               u'id': 1537,
               u'original_title': u'Changing Lanes',
               u'popularity': 1.1399252536936,
               u'poster_path': u'/bbINOtOFyQFAtaKo0fdMKXB1Og5.jpg',
               u'release_date': u'2002-04-07',
               u'title': u'Changing Lanes',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/39R1ItA8srBv07z3ZG6MUA3uD2p.jpg',
               u'id': 1672,
               u'original_title': u'Le Professionnel',
               u'popularity': 1.55987,
               u'poster_path': u'/A7Yjc5a1DTvijtaQG08h8ufDQKA.jpg',
               u'release_date': u'1981-10-21',
               u'title': u'The Professional',
               u'vote_average': 10.0,
               u'vote_count': 2},
              {u'adult': False,
               u'backdrop_path': u'/7dJLUyCSlYbz822I7FGRrql7gpB.jpg',
               u'id': 8427,
               u'original_title': u'I Spy',
               u'popularity': 1.06413962734445,
               u'poster_path': u'/22nUxAkL42Snd8azTlUrpDDtBSh.jpg',
               u'release_date': u'2002-10-31',
               u'title': u'I Spy',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/rUPLEQWvCsYYj8z4vPx1QnezDX5.jpg',
               u'id': 16364,
               u'original_title': u'Robotech: The Shadow Chronicles',
               u'popularity': 1.152820462,
               u'poster_path': u'/eFRVAKXc31AbsbIJ6JL0QuWTgPe.jpg',
               u'release_date': u'2007-09-19',
               u'title': u'Robotech: The Shadow Chronicles',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/oiix1SXcy7i3MitqVJor1o9ZSUv.jpg',
               u'id': 17264,
               u'original_title': u'The Black Stallion',
               u'popularity': 0.582087308,
               u'poster_path': u'/hznqiRVJqwfg0rSMulyRSpXuvGb.jpg',
               u'release_date': u'1979-10-17',
               u'title': u'The Black Stallion',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/q6CLnjffLrUkfjOuIv3vbhYGAwN.jpg',
               u'id': 11176,
               u'original_title': u'The Muppet Movie',
               u'popularity': 0.834,
               u'poster_path': u'/48Ve7uLDcPJFGaDnmYYdcV3Ve1M.jpg',
               u'release_date': u'1979-05-31',
               u'title': u'The Muppet Movie',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/oY5ujxy7jJ8hiHXO8FA39JAKjiy.jpg',
               u'id': 10339,
               u'original_title': u'Moby Dick',
               u'popularity': 0.58,
               u'poster_path': u'/i8u9Gw4EDESLiC902bDQ9MuWg6O.jpg',
               u'release_date': u'1956-06-27',
               u'title': u'Moby Dick',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/nQx2Ks3Sl82BygE71BgyaHFlo1a.jpg',
               u'id': 10109,
               u'original_title': u'Fei hap siu baak lung',
               u'popularity': 0.44,
               u'poster_path': u'/JPI3wpmRqYaqv7ey3QnjaVb0ZW.jpg',
               u'release_date': u'2004-10-28',
               u'title': u'The White Dragon',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/fWh5gHBl6e9W0bIGEcEaAqgsj5.jpg',
               u'id': 11570,
               u'original_title': u'The Crimson Pirate',
               u'popularity': 0.4322,
               u'poster_path': u'/aysnvyXlpqiEPkCn1bbiBqZIgCg.jpg',
               u'release_date': u'1952-09-27',
               u'title': u'The Crimson Pirate',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/nwhHlNlvYj589KpOiX0pzVbbkf6.jpg',
               u'id': 11616,
               u'original_title': u'Nati con la camicia',
               u'popularity': 1.001322002,
               u'poster_path': u'/gmb1nA58ZH12cGUFMBoR6UDDb0j.jpg',
               u'release_date': u'1982-12-31',
               u'title': u'Go for It',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/nBz9PJerPhqghjqObFRW0PnaOyA.jpg',
               u'id': 12097,
               u'original_title': u'Pippi L\xe5ngstrump',
               u'popularity': 0.545992,
               u'poster_path': u'/dQwrHaxbM3eAoQQgZakzHKmj8Xh.jpg',
               u'release_date': u'1969-05-09',
               u'title': u'Pippi Longstocking',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/7iQoI61oUOr8tiphzuE4dvUZLCE.jpg',
               u'id': 11385,
               u'original_title': u'Hatari!',
               u'popularity': 0.98,
               u'poster_path': u'/mJwf9AvwjJaopgK8AkQt6dW6Nh.jpg',
               u'release_date': u'1962-06-19',
               u'title': u'Hatari!',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/ivm5T3xOGgG3Tvb8m4ExLBb7wsW.jpg',
               u'id': 11818,
               u'original_title': u'Kurtlar vadisi - Irak',
               u'popularity': 0.92,
               u'poster_path': u'/o1q1Q1R2Bf21NlfzTJiP7Su127X.jpg',
               u'release_date': u'2006-02-03',
               u'title': u'Valley of the Wolves: Iraq',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/sqIDSVlWjupKDPm37vC5mURWETw.jpg',
               u'id': 13274,
               u'original_title': u'\u30e9\u30b9\u30c8\u30aa\u30fc\u30c0\u30fc -\u30d5\u30a1\u30a4\u30ca\u30eb\u30d5\u30a1\u30f3\u30bf\u30b8\u30fcVII-',
               u'popularity': 0.2,
               u'poster_path': u'/s45WPYo7K19CdtjcMiNFORT4oRN.jpg',
               u'release_date': u'2005-09-13',
               u'title': u'Last Order: Final Fantasy VII',
               u'vote_average': 10.0,
               u'vote_count': 2},
              {u'adult': False,
               u'backdrop_path': u'/fKj7papXZq1dxnvfnxrydlsbbzt.jpg',
               u'id': 13938,
               u'original_title': u'The Last Dragon',
               u'popularity': 0.2,
               u'poster_path': u'/RZQF0DGwlC0XTYNKjNSjpkSlQn.jpg',
               u'release_date': u'1985-03-22',
               u'title': u'The Last Dragon',
               u'vote_average': 10.0,
               u'vote_count': 2},
              {u'adult': False,
               u'backdrop_path': u'/j05QW2sgHG5y3Kru1gxSxAyHNoM.jpg',
               u'id': 14597,
               u'original_title': u'Lassie',
               u'popularity': 1.332,
               u'poster_path': u'/zJOqLMWKKUxWVjfqNnuyO6BRu4r.jpg',
               u'release_date': u'2005-12-16',
               u'title': u'Lassie',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': u'/c0i7MxnHADv9MAiEtl7mHCqcNd4.jpg',
               u'id': 15012,
               u'original_title': u'Linewatch',
               u'popularity': 0.711408006785931,
               u'poster_path': u'/nV99lWYgqyyGn61dIHt4LrZbXWY.jpg',
               u'release_date': u'2008-01-01',
               u'title': u'Linewatch',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': None,
               u'id': 18497,
               u'original_title': u'Exils',
               u'popularity': 0.2,
               u'poster_path': u'/cyBz3PzzmkUnjOq8XbIq0NxlX9i.jpg',
               u'release_date': u'2004-05-19',
               u'title': u'Exiles',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'adult': False,
               u'backdrop_path': None,
               u'id': 23191,
               u'original_title': u'The 9 Ball Diaries',
               u'popularity': 0.4,
               u'poster_path': u'/wyDPW7A7l31xH7FVMNQRRFVT1aa.jpg',
               u'release_date': u'2008-10-07',
               u'title': u'The 9 Ball Diaries',
               u'vote_average': 10.0,
               u'vote_count': 1}],
 u'total_pages': 204,
 u'total_results': 4066}
discover_tv(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • vote_average.gte (str) – Only include TV shows that are equal to, or have a higher average rating than this value. Expected value is a float.
  • first_air_date.gte (str) – The minimum release to include. Expected format is YYYY-MM-DD.
  • first_air_date_year (str) – Filter the results release dates to matches that include this value. Expected value is a year.
  • language (str) – ISO 639-1 code.
  • with_genres (str) – Only include TV shows with the specified genres. Expected value is an integer (the id of a genre). Multiple values can be specified. Comma separated indicates an ‘AND’ query, while a pipe (|) separated value indicates an ‘OR’.
  • vote_count.gte (str) – Only include TV shows that are equal to, or have a vote count higher than this value. Expected value is an integer.
  • with_networks (str) – Filter TV shows to include a specific network. Expected value is an integer (the id of a network). They can be comma separated to indicate an ‘AND’ query.
  • sort_by (str) – Available options are vote_average.desc, vote_average.asc, first_air_date.desc, first_air_date.asc, popularity.desc, popularity.asc
  • first_air_date.lte (str) – The maximum release to include. Expected format is YYYY-MM-DD.
  • page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.discover_tv(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/A9jyYzO8XEogAHV7LBxF2vWAAXj.jpg',
               u'first_air_date': u'1999-01-31',
               u'id': 1434,
               u'name': u'Family Guy',
               u'original_name': u'Family Guy',
               u'popularity': 13.790419427048,
               u'poster_path': u'/n3UBzIx28m3FpC2EDwVJIjvPxnl.jpg',
               u'vote_average': 8.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/6tL4eiGmXJZI2eMWh1rgHdv58kb.jpg',
               u'first_air_date': u'1996-07-22',
               u'id': 2224,
               u'name': u'The Daily Show',
               u'original_name': u'The Daily Show',
               u'popularity': 13.4722825949149,
               u'poster_path': u'/pnQmYxMlJBvnyFElFHbzsPlOUUx.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/gyjHOqa3UhJ6XcKhSSLAlZV38Dl.jpg',
               u'first_air_date': u'2011-04-17',
               u'id': 1399,
               u'name': u'Game of Thrones',
               u'original_name': u'Game of Thrones',
               u'popularity': 10.2458449125787,
               u'poster_path': u'/97p6ypjCkiqxNc1b44oO630IMmn.jpg',
               u'vote_average': 9.38888888888889,
               u'vote_count': 9},
              {u'backdrop_path': u'/knB3yzqu3ofy1mR9A3oREijnU7e.jpg',
               u'first_air_date': u'1994-09-19',
               u'id': 4588,
               u'name': u'ER',
               u'original_name': u'ER',
               u'popularity': 9.89607208948336,
               u'poster_path': u'/qnllIuJI11tskEolTd3QsbR0TuC.jpg',
               u'vote_average': 6.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/fxX3PtHJBj18QJ31jUMNelMKGDe.jpg',
               u'first_air_date': u'2004-11-16',
               u'id': 1408,
               u'name': u'House',
               u'original_name': u'House',
               u'popularity': 9.19286324052243,
               u'poster_path': u'/j2Ny9P6RY9i3lfxdyePEUVSN4o5.jpg',
               u'vote_average': 8.33333333333333,
               u'vote_count': 3},
              {u'backdrop_path': u'/oxxDLIIUfLUANRiK7fhPuKOlKpz.jpg',
               u'first_air_date': u'1959-10-02',
               u'id': 6357,
               u'name': u'The Twilight Zone',
               u'original_name': u'The Twilight Zone',
               u'popularity': 9.16107665720407,
               u'poster_path': u'/zj7T398lYzWFMH4yWdm7g0elUAI.jpg',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/dRaV8HGx7Z9xmw77qSs8prp5OuI.jpg',
               u'first_air_date': u'2008-01-20',
               u'id': 1396,
               u'name': u'Breaking Bad',
               u'original_name': u'Breaking Bad',
               u'popularity': 8.45479759011426,
               u'poster_path': u'/j5k6ZTYqamPDZplCCXuokjJ2PoJ.jpg',
               u'vote_average': 8.875,
               u'vote_count': 12},
              {u'backdrop_path': u'/dzlh310N8QfUDqgoo0CO7r3hThp.jpg',
               u'first_air_date': u'2002-06-03',
               u'id': 2097,
               u'name': u'Crank Yankers',
               u'original_name': u'Crank Yankers',
               u'popularity': 7.32,
               u'poster_path': u'/jtU36qpj08j7yVmMklwawQFHFyj.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/wY9tYxyhFRDGkQIFGpk4VkVsiXR.jpg',
               u'first_air_date': u'1989-12-17',
               u'id': 456,
               u'name': u'The Simpsons',
               u'original_name': u'The Simpsons',
               u'popularity': 7.29736254806427,
               u'poster_path': u'/oadXgs77zoLQm04J9dG4fQ3Huwn.jpg',
               u'vote_average': 8.3,
               u'vote_count': 5},
              {u'backdrop_path': u'/xoAZmXIULNTZFRQTimeV7e84zxt.jpg',
               u'first_air_date': u'1979-08-24',
               u'id': 1803,
               u'name': u'The Facts of Life',
               u'original_name': u'The Facts of Life',
               u'popularity': 7.0088,
               u'poster_path': u'/9UqHOIl3nnzsCUobMCfgnhkwi7L.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/7P1HSNGCeMAM4hoMjATzlZ1wfOg.jpg',
               u'first_air_date': u'2000-10-06',
               u'id': 1431,
               u'name': u'CSI: Crime Scene Investigation',
               u'original_name': u'CSI: Crime Scene Investigation',
               u'popularity': 6.81113734071392,
               u'poster_path': u'/5W2qOtSh52ZgJTiaioEsmnbp2xu.jpg',
               u'vote_average': 4.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/8ISefhDLp5WBdIgJrauvvchSNzp.jpg',
               u'first_air_date': u'2001-11-06',
               u'id': 1973,
               u'name': u'24',
               u'original_name': u'24',
               u'popularity': 6.62384520295129,
               u'poster_path': u'/8MkrR4VhXuq1OunAx6ONdoRN1iL.jpg',
               u'vote_average': 7.5,
               u'vote_count': 3},
              {u'backdrop_path': u'/6BVPbctq0RVCtjiopUddIoqHyR6.jpg',
               u'first_air_date': u'1999-09-22',
               u'id': 4461,
               u'name': u'Rove',
               u'original_name': u'Rove',
               u'popularity': 6.5164717206,
               u'poster_path': u'/5ZuXifDbgvl3XHVSXNUBVskSmQf.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/kgadTwNJYYGZ7LTrw9X7KDiRCfV.jpg',
               u'first_air_date': u'2006-10-01',
               u'id': 1405,
               u'name': u'Dexter',
               u'original_name': u'Dexter',
               u'popularity': 6.30021577329623,
               u'poster_path': u'/eIoAzf9czDSWqYneE1fZTQ3iJhB.jpg',
               u'vote_average': 8.64285714285714,
               u'vote_count': 7},
              {u'backdrop_path': u'/kL9nHBwMfFsVWROL8hRpSVGNigp.jpg',
               u'first_air_date': u'2007-07-24',
               u'id': 4920,
               u'name': u'Damages',
               u'original_name': u'Damages',
               u'popularity': 5.981,
               u'poster_path': u'/6hcca4kh8XhUI5bSc7Em8SJz5jp.jpg',
               u'vote_average': 7.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/m9Vf8V4j9P6oiVgeCPbC1YObaa3.jpg',
               u'first_air_date': u'1997-01-12',
               u'id': 2122,
               u'name': u'King of the Hill',
               u'original_name': u'King of the Hill',
               u'popularity': 5.83303019806081,
               u'poster_path': u'/r6dIrTjWLE3GfcTZzrDYikt6YDn.jpg',
               u'vote_average': 3.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/ghyPciT8yfUDTvVjw8xunO6S5ha.jpg',
               u'first_air_date': u'1999-09-20',
               u'id': 2734,
               u'name': u'Law & Order: Special Victims Unit',
               u'original_name': u'Law & Order: Special Victims Unit',
               u'popularity': 5.81079859264717,
               u'poster_path': u'/tsxiLPFlpNlJaMFlKIFqffGkiJt.jpg',
               u'vote_average': 8.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/ikUfFMLSU47N9PXRGb91cO6VPFn.jpg',
               u'first_air_date': u'1987-09-28',
               u'id': 655,
               u'name': u'Star Trek: The Next Generation',
               u'original_name': u'Star Trek: The Next Generation',
               u'popularity': 5.7932029846227,
               u'poster_path': u'/lLOFWqf93nZQiwEW0g8aXdEZgp6.jpg',
               u'vote_average': 7.25,
               u'vote_count': 2},
              {u'backdrop_path': u'/odkSy8k2ukwQiaV6IbwgiIitQ3F.jpg',
               u'first_air_date': u'2006-03-12',
               u'id': 4392,
               u'name': u'Big Love',
               u'original_name': u'Big Love',
               u'popularity': 5.66592090311432,
               u'poster_path': u'/vkmApTL7BDUYjIoPPWbTNH7bUPc.jpg',
               u'vote_average': 7.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/fbYSM5VXo9Gaq8V6vlCSv6KRHlx.jpg',
               u'first_air_date': u'2007-09-24',
               u'id': 1418,
               u'name': u'The Big Bang Theory',
               u'original_name': u'The Big Bang Theory',
               u'popularity': 5.51313041118904,
               u'poster_path': u'/mYOWdfjuYqiZC1VS2SPefW3g38Q.jpg',
               u'vote_average': 7.70833333333333,
               u'vote_count': 12}],
 u'total_pages': 3027,
 u'total_results': 60530}
find(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • external_source (str) –
  • id (int) –

Optional

Parameters:language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.find(<parameters>)
{u'movie_results': [{u'adult': False,
                     u'backdrop_path': u'/n2vIGWw4ezslXjlP0VNxkp9wqwU.jpg',
                     u'id': 12,
                     u'original_title': u'Finding Nemo',
                     u'popularity': 7.86452701328177,
                     u'poster_path': u'/zjqInUwldOBa0q07fOyohYCWxWX.jpg',
                     u'release_date': u'2003-05-30',
                     u'title': u'Finding Nemo',
                     u'vote_average': 7.0,
                     u'vote_count': 1790}],
 u'person_results': [],
 u'tv_results': []}
genre_list(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.genre_list(<parameters>)
{u'genres': [{u'id': 28, u'name': u'Action'},
             {u'id': 12, u'name': u'Adventure'},
             {u'id': 16, u'name': u'Animation'},
             {u'id': 35, u'name': u'Comedy'},
             {u'id': 80, u'name': u'Crime'},
             {u'id': 105, u'name': u'Disaster'},
             {u'id': 99, u'name': u'Documentary'},
             {u'id': 18, u'name': u'Drama'},
             {u'id': 82, u'name': u'Eastern'},
             {u'id': 2916, u'name': u'Erotic'},
             {u'id': 10751, u'name': u'Family'},
             {u'id': 10750, u'name': u'Fan Film'},
             {u'id': 14, u'name': u'Fantasy'},
             {u'id': 10753, u'name': u'Film Noir'},
             {u'id': 10769, u'name': u'Foreign'},
             {u'id': 36, u'name': u'History'},
             {u'id': 10595, u'name': u'Holiday'},
             {u'id': 27, u'name': u'Horror'},
             {u'id': 10756, u'name': u'Indie'},
             {u'id': 10402, u'name': u'Music'},
             {u'id': 22, u'name': u'Musical'},
             {u'id': 9648, u'name': u'Mystery'},
             {u'id': 10754, u'name': u'Neo-noir'},
             {u'id': 1115, u'name': u'Road Movie'},
             {u'id': 10749, u'name': u'Romance'},
             {u'id': 878, u'name': u'Science Fiction'},
             {u'id': 10755, u'name': u'Short'},
             {u'id': 9805, u'name': u'Sport'},
             {u'id': 10758, u'name': u'Sporting Event'},
             {u'id': 10757, u'name': u'Sports Film'},
             {u'id': 10748, u'name': u'Suspense'},
             {u'id': 10770, u'name': u'TV movie'},
             {u'id': 53, u'name': u'Thriller'},
             {u'id': 10752, u'name': u'War'},
             {u'id': 37, u'name': u'Western'}]}
genre_movies(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • include_adult (str) – Toggle the inclusion of adult titles. Expected value is: true or false
  • include_all_movies (str) – Toggle the inclusion of all movies and not just those with 10 or more ratings. Expected value is: true or false
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.genre_movies(<parameters>)
{u'id': 18,
 u'page': 1,
 u'results': [{u'backdrop_path': u'/6xKCYgH16UuwEGAyroLU6p8HLIn.jpg',
               u'id': 238,
               u'original_title': u'The Godfather',
               u'poster_path': u'/d4KNaTrltq6bpkFS01pYtyXa09m.jpg',
               u'release_date': u'1972-03-24',
               u'title': u'The Godfather',
               u'vote_average': 9.2,
               u'vote_count': 125},
              {u'backdrop_path': u'/3R6vDW1yBBzejsma8SzzWuxj2AE.jpg',
               u'id': 311,
               u'original_title': u'Once Upon a Time in America',
               u'poster_path': u'/fqP3Q7DWMFqW7mh11hWXbNwN9rz.jpg',
               u'release_date': u'1984-02-17',
               u'title': u'Once Upon a Time in America',
               u'vote_average': 9.1,
               u'vote_count': 34},
              {u'backdrop_path': u'/jWDegvAE8XO2XDUHP9eQYlepJv1.jpg',
               u'id': 240,
               u'original_title': u'The Godfather: Part II',
               u'poster_path': u'/tHbMIIF51rguMNSastqoQwR0sBs.jpg',
               u'release_date': u'1974-12-20',
               u'title': u'The Godfather: Part II',
               u'vote_average': 9.1,
               u'vote_count': 61},
              {u'backdrop_path': u'/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg',
               u'id': 550,
               u'original_title': u'Fight Club',
               u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
               u'release_date': u'1999-10-15',
               u'title': u'Fight Club',
               u'vote_average': 9.1,
               u'vote_count': 175},
              {u'backdrop_path': u'/mpYypl40Wg2njmuflqEC3Bs3cFB.jpg',
               u'id': 19,
               u'original_title': u'Metropolis',
               u'poster_path': u'/6oyiv4kiTtroUr42H4kqNwg60rj.jpg',
               u'release_date': u'1927-03-13',
               u'title': u'Metropolis',
               u'vote_average': 9.0,
               u'vote_count': 23},
              {u'backdrop_path': u'/AplR1QRswlXiM65GoifX8sDadME.jpg',
               u'id': 213,
               u'original_title': u'North by Northwest',
               u'poster_path': u'/rEHP8ylmL3pcsDUEA6Z5qhajYui.jpg',
               u'release_date': u'1959-07-17',
               u'title': u'North by Northwest',
               u'vote_average': 9.0,
               u'vote_count': 28},
              {u'backdrop_path': u'/qrI7ZgBgBMIsJSbhyezrfP44frb.jpg',
               u'id': 670,
               u'original_title': u'\uc62c\ub4dc\ubcf4\uc774',
               u'poster_path': u'/jB7ol6ry8dlqMp6kKlKHLfPke4e.jpg',
               u'release_date': u'2003-11-21',
               u'title': u'Oldboy',
               u'vote_average': 9.0,
               u'vote_count': 45},
              {u'backdrop_path': u'/fRQATr704bMpLc5Skzpj3V9b2iW.jpg',
               u'id': 197,
               u'original_title': u'Braveheart',
               u'poster_path': u'/4T4xQJXSdTNbzUrlT6Eh13kiy5H.jpg',
               u'release_date': u'1995-05-24',
               u'title': u'Braveheart',
               u'vote_average': 9.0,
               u'vote_count': 65},
              {u'backdrop_path': u'/8BPZO0Bf8TeAy8znF43z8soK3ys.jpg',
               u'id': 122,
               u'original_title': u'The Lord of the Rings: The Return of the King',
               u'poster_path': u'/j6NCjU6Zh7SkfIeN5zDaoTmBn4m.jpg',
               u'release_date': u'2003-12-17',
               u'title': u'The Lord of the Rings: The Return of the King',
               u'vote_average': 9.0,
               u'vote_count': 135},
              {u'backdrop_path': u'/tv8J6uCTKsTlASa8luJqrFiJlBX.jpg',
               u'id': 78,
               u'original_title': u'Blade Runner',
               u'poster_path': u'/ewq1lwhOT8GqBcQH1w8D1BagwTh.jpg',
               u'release_date': u'1982-06-25',
               u'title': u'Blade Runner',
               u'vote_average': 9.0,
               u'vote_count': 147},
              {u'backdrop_path': u'/xBKGJQsAIeweesB79KC89FpBrVr.jpg',
               u'id': 278,
               u'original_title': u'The Shawshank Redemption',
               u'poster_path': u'/9O7gLzmreU0nGkIB6K3BsJbzvNv.jpg',
               u'release_date': u'1994-09-14',
               u'title': u'The Shawshank Redemption',
               u'vote_average': 9.0,
               u'vote_count': 173},
              {u'backdrop_path': u'/8oCkj3t9yvT363svYMssXqGxTRf.jpg',
               u'id': 824,
               u'original_title': u'Moulin Rouge!',
               u'poster_path': u'/vgYM0ZDoeQKZEGxrGAO221J5rIG.jpg',
               u'release_date': u'2001-05-16',
               u'title': u'Moulin Rouge!',
               u'vote_average': 8.9,
               u'vote_count': 11},
              {u'backdrop_path': u'/6yFtd1s69XRTGIOD6yIoZ3EebKx.jpg',
               u'id': 7549,
               u'original_title': u'Fearless',
               u'poster_path': u'/5gqM2IUANPvM5JnB4m5wePhH3Nt.jpg',
               u'release_date': u'2006-01-26',
               u'title': u'Fearless',
               u'vote_average': 8.9,
               u'vote_count': 18},
              {u'backdrop_path': u'/xATZyEpnZ0Z0iO9z5K8RZsraGKI.jpg',
               u'id': 840,
               u'original_title': u'Close Encounters of the Third Kind',
               u'poster_path': u'/mABOVIUl5lB0WF4HG28rfamgxG1.jpg',
               u'release_date': u'1977-11-16',
               u'title': u'Close Encounters of the Third Kind',
               u'vote_average': 8.9,
               u'vote_count': 19},
              {u'backdrop_path': u'/tEm71iwofHgNcqb0Fn1AyH11BNl.jpg',
               u'id': 11036,
               u'original_title': u'The Notebook',
               u'poster_path': u'/gMfstesBXKdsHToAUXVPHujUDfb.jpg',
               u'release_date': u'2004-06-25',
               u'title': u'The Notebook',
               u'vote_average': 8.9,
               u'vote_count': 20},
              {u'backdrop_path': u'/mtJrV7i76PtXJMmWz3tu6dWav6n.jpg',
               u'id': 510,
               u'original_title': u"One Flew Over the Cuckoo's Nest",
               u'poster_path': u'/bYZumDpc1o0adyuAZjXqgkZ182m.jpg',
               u'release_date': u'1975-11-19',
               u'title': u"One Flew Over the Cuckoo's Nest",
               u'vote_average': 8.9,
               u'vote_count': 38},
              {u'backdrop_path': u'/xDEOxA01480uLTWuvQCw61VmDBt.jpg',
               u'id': 769,
               u'original_title': u'Goodfellas',
               u'poster_path': u'/ddMDzejWFbSas5ipUCUCjAlD5dI.jpg',
               u'release_date': u'1990-09-12',
               u'title': u'Goodfellas',
               u'vote_average': 8.9,
               u'vote_count': 39},
              {u'backdrop_path': u'/9yJehIjvR7ULOLxeDJoth4kDDNe.jpg',
               u'id': 5915,
               u'original_title': u'Into the Wild',
               u'poster_path': u'/lHyYgaocXR6KcJLxVmxZDj115hH.jpg',
               u'release_date': u'2007-09-21',
               u'title': u'Into the Wild',
               u'vote_average': 8.9,
               u'vote_count': 41},
              {u'backdrop_path': u'/k4BAPrE5WkNLvpsPsiMfu8W4Zyi.jpg',
               u'id': 598,
               u'original_title': u'Cidade de Deus',
               u'poster_path': u'/gCqnQaq8T4CfioP9uETLx9iMJF4.jpg',
               u'release_date': u'2002-05-18',
               u'title': u'City of God',
               u'vote_average': 8.9,
               u'vote_count': 41},
              {u'backdrop_path': u'/ooqPNPS2WdBH7DgIF4em9e0nEld.jpg',
               u'id': 857,
               u'original_title': u'Saving Private Ryan',
               u'poster_path': u'/35CMz4t7PuUiQqt5h4u5nbrXZlF.jpg',
               u'release_date': u'1998-07-24',
               u'title': u'Saving Private Ryan',
               u'vote_average': 8.9,
               u'vote_count': 83}],
 u'total_pages': 25,
 u'total_results': 499}
job_list(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Usage:
>>> api = tmdb.API(api_key)
>>> api.job_list(<parameters>)
{u'jobs': [{u'department': u'Writing',
            u'job_list': [u'Screenplay',
                          u'Author',
                          u'Novel',
                          u'Characters',
                          u'Theatre Play',
                          u'Adaptation',
                          u'Dialogue',
                          u'Writer',
                          u'Other',
                          u'Storyboard',
                          u'Original Story',
                          u'Scenario Writer',
                          u'Screenstory',
                          u'Musical',
                          u'Idea',
                          u'Story',
                          u'Creative Producer',
                          u'Teleplay',
                          u'Texte',
                          u'Opera',
                          u'Co-Writer']},
           {u'department': u'Directing',
            u'job_list': [u'Director',
                          u'Script Supervisor',
                          u'Other',
                          u'Layout',
                          u'Script Coordinator',
                          u'Special Guest Director']},
           {u'department': u'Actors',
            u'job_list': [u'Actor',
                          u'Stunt Double',
                          u'Voice',
                          u'Cameo',
                          u'Special Guest']},
           {u'department': u'Camera',
            u'job_list': [u'Director of Photography',
                          u'Underwater Camera',
                          u'Camera Operator',
                          u'Still Photographer',
                          u'Camera Department Manager',
                          u'Camera Supervisor',
                          u'Camera Technician',
                          u'Other',
                          u'Grip',
                          u'Steadicam Operator',
                          u'Additional Camera',
                          u'Camera Intern',
                          u'Additional Photography',
                          u'Helicopter Camera']},
           {u'department': u'Editing',
            u'job_list': [u'Editor',
                          u'Supervising Film Editor',
                          u'Additional Editing',
                          u'Editorial Manager',
                          u'First Assistant Editor',
                          u'Additional Editorial Assistant',
                          u'Editorial Coordinator',
                          u'Editorial Production Assistant',
                          u'Editorial Services',
                          u'Dialogue Editor',
                          u'Archival Footage Coordinator',
                          u'Archival Footage Research',
                          u'Color Timer',
                          u'Digital Intermediate',
                          u'Other']},
           {u'department': u'Art',
            u'job_list': [u'Production Design',
                          u'Art Direction',
                          u'Set Decoration',
                          u'Set Designer',
                          u'Conceptual Design',
                          u'Interior Designer',
                          u'Settings',
                          u'Assistant Art Director',
                          u'Art Department Coordinator',
                          u'Other',
                          u'Art Department Manager',
                          u'Sculptor',
                          u'Art Department Assistant',
                          u'Background Designer',
                          u'Co-Art Director',
                          u'Set Decoration Buyer',
                          u'Production Illustrator',
                          u'Standby Painter',
                          u'Location Scout',
                          u'Leadman',
                          u'Greensman',
                          u'Gun Wrangler',
                          u'Construction Coordinator',
                          u'Construction Foreman',
                          u'Lead Painter',
                          u'Sign Painter']},
           {u'department': u'Costume & Make-Up',
            u'job_list': [u'Costume Design',
                          u'Makeup Artist',
                          u'Hairstylist',
                          u'Set Dressing Artist',
                          u'Set Dressing Supervisor',
                          u'Set Dressing Manager',
                          u'Set Dressing Production Assistant',
                          u'Facial Setup Artist',
                          u'Hair Setup',
                          u'Costume Supervisor',
                          u'Set Costumer',
                          u'Makeup Department Head',
                          u'Wigmaker',
                          u'Maske',
                          u'Shoe Design',
                          u'Other',
                          u'Co-Costume Designer']},
           {u'department': u'Production',
            u'job_list': [u'Producer',
                          u'Executive Producer',
                          u'Casting',
                          u'Production Manager',
                          u'Unit Production Manager',
                          u'Line Producer',
                          u'Location Manager',
                          u'Other',
                          u'Production Supervisor',
                          u'Production Accountant',
                          u'Production Office Coordinator',
                          u'Finance',
                          u'Executive Consultant',
                          u'Character Technical Supervisor',
                          u'Development Manager',
                          u'Administration',
                          u'Executive In Charge Of Post Production',
                          u'Herstellungsleitung',
                          u'Produzent',
                          u'Production Director',
                          u'Executive In Charge Of Production',
                          u'Publicist']},
           {u'department': u'Sound',
            u'job_list': [u'Original Music Composer',
                          u'Sound Designer',
                          u'Sound Editor',
                          u'Sound Director',
                          u'Sound mixer',
                          u'Music Editor',
                          u'Sound Effects Editor',
                          u'Production Sound Mixer',
                          u'Additional Soundtrack',
                          u'Supervising Sound Editor',
                          u'Supervising Sound Effects Editor',
                          u'Sound Re-Recording Mixer',
                          u'Recording Supervision',
                          u'Boom Operator',
                          u'Sound Montage Associate',
                          u'Songs',
                          u'Music',
                          u'ADR & Dubbing',
                          u'Sound Engineer',
                          u'Foley',
                          u'Additional Music Supervisor',
                          u'First Assistant Sound Editor',
                          u'Scoring Mixer',
                          u'Dolby Consultant',
                          u'Tonbearbeitung',
                          u'Other']},
           {u'department': u'Visual Effects',
            u'job_list': [u'Animation',
                          u'Visual Effects',
                          u'Chief Technician / Stop-Motion Expert',
                          u'Creature Design',
                          u'Shading',
                          u'Modeling',
                          u'CG Painter',
                          u'Visual Development',
                          u'Animation Manager',
                          u'Animation Director',
                          u'Fix Animator',
                          u'Animation Department Coordinator',
                          u'Animation Fix Coordinator',
                          u'Animation Production Assistant',
                          u'Visual Effects Supervisor',
                          u'Mechanical & Creature Designer',
                          u'Battle Motion Coordinator',
                          u'Animation Supervisor',
                          u'VFX Supervisor',
                          u'Cloth Setup',
                          u'VFX Artist',
                          u'CG Engineer',
                          u'24 Frame Playback',
                          u'Imaging Science',
                          u'I/O Supervisor',
                          u'Visual Effects Producer',
                          u'VFX Production Coordinator',
                          u'I/O Manager',
                          u'Additional Effects Development',
                          u'Color Designer',
                          u'Simulation & Effects Production Assistant',
                          u'Simulation & Effects Artist']},
           {u'department': u'Crew',
            u'job_list': [u'Special Effects',
                          u'Post Production Supervisor',
                          u'Second Unit',
                          u'Choreographer',
                          u'Stunts',
                          u'Sound Recordist',
                          u'Stunt Coordinator',
                          u'Special Effects Coordinator',
                          u'Supervising Technical Director',
                          u'Supervising Animator',
                          u'Production Artist',
                          u'Sequence Leads',
                          u'Second Film Editor',
                          u'Temp Music Editor',
                          u'Temp Sound Editor',
                          u'Sequence Supervisor',
                          u'Software Team Lead',
                          u'Software Engineer',
                          u'Documentation & Support',
                          u'Machinist',
                          u'Photoscience Manager',
                          u'Department Administrator',
                          u'Schedule Coordinator',
                          u'Supervisor of Production Resources',
                          u'Production Office Assistant',
                          u'Information Systems Manager',
                          u'Systems Administrators & Support',
                          u'Projection',
                          u'Post Production Assistant',
                          u'Sound Design Assistant',
                          u'Mix Technician',
                          u'Motion Actor',
                          u'Sets & Props Supervisor',
                          u'Compositors',
                          u'Tattooist',
                          u'Sets & Props Artist',
                          u'Motion Capture Artist',
                          u'Sequence Artist',
                          u'Mixing Engineer',
                          u'Special Sound Effects',
                          u'Post-Production Manager',
                          u'Dialect Coach',
                          u'Picture Car Coordinator',
                          u'Property Master',
                          u'Cableman',
                          u'Set Production Assistant',
                          u'Video Assist Operator',
                          u'Unit Publicist',
                          u'Set Medic',
                          u'Stand In',
                          u'Transportation Coordinator',
                          u'Transportation Captain',
                          u'Supervising Art Director',
                          u'Art Direction',
                          u'Stunts Coordinator',
                          u'Post Production Consulting',
                          u'Production Intern',
                          u'Utility Stunts',
                          u"Actor's Assistant",
                          u'Set Production Intern',
                          u'Production Controller',
                          u'Studio Teachers',
                          u'Chef',
                          u'Craft Service',
                          u'Scenic Artist',
                          u'Propmaker',
                          u'Prop Maker',
                          u'Transportation Co-Captain',
                          u'Driver',
                          u'Security',
                          u'Second Unit Cinematographer',
                          u'Loader',
                          u'Manager of Operations',
                          u'Quality Control Supervisor',
                          u'Legal Services',
                          u'Public Relations',
                          u'Score Engineer',
                          u'Translator',
                          u'Title Graphics',
                          u'Telecine Colorist',
                          u'Comic-Zeichner',
                          u'Unit Production Manager',
                          u'Unit Production Manager',
                          u'Animatronic and Prosthetic Effects',
                          u'Martial Arts Choreographer',
                          u'Cinematography',
                          u'Steadycam',
                          u'Regieassistenz',
                          u'Executive Visual Effects Producer',
                          u'Visual Effects Design Consultant',
                          u'Digital Effects Supervisor',
                          u'Digital Producer',
                          u'CG Supervisor',
                          u'Visual Effects Art Director',
                          u'Visual Effects Editor',
                          u'executive in charge of Finance',
                          u'Associate Choreographer',
                          u'Makeup Effects',
                          u'Maskenbildner',
                          u'Redaktion',
                          u'treatment',
                          u'Dramaturgie',
                          u'Lighting Camera',
                          u'Technical Supervisor',
                          u'CGI Supervisor',
                          u'Creative Consultant',
                          u'Script',
                          u'Executive Music Producer',
                          u'Tongestaltung',
                          u'Commissioning Editor',
                          u'Klimatechnik',
                          u'Tiertrainer',
                          u'Additional Writing',
                          u'Additional Music',
                          u'Poem',
                          u'Thanks',
                          u'Szenografie',
                          u'Mischung',
                          u'Titelgestaltung',
                          u'Musikmischung',
                          u'Comic-Zeichner',
                          u'Creator',
                          u'Additional Dialogue',
                          u'Video Game',
                          u'Graphic Novel Illustrator',
                          u'Other',
                          u'Series Writer',
                          u'Radio Play']},
           {u'department': u'Lighting',
            u'job_list': [u'Lighting Technician',
                          u'Best Boy Electric',
                          u'Gaffer',
                          u'Lighting Technician',
                          u'Rigging Gaffer',
                          u'Lighting Supervisor',
                          u'Lighting Manager',
                          u'Directing Lighting Artist',
                          u'Master Lighting Artist',
                          u'Lighting Artist',
                          u'Lighting Coordinator',
                          u'Lighting Production Assistant',
                          u'Best Boy Electrician',
                          u'Electrician',
                          u'Rigging Grip',
                          u'Other']}]}
keyword(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.keyword(<parameters>)
{u'id': 1721, u'name': u'fight'}
keyword_movies(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.keyword_movies(<parameters>)
{u'id': 1721,
 u'page': 1,
 u'results': [{u'backdrop_path': u'/6xKCYgH16UuwEGAyroLU6p8HLIn.jpg',
               u'id': 238,
               u'original_title': u'The Godfather',
               u'poster_path': u'/d4KNaTrltq6bpkFS01pYtyXa09m.jpg',
               u'release_date': u'1972-03-24',
               u'title': u'The Godfather',
               u'vote_average': 9.2,
               u'vote_count': 125},
              {u'backdrop_path': u'/3R6vDW1yBBzejsma8SzzWuxj2AE.jpg',
               u'id': 311,
               u'original_title': u'Once Upon a Time in America',
               u'poster_path': u'/fqP3Q7DWMFqW7mh11hWXbNwN9rz.jpg',
               u'release_date': u'1984-02-17',
               u'title': u'Once Upon a Time in America',
               u'vote_average': 9.1,
               u'vote_count': 34},
              {u'backdrop_path': u'/jWDegvAE8XO2XDUHP9eQYlepJv1.jpg',
               u'id': 240,
               u'original_title': u'The Godfather: Part II',
               u'poster_path': u'/tHbMIIF51rguMNSastqoQwR0sBs.jpg',
               u'release_date': u'1974-12-20',
               u'title': u'The Godfather: Part II',
               u'vote_average': 9.1,
               u'vote_count': 61},
              {u'backdrop_path': u'/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg',
               u'id': 550,
               u'original_title': u'Fight Club',
               u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
               u'release_date': u'1999-10-15',
               u'title': u'Fight Club',
               u'vote_average': 9.1,
               u'vote_count': 175},
              {u'backdrop_path': u'/mpYypl40Wg2njmuflqEC3Bs3cFB.jpg',
               u'id': 19,
               u'original_title': u'Metropolis',
               u'poster_path': u'/6oyiv4kiTtroUr42H4kqNwg60rj.jpg',
               u'release_date': u'1927-03-13',
               u'title': u'Metropolis',
               u'vote_average': 9.0,
               u'vote_count': 23},
              {u'backdrop_path': u'/AplR1QRswlXiM65GoifX8sDadME.jpg',
               u'id': 213,
               u'original_title': u'North by Northwest',
               u'poster_path': u'/rEHP8ylmL3pcsDUEA6Z5qhajYui.jpg',
               u'release_date': u'1959-07-17',
               u'title': u'North by Northwest',
               u'vote_average': 9.0,
               u'vote_count': 28},
              {u'backdrop_path': u'/qrI7ZgBgBMIsJSbhyezrfP44frb.jpg',
               u'id': 670,
               u'original_title': u'\uc62c\ub4dc\ubcf4\uc774',
               u'poster_path': u'/jB7ol6ry8dlqMp6kKlKHLfPke4e.jpg',
               u'release_date': u'2003-11-21',
               u'title': u'Oldboy',
               u'vote_average': 9.0,
               u'vote_count': 45},
              {u'backdrop_path': u'/fRQATr704bMpLc5Skzpj3V9b2iW.jpg',
               u'id': 197,
               u'original_title': u'Braveheart',
               u'poster_path': u'/4T4xQJXSdTNbzUrlT6Eh13kiy5H.jpg',
               u'release_date': u'1995-05-24',
               u'title': u'Braveheart',
               u'vote_average': 9.0,
               u'vote_count': 65},
              {u'backdrop_path': u'/8BPZO0Bf8TeAy8znF43z8soK3ys.jpg',
               u'id': 122,
               u'original_title': u'The Lord of the Rings: The Return of the King',
               u'poster_path': u'/j6NCjU6Zh7SkfIeN5zDaoTmBn4m.jpg',
               u'release_date': u'2003-12-17',
               u'title': u'The Lord of the Rings: The Return of the King',
               u'vote_average': 9.0,
               u'vote_count': 135},
              {u'backdrop_path': u'/tv8J6uCTKsTlASa8luJqrFiJlBX.jpg',
               u'id': 78,
               u'original_title': u'Blade Runner',
               u'poster_path': u'/ewq1lwhOT8GqBcQH1w8D1BagwTh.jpg',
               u'release_date': u'1982-06-25',
               u'title': u'Blade Runner',
               u'vote_average': 9.0,
               u'vote_count': 147},
              {u'backdrop_path': u'/xBKGJQsAIeweesB79KC89FpBrVr.jpg',
               u'id': 278,
               u'original_title': u'The Shawshank Redemption',
               u'poster_path': u'/9O7gLzmreU0nGkIB6K3BsJbzvNv.jpg',
               u'release_date': u'1994-09-14',
               u'title': u'The Shawshank Redemption',
               u'vote_average': 9.0,
               u'vote_count': 173},
              {u'backdrop_path': u'/8oCkj3t9yvT363svYMssXqGxTRf.jpg',
               u'id': 824,
               u'original_title': u'Moulin Rouge!',
               u'poster_path': u'/vgYM0ZDoeQKZEGxrGAO221J5rIG.jpg',
               u'release_date': u'2001-05-16',
               u'title': u'Moulin Rouge!',
               u'vote_average': 8.9,
               u'vote_count': 11},
              {u'backdrop_path': u'/6yFtd1s69XRTGIOD6yIoZ3EebKx.jpg',
               u'id': 7549,
               u'original_title': u'Fearless',
               u'poster_path': u'/5gqM2IUANPvM5JnB4m5wePhH3Nt.jpg',
               u'release_date': u'2006-01-26',
               u'title': u'Fearless',
               u'vote_average': 8.9,
               u'vote_count': 18},
              {u'backdrop_path': u'/xATZyEpnZ0Z0iO9z5K8RZsraGKI.jpg',
               u'id': 840,
               u'original_title': u'Close Encounters of the Third Kind',
               u'poster_path': u'/mABOVIUl5lB0WF4HG28rfamgxG1.jpg',
               u'release_date': u'1977-11-16',
               u'title': u'Close Encounters of the Third Kind',
               u'vote_average': 8.9,
               u'vote_count': 19},
              {u'backdrop_path': u'/tEm71iwofHgNcqb0Fn1AyH11BNl.jpg',
               u'id': 11036,
               u'original_title': u'The Notebook',
               u'poster_path': u'/gMfstesBXKdsHToAUXVPHujUDfb.jpg',
               u'release_date': u'2004-06-25',
               u'title': u'The Notebook',
               u'vote_average': 8.9,
               u'vote_count': 20},
              {u'backdrop_path': u'/mtJrV7i76PtXJMmWz3tu6dWav6n.jpg',
               u'id': 510,
               u'original_title': u"One Flew Over the Cuckoo's Nest",
               u'poster_path': u'/bYZumDpc1o0adyuAZjXqgkZ182m.jpg',
               u'release_date': u'1975-11-19',
               u'title': u"One Flew Over the Cuckoo's Nest",
               u'vote_average': 8.9,
               u'vote_count': 38},
              {u'backdrop_path': u'/xDEOxA01480uLTWuvQCw61VmDBt.jpg',
               u'id': 769,
               u'original_title': u'Goodfellas',
               u'poster_path': u'/ddMDzejWFbSas5ipUCUCjAlD5dI.jpg',
               u'release_date': u'1990-09-12',
               u'title': u'Goodfellas',
               u'vote_average': 8.9,
               u'vote_count': 39},
              {u'backdrop_path': u'/9yJehIjvR7ULOLxeDJoth4kDDNe.jpg',
               u'id': 5915,
               u'original_title': u'Into the Wild',
               u'poster_path': u'/lHyYgaocXR6KcJLxVmxZDj115hH.jpg',
               u'release_date': u'2007-09-21',
               u'title': u'Into the Wild',
               u'vote_average': 8.9,
               u'vote_count': 41},
              {u'backdrop_path': u'/k4BAPrE5WkNLvpsPsiMfu8W4Zyi.jpg',
               u'id': 598,
               u'original_title': u'Cidade de Deus',
               u'poster_path': u'/gCqnQaq8T4CfioP9uETLx9iMJF4.jpg',
               u'release_date': u'2002-05-18',
               u'title': u'City of God',
               u'vote_average': 8.9,
               u'vote_count': 41},
              {u'backdrop_path': u'/ooqPNPS2WdBH7DgIF4em9e0nEld.jpg',
               u'id': 857,
               u'original_title': u'Saving Private Ryan',
               u'poster_path': u'/35CMz4t7PuUiQqt5h4u5nbrXZlF.jpg',
               u'release_date': u'1998-07-24',
               u'title': u'Saving Private Ryan',
               u'vote_average': 8.9,
               u'vote_count': 83}],
 u'total_pages': 5,
 u'total_results': 84}
list(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • id (int) –
  • session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.list(<parameters>)
{u'status_code': 13,
 u'status_message': u'The item/record was deleted successfully'}
list_add_item(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • Required JSON Body (str) –
  • media_id (str) – A movie id
  • id (int) –
  • session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.list_add_item(<parameters>)
{u'status_code': 12,
 u'status_message': u'The item/record was updated successfully'}
list_item_status(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • movie_id (int) – Check to see if this movie ID (integer) is already part of a list or not.
  • id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.list_item_status(<parameters>)
{u'id': u'509ec17b19c2950a0600050d', u'item_present': True}
list_remove_item(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • Required JSON Body (str) –
  • media_id (str) – A movie id
  • id (int) –
  • session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.list_remove_item(<parameters>)
{u'status_code': 12,
 u'status_message': u'The item/record was updated successfully'}
movie(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any movie method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie(<parameters>)
{u'adult': False,
 u'backdrop_path': u'/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg',
 u'belongs_to_collection': None,
 u'budget': 63000000,
 u'genres': [{u'id': 28, u'name': u'Action'},
             {u'id': 18, u'name': u'Drama'},
             {u'id': 53, u'name': u'Thriller'}],
 u'homepage': u'',
 u'id': 550,
 u'imdb_id': u'tt0137523',
 u'original_title': u'Fight Club',
 u'overview': u'A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground "fight clubs" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion.',
 u'popularity': 61151.745,
 u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
 u'production_companies': [{u'id': 25, u'name': u'20th Century Fox'}],
 u'production_countries': [{u'iso_3166_1': u'DE', u'name': u'Germany'},
                           {u'iso_3166_1': u'US',
                            u'name': u'United States of America'}],
 u'release_date': u'1999-10-15',
 u'revenue': 100853753,
 u'runtime': 139,
 u'spoken_languages': [{u'iso_639_1': u'en', u'name': u'English'}],
 u'status': u'Released',
 u'tagline': u"How much can you know about yourself if you've never been in a fight?",
 u'title': u'Fight Club',
 u'vote_average': 9.1,
 u'vote_count': 174}
movie_account_states(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • id (int) –
  • session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_account_states(<parameters>)
{u'favorite': False,
 u'id': 550,
 u'rated': {u'value': 7.5},
 u'watchlist': False}
movie_alternative_titles(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • country (str) – ISO 3166-1 code.
  • append_to_response (str) – Comma separated, any movie method
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_alternative_titles(<parameters>)
{u'id': 550,
 u'titles': [{u'iso_3166_1': u'PL', u'title': u'Podziemny kr\u0105g'},
             {u'iso_3166_1': u'TW',
              u'title': u'\u9b25\u9663\u4ff1\u6a02\u90e8'}]}
movie_changes(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • start_date (str) – YYYY-MM-DD
  • end_date (str) – YYYY-MM-DD
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_changes(<parameters>)
{u'changes': [{u'items': [{u'action': u'created',
                           u'id': u'507436ef19c2957f27000054',
                           u'time': u'2012-10-09 14:38:39 UTC'}],
               u'key': u'general'},
              {u'items': [{u'action': u'added',
                           u'id': u'507436ef19c2957f27000055',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': u'The Duke'}],
               u'key': u'original_title'},
              {u'items': [{u'action': u'deleted',
                           u'id': u'507436f619c2957efe000048',
                           u'iso_639_1': u'en',
                           u'original_value': u'hello hello',
                           u'time': u'2012-10-09 14:38:46 UTC'},
                          {u'action': u'added',
                           u'id': u'507436ef19c2957f27000056',
                           u'iso_639_1': u'en',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': u'hello hello'}],
               u'key': u'overview'},
              {u'items': [{u'action': u'added',
                           u'id': u'507436ef19c2957f27000057',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': u'tt0196516'}],
               u'key': u'imdb_id'},
              {u'items': [{u'action': u'added',
                           u'id': u'507436ef19c2957f27000058',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': 0}],
               u'key': u'budget'},
              {u'items': [{u'action': u'added',
                           u'id': u'507436ef19c2957f27000059',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': 0}],
               u'key': u'revenue'},
              {u'items': [{u'action': u'added',
                           u'id': u'507436ef19c2957f2700005a',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': u'en'}],
               u'key': u'translations'},
              {u'items': [{u'action': u'added',
                           u'id': u'507436ef19c2957f2700005b',
                           u'iso_639_1': u'en',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': 88}],
               u'key': u'runtime'},
              {u'items': [{u'action': u'updated',
                           u'id': u'507436ef19c2957f2700005c',
                           u'time': u'2012-10-09 14:38:39 UTC',
                           u'value': False}],
               u'key': u'adult'},
              {u'items': [{u'action': u'added',
                           u'id': u'5074370019c2957efe00004c',
                           u'time': u'2012-10-09 14:38:56 UTC',
                           u'value': u'en'}],
               u'key': u'spoken_languages'},
              {u'items': [{u'action': u'added',
                           u'id': u'5074370719c2957f2700005e',
                           u'time': u'2012-10-09 14:39:03 UTC',
                           u'value': u'US'},
                          {u'action': u'added',
                           u'id': u'5074370419c29518f6000902',
                           u'time': u'2012-10-09 14:39:00 UTC',
                           u'value': u'GB'}],
               u'key': u'production_countries'},
              {u'items': [{u'action': u'added',
                           u'id': u'5074371019c2955c9c0001ee',
                           u'time': u'2012-10-09 14:39:12 UTC',
                           u'value': {u'id': 10751, u'name': u'Family'}},
                          {u'action': u'added',
                           u'id': u'5074371019c2955c9c0001ed',
                           u'time': u'2012-10-09 14:39:12 UTC',
                           u'value': {u'id': 18, u'name': u'Drama'}},
                          {u'action': u'added',
                           u'id': u'5074371019c2955c9c0001ec',
                           u'time': u'2012-10-09 14:39:12 UTC',
                           u'value': {u'id': 35, u'name': u'Comedy'}}],
               u'key': u'genres'},
              {u'items': [{u'action': u'added',
                           u'id': u'5074374b19c2957ec200004e',
                           u'time': u'2012-10-09 14:40:11 UTC',
                           u'value': {u'certification': u'G',
                                      u'iso_3166_1': u'US',
                                      u'primary': True,
                                      u'release_date': u'1999-01-01'}}],
               u'key': u'releases'},
              {u'items': [{u'action': u'added',
                           u'id': u'507437d319c2957f27000078',
                           u'time': u'2012-10-09 14:42:27 UTC',
                           u'value': {u'department': u'Sound',
                                      u'job': u'Music',
                                      u'person_id': 61247}},
                          {u'action': u'added',
                           u'id': u'507437c719c29518f600091b',
                           u'time': u'2012-10-09 14:42:15 UTC',
                           u'value': {u'department': u'Production',
                                      u'job': u'Executive Producer',
                                      u'person_id': 61244}},
                          {u'action': u'added',
                           u'id': u'507437be19c2955c9c00020c',
                           u'time': u'2012-10-09 14:42:06 UTC',
                           u'value': {u'department': u'Production',
                                      u'job': u'Executive Producer',
                                      u'person_id': 94980}},
                          {u'action': u'added',
                           u'id': u'507437b519c2955c9c000207',
                           u'time': u'2012-10-09 14:41:57 UTC',
                           u'value': {u'department': u'Production',
                                      u'job': u'Executive Producer',
                                      u'person_id': 955496}},
                          {u'action': u'added',
                           u'id': u'507437a919c295228f0012bf',
                           u'time': u'2012-10-09 14:41:45 UTC',
                           u'value': {u'department': u'Production',
                                      u'job': u'Producer',
                                      u'person_id': 950332}},
                          {u'action': u'added',
                           u'id': u'5074379b19c2955c9c000202',
                           u'time': u'2012-10-09 14:41:31 UTC',
                           u'value': {u'department': u'Writing',
                                      u'job': u'Screenplay',
                                      u'person_id': 61244}},
                          {u'action': u'added',
                           u'id': u'5074379119c295228f0012bb',
                           u'time': u'2012-10-09 14:41:21 UTC',
                           u'value': {u'department': u'Writing',
                                      u'job': u'Screenplay',
                                      u'person_id': 94980}},
                          {u'action': u'added',
                           u'id': u'5074378819c2957f2700006a',
                           u'time': u'2012-10-09 14:41:12 UTC',
                           u'value': {u'department': u'Writing',
                                      u'job': u'Screenplay',
                                      u'person_id': 1106571}},
                          {u'action': u'added',
                           u'id': u'5074378119c29518f6000911',
                           u'time': u'2012-10-09 14:41:05 UTC',
                           u'value': {u'department': u'Writing',
                                      u'job': u'Story',
                                      u'person_id': 1106570}},
                          {u'action': u'added',
                           u'id': u'5074377119c295228f0012b4',
                           u'time': u'2012-10-09 14:40:49 UTC',
                           u'value': {u'department': u'Directing',
                                      u'job': u'Director',
                                      u'person_id': 105746}}],
               u'key': u'crew'},
              {u'items': [{u'action': u'added',
                           u'id': u'5074382d19c2951aaa00055c',
                           u'time': u'2012-10-09 14:43:57 UTC',
                           u'value': {u'character': u'Basil Rathwood',
                                      u'order': 9,
                                      u'person_id': 129996}},
                          {u'action': u'added',
                           u'id': u'5074382719c29518f6000925',
                           u'time': u'2012-10-09 14:43:51 UTC',
                           u'value': {u'character': u'Lord Huffbottom',
                                      u'order': 8,
                                      u'person_id': 178914}},
                          {u'action': u'added',
                           u'id': u'5074381c19c29519b0000505',
                           u'time': u'2012-10-09 14:43:40 UTC',
                           u'value': {u'character': u'Mrs. Puddingforth',
                                      u'order': 7,
                                      u'person_id': 165458}},
                          {u'action': u'added',
                           u'id': u'5074381519c2957efe000061',
                           u'time': u'2012-10-09 14:43:33 UTC',
                           u'value': {u'character': u'Lady Fautblossom',
                                      u'order': 6,
                                      u'person_id': 41234}},
                          {u'action': u'added',
                           u'id': u'5074380e19c2955c9c000221',
                           u'time': u'2012-10-09 14:43:26 UTC',
                           u'value': {u'character': u'Shamela Stewart',
                                      u'order': 5,
                                      u'person_id': 186327}},
                          {u'action': u'added',
                           u'id': u'5074380819c2955c9c00021e',
                           u'time': u'2012-10-09 14:43:20 UTC',
                           u'value': {u'character': u'Cecil Cavendish',
                                      u'order': 4,
                                      u'person_id': 93035}},
                          {u'action': u'added',
                           u'id': u'5074380219c29518f6000921',
                           u'time': u'2012-10-09 14:43:14 UTC',
                           u'value': {u'character': u'Florian',
                                      u'order': 3,
                                      u'person_id': 98429}},
                          {u'action': u'added',
                           u'id': u'507437fc19c295228f0012ca',
                           u'time': u'2012-10-09 14:43:08 UTC',
                           u'value': {u'character': u'Charlotte',
                                      u'order': 2,
                                      u'person_id': 149837}},
                          {u'action': u'added',
                           u'id': u'507437f419c2957f2700007e',
                           u'time': u'2012-10-09 14:43:00 UTC',
                           u'value': {u'character': u'Clive Chives',
                                      u'order': 1,
                                      u'person_id': 1751}},
                          {u'action': u'added',
                           u'id': u'507437ec19c2957ec2000063',
                           u'time': u'2012-10-09 14:42:52 UTC',
                           u'value': {u'character': u'The Duke',
                                      u'order': 0,
                                      u'person_id': 12642}}],
               u'key': u'cast'}]}
movie_credits(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:append_to_response (str) – Comma separated, any movie method
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_credits(<parameters>)
{u'cast': [{u'cast_id': 4,
            u'character': u'The Narrator',
            u'id': 819,
            u'name': u'Edward Norton',
            u'order': 0,
            u'profile_path': u'/588Hrov6wwM9WcU88nJHlw2iufN.jpg'},
           {u'cast_id': 5,
            u'character': u'Tyler Durden',
            u'id': 287,
            u'name': u'Brad Pitt',
            u'order': 1,
            u'profile_path': u'/kc3M04QQAuZ9woUvH3Ju5T7ZqG5.jpg'},
           {u'cast_id': 6,
            u'character': u'Marla Singer',
            u'id': 1283,
            u'name': u'Helena Bonham Carter',
            u'order': 2,
            u'profile_path': u'/58oJPFG1wefMC0Vj7sFzHPrm67J.jpg'},
           {u'cast_id': 7,
            u'character': u"Robert 'Bob' Paulson",
            u'id': 7470,
            u'name': u'Meat Loaf',
            u'order': 3,
            u'profile_path': u'/pwNyXgegO1nlZ8uWT847JM8EjGj.jpg'},
           {u'cast_id': 8,
            u'character': u'Richard Chesler',
            u'id': 7471,
            u'name': u'Zach Grenier',
            u'order': 4,
            u'profile_path': u'/jghYiKdNkVehKpiVyE97AWrU9KQ.jpg'},
           {u'cast_id': 9,
            u'character': u'Intern',
            u'id': 7472,
            u'name': u'Richmond Arquette',
            u'order': 5,
            u'profile_path': None},
           {u'cast_id': 10,
            u'character': u'Thomas',
            u'id': 7219,
            u'name': u'David Andrews',
            u'order': 6,
            u'profile_path': u'/pxmxn29UHW9r6uvLrd7bEwLswlQ.jpg'},
           {u'cast_id': 11,
            u'character': u'Chloe',
            u'id': 7473,
            u'name': u'Rachel Singer',
            u'order': 7,
            u'profile_path': None},
           {u'cast_id': 22,
            u'character': u'The Mechanic',
            u'id': 7497,
            u'name': u'Holt McCallany',
            u'order': 8,
            u'profile_path': u'/hQBfcw9KVszdenlTZTR8AIrSpex.jpg'},
           {u'cast_id': 23,
            u'character': u'Ricky',
            u'id': 7498,
            u'name': u'Eion Bailey',
            u'order': 9,
            u'profile_path': u'/4MnRgrwuiJvHsfoiJrIUL4TkfoC.jpg'},
           {u'cast_id': 24,
            u'character': u'Angel Face',
            u'id': 7499,
            u'name': u'Jared Leto',
            u'order': 10,
            u'profile_path': u'/lzQSuu5o0JC9mCncYjVnncSH5lO.jpg'},
           {u'cast_id': 25,
            u'character': u'Lou',
            u'id': 7500,
            u'name': u'Peter Iacangelo',
            u'order': 11,
            u'profile_path': None},
           {u'cast_id': 30,
            u'character': u'Walter',
            u'id': 56112,
            u'name': u'David Lee Smith',
            u'order': 12,
            u'profile_path': u'/xYkMA9AWtUN93KV5hWzlDkcnebB.jpg'}],
 u'crew': [{u'department': u'Writing',
            u'id': 7469,
            u'job': u'Author',
            u'name': u'Jim Uhls',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 7474,
            u'job': u'Producer',
            u'name': u'Ross Grayson Bell',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 7475,
            u'job': u'Producer',
            u'name': u'Ce\xe1n Chaffin',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 1254,
            u'job': u'Producer',
            u'name': u'Art Linson',
            u'profile_path': u'/dEtVivCXxQBtIzmJcUNupT1AB4H.jpg'},
           {u'department': u'Sound',
            u'id': 7477,
            u'job': u'Original Music Composer',
            u'name': u'John King',
            u'profile_path': None},
           {u'department': u'Sound',
            u'id': 7478,
            u'job': u'Original Music Composer',
            u'name': u'Michael Simpson',
            u'profile_path': None},
           {u'department': u'Camera',
            u'id': 7479,
            u'job': u'Director of Photography',
            u'name': u'Jeff Cronenweth',
            u'profile_path': None},
           {u'department': u'Editing',
            u'id': 7480,
            u'job': u'Editor',
            u'name': u'James Haygood',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 7481,
            u'job': u'Casting',
            u'name': u'Laray Mayfield',
            u'profile_path': None},
           {u'department': u'Art',
            u'id': 1303,
            u'job': u'Production Design',
            u'name': u'Alex McDowell',
            u'profile_path': None},
           {u'department': u'Sound',
            u'id': 7763,
            u'job': u'Sound Editor',
            u'name': u'Ren Klyce',
            u'profile_path': None},
           {u'department': u'Sound',
            u'id': 7764,
            u'job': u'Sound Editor',
            u'name': u'Richard Hymns',
            u'profile_path': None},
           {u'department': u'Directing',
            u'id': 7467,
            u'job': u'Director',
            u'name': u'David Fincher',
            u'profile_path': u'/dcBHejOsKvzVZVozWJAPzYthb8X.jpg'},
           {u'department': u'Writing',
            u'id': 7468,
            u'job': u'Novel',
            u'name': u'Chuck Palahniuk',
            u'profile_path': u'/8nOJDJ6SqwV2h7PjdLBDTvIxXvx.jpg'}],
 u'id': 550}
movie_images(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • include_image_language (str) – Comma separated, a valid ISO 69-1.
  • append_to_response (str) – Comma separated, any movie method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_images(<parameters>)
{u'backdrops': [{u'aspect_ratio': 1.78,
                 u'file_path': u'/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg',
                 u'height': 720,
                 u'iso_639_1': None,
                 u'vote_average': 6.647058823529412,
                 u'vote_count': 17,
                 u'width': 1280},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/8T0hpqWsgzKhWGsXGD8ilkwRPkC.jpg',
                 u'height': 720,
                 u'iso_639_1': None,
                 u'vote_average': 6.375,
                 u'vote_count': 12,
                 u'width': 1280},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/hNFMawyNDWZKKHU4GYCBz1krsRM.jpg',
                 u'height': 720,
                 u'iso_639_1': None,
                 u'vote_average': 5.714285714285714,
                 u'vote_count': 14,
                 u'width': 1280},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/mMZRKb3NVo5ZeSPEIaNW9buLWQ0.jpg',
                 u'height': 1080,
                 u'iso_639_1': None,
                 u'vote_average': 5.5625,
                 u'vote_count': 8,
                 u'width': 1920},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/9Kr6UzouF674Smw3D9Hp2DlH1Vo.jpg',
                 u'height': 720,
                 u'iso_639_1': None,
                 u'vote_average': 5.55,
                 u'vote_count': 10,
                 u'width': 1280},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/eTVdpy2JXaGFit2V2ToZ79v9D7R.jpg',
                 u'height': 1080,
                 u'iso_639_1': None,
                 u'vote_average': 5.25,
                 u'vote_count': 12,
                 u'width': 1920},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/fuSeIUKsizmfiPIwDH7lKiFNQoD.jpg',
                 u'height': 720,
                 u'iso_639_1': None,
                 u'vote_average': 4.3,
                 u'vote_count': 5,
                 u'width': 1280}],
 u'id': 550,
 u'posters': [{u'aspect_ratio': 0.67,
               u'file_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
               u'height': 1500,
               u'iso_639_1': u'en',
               u'vote_average': 6.1395348837209305,
               u'vote_count': 43,
               u'width': 1000},
              {u'aspect_ratio': 0.71,
               u'file_path': u'/shFj1K58Tn55Qz2p2v0RqxXiXyo.jpg',
               u'height': 1408,
               u'iso_639_1': u'en',
               u'vote_average': 6.0,
               u'vote_count': 2,
               u'width': 1000},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/jQ2iUsXI2jmUcOFGjOaONCLwaVp.jpg',
               u'height': 1000,
               u'iso_639_1': u'en',
               u'vote_average': 5.546875,
               u'vote_count': 32,
               u'width': 675},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/6cMPLU1jv8pG9BMmieXCHDTVRPm.jpg',
               u'height': 2166,
               u'iso_639_1': u'es',
               u'vote_average': 5.375,
               u'vote_count': 4,
               u'width': 1479},
              {u'aspect_ratio': 0.67,
               u'file_path': u'/pKGrxTB35AkLsZCT8d8h6F9BSMN.jpg',
               u'height': 1500,
               u'iso_639_1': u'en',
               u'vote_average': 5.361111111111111,
               u'vote_count': 18,
               u'width': 1000},
              {u'aspect_ratio': 0.76,
               u'file_path': u'/5qEBvDRdY2S2CJ9tsoFktIt8Xue.jpg',
               u'height': 3539,
               u'iso_639_1': u'es',
               u'vote_average': 5.25,
               u'vote_count': 2,
               u'width': 2689},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/1dTxsr21UmFewu2CJ886JNqqkqn.jpg',
               u'height': 3000,
               u'iso_639_1': u'en',
               u'vote_average': 5.25,
               u'vote_count': 6,
               u'width': 2030},
              {u'aspect_ratio': 0.71,
               u'file_path': u'/olTEZdZJ7UKLE1o4hkFDq4jXBs8.jpg',
               u'height': 1002,
               u'iso_639_1': u'hu',
               u'vote_average': 5.25,
               u'vote_count': 2,
               u'width': 713}]}
movie_keywords(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:append_to_response (str) – Comma separated, any movie method
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_keywords(<parameters>)
{u'id': 550,
 u'keywords': [{u'id': 397, u'name': u'bare knuckle boxing'},
               {u'id': 33851, u'name': u'capitalism'},
               {u'id': 738, u'name': u'sexuality'},
               {u'id': 825, u'name': u'support group'},
               {u'id': 851, u'name': u'dual identity'},
               {u'id': 158066, u'name': u'underground'},
               {u'id': 1541, u'name': u'nihilism'},
               {u'id': 162252, u'name': u'fight'},
               {u'id': 3848, u'name': u'support'},
               {u'id': 3927, u'name': u'rage and hate'},
               {u'id': 4142, u'name': u'insomnia'},
               {u'id': 11250, u'name': u'boxing'},
               {u'id': 14681, u'name': u'martial arts'},
               {u'id': 160882, u'name': u'brawl'},
               {u'id': 17977, u'name': u'underground fighting'},
               {u'id': 19813, u'name': u'flashback'},
               {u'id': 19701, u'name': u'friendship'},
               {u'id': 158439, u'name': u' liposuction'}]}
movie_latest(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_latest(<parameters>)
{u'adult': False,
 u'backdrop_path': None,
 u'belongs_to_collection': None,
 u'budget': 0,
 u'genres': [],
 u'homepage': None,
 u'id': 133255,
 u'imdb_id': u'tt0031406',
 u'original_title': u'Harlem Rides the Range',
 u'overview': None,
 u'popularity': 0.0,
 u'poster_path': None,
 u'production_companies': [{u'id': 10747,
                            u'name': u'Hollywood Pictures Corporation'}],
 u'production_countries': [{u'iso_3166_1': u'US',
                            u'name': u'United States of America'}],
 u'release_date': u'1939-02-01',
 u'revenue': 0,
 u'runtime': None,
 u'spoken_languages': [{u'iso_639_1': u'en', u'name': u'English'}],
 u'tagline': None,
 u'title': u'Harlem Rides the Range',
 u'vote_average': 0.0,
 u'vote_count': 0}
movie_lists(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any movie method
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_lists(<parameters>)
{u'id': 578,
 u'page': 1,
 u'results': [{u'description': u"Part of the AFI 100 Years\u2026 series, AFI's 100 Years\u2026100 Thrills is a list of the top 100 heart-pounding movies in American cinema. The list was unveiled by the American Film Institute on June 12, 2001, during a CBS special hosted by Harrison Ford.",
               u'favorite_count': 2,
               u'id': u'50a510fb760ee34f2c001574',
               u'iso_639_1': u'en',
               u'item_count': 100,
               u'name': u"AFI's 100 Most Thrilling American Films",
               u'poster_path': u'/tayO4gCLyEo8Uul8FHkJGy3Kppb.jpg'}],
 u'total_pages': 1,
 u'total_results': 1}
movie_now_playing(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_now_playing(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/rCMVMFlj5uDnyVCn8ROVZBnORMT.jpg',
               u'id': 68722,
               u'original_title': u'The Master',
               u'poster_path': u'/2OxSYeydFJo7QToMGCs3cLKegk9.jpg',
               u'release_date': u'2012-09-14',
               u'title': u'The Master',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/uv5BRIaJKfcPBPEBV8qfTjD6PuY.jpg',
               u'id': 12,
               u'original_title': u'Finding Nemo',
               u'poster_path': u'/zjqInUwldOBa0q07fOyohYCWxWX.jpg',
               u'release_date': u'2003-05-30',
               u'title': u'Finding Nemo',
               u'vote_average': 8.7,
               u'vote_count': 41},
              {u'backdrop_path': u'/h4ApNjVe5z1lZzqC7i4r1jZqgha.jpg',
               u'id': 77883,
               u'original_title': u'The Possession',
               u'poster_path': u'/wHfZNSQvejeviOTdMiiC4KScYBo.jpg',
               u'release_date': u'2012-08-31',
               u'title': u'The Possession',
               u'vote_average': 7.5,
               u'vote_count': 2},
              {u'backdrop_path': u'/tH5oFO4L3NblqiOaOb70G9AbGtB.jpg',
               u'id': 83686,
               u'original_title': u'The Words',
               u'poster_path': u'/5RnIpEh829pZJyEuBz8YoP5ZR8J.jpg',
               u'release_date': u'2012-09-07',
               u'title': u'The Words',
               u'vote_average': 6.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/3ldp56QQjG1fxO3i5Kx792nlmn4.jpg',
               u'id': 82633,
               u'original_title': u'Lawless',
               u'poster_path': u'/b8UePdArknO63GSNwEUC9rj6YMe.jpg',
               u'release_date': u'2012-08-31',
               u'title': u'Lawless',
               u'vote_average': 7.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/pIjnoUnXdLpROFzIRPNziPzgBUp.jpg',
               u'id': 76163,
               u'original_title': u'The Expendables 2',
               u'poster_path': u'/kv1VxoO2Z7Pl1YoItBkvvN5Mt72.jpg',
               u'release_date': u'2012-08-17',
               u'title': u'The Expendables 2',
               u'vote_average': 8.9,
               u'vote_count': 12},
              {u'backdrop_path': u'/pGh7C7FL2uT8f0bBda2VCPYy0kY.jpg',
               u'id': 71679,
               u'original_title': u'Resident Evil: Retribution',
               u'poster_path': u'/qSVQSUKv6pdJKdXtPz4PJAcGxkv.jpg',
               u'release_date': u'2012-09-14',
               u'title': u'Resident Evil: Retribution',
               u'vote_average': 8.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/hH5nqzF6pOHBfbdte2pXfnCysWR.jpg',
               u'id': 71864,
               u'original_title': u'The Odd Life of Timothy Green',
               u'poster_path': u'/ee6rNeZi4OwItD2f7JdlaKSRXla.jpg',
               u'release_date': u'2012-08-15',
               u'title': u'The Odd Life of Timothy Green',
               u'vote_average': 6.0,
               u'vote_count': 1},
              {u'backdrop_path': None,
               u'id': 126509,
               u'original_title': u"2016: Obama's America",
               u'poster_path': u'/nV6WbxQ7GjalTQVQl5lK7GINRQA.jpg',
               u'release_date': u'2012-07-13',
               u'title': u"2016: Obama's America",
               u'vote_average': 9.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/xX3FLdfmNyQ391NQwr771cdKxZW.jpg',
               u'id': 49040,
               u'original_title': u'The Bourne Legacy',
               u'poster_path': u'/dulGeTv4d5qwF0lSxQc74nX7ksE.jpg',
               u'release_date': u'2012-08-10',
               u'title': u'The Bourne Legacy',
               u'vote_average': 7.9,
               u'vote_count': 5},
              {u'backdrop_path': u'/zTIJwzsBLt51YJK5naJKI0rTBgR.jpg',
               u'id': 77953,
               u'original_title': u'The Campaign',
               u'poster_path': u'/4LgrHV3Z5O5sh2lbqjf8BUiM0uF.jpg',
               u'release_date': u'2012-08-10',
               u'title': u'The Campaign',
               u'vote_average': 6.5,
               u'vote_count': 1},
              {u'backdrop_path': None,
               u'id': 130774,
               u'original_title': u'Last Ounce of Courage',
               u'poster_path': u'/5j82xS0H9Ggohhw58ux4SgN3c4v.jpg',
               u'release_date': u'2012-09-14',
               u'title': u'Last Ounce of Courage',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/7tkR2XE6Lh3BPufQI3JjnzW3n92.jpg',
               u'id': 82696,
               u'original_title': u'Hope Springs',
               u'poster_path': u'/9L54gLpKmftxfXxWD5fIslk1Rpy.jpg',
               u'release_date': u'2012-08-08',
               u'title': u'Hope Springs',
               u'vote_average': 3.8,
               u'vote_count': 2},
              {u'backdrop_path': u'/nLMfRZQPJFCFwB5YdLnPBCj2uho.jpg',
               u'id': 77174,
               u'original_title': u'ParaNorman',
               u'poster_path': u'/AtenrJ8HptJOOtvJJwxu4nbo3es.jpg',
               u'release_date': u'2012-08-17',
               u'title': u'ParaNorman',
               u'vote_average': 8.8,
               u'vote_count': 3},
              {u'backdrop_path': u'/abu59gFNJwru0sUEMkOHctSRgSh.jpg',
               u'id': 77948,
               u'original_title': u'The Cold Light of Day',
               u'poster_path': u'/zXhphNKS56VQbVJXqk3OMrjtNNc.jpg',
               u'release_date': u'2012-09-07',
               u'title': u'The Cold Light of Day',
               u'vote_average': 7.5,
               u'vote_count': 2},
              {u'backdrop_path': u'/lcvuQDedwXGtBOJkte0En7kamO.jpg',
               u'id': 49026,
               u'original_title': u'The Dark Knight Rises',
               u'poster_path': u'/79iOLF6sCNfHoQ7hNofApAwdzoY.jpg',
               u'release_date': u'2012-07-20',
               u'title': u'The Dark Knight Rises',
               u'vote_average': 8.8,
               u'vote_count': 67},
              {u'backdrop_path': u'/f8LPFOnlz8Ia0wzVUUk8REeDfNj.jpg',
               u'id': 49526,
               u'original_title': u'Premium Rush',
               u'poster_path': u'/tZ5M0jvGJ2lj4z9iguvqRqvI5Wp.jpg',
               u'release_date': u'2012-08-24',
               u'title': u'Premium Rush',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/6zzRMEAFjnthrIgPXd0tmxlFwMp.jpg',
               u'id': 82650,
               u'original_title': u'Diary of a Wimpy Kid: Dog Days',
               u'poster_path': u'/o2YcOotynpXiEVoekvA9LdCRueu.jpg',
               u'release_date': u'2012-08-03',
               u'title': u'Diary of a Wimpy Kid: Dog Days',
               u'vote_average': 3.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/eMEYWaxrNryHJSmWYDwyPONWfZt.jpg',
               u'id': 88036,
               u'original_title': u'Sparkle',
               u'poster_path': u'/xrFeA65IhfS0GhfcBEcwx3E1Sho.jpg',
               u'release_date': u'2012-08-17',
               u'title': u'Sparkle',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/jSoNOwg3uVPtDeL6BIB8CJ625j4.jpg',
               u'id': 109513,
               u'original_title': u'Hit & Run',
               u'poster_path': u'/74yocWJsgcRACzedKZ2LYI1D1pU.jpg',
               u'release_date': u'2012-08-22',
               u'title': u'Hit & Run',
               u'vote_average': 6.0,
               u'vote_count': 1}],
 u'total_pages': 4,
 u'total_results': 62}

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_popular(<parameters>)
{u'page': 1,
 u'results': [{u'adult': False,
               u'backdrop_path': u'/5bKy4O0WQTa3MG2wPWViUNUTIEG.jpg',
               u'id': 82992,
               u'original_title': u'Fast & Furious 6',
               u'popularity': 56.5133968700669,
               u'poster_path': u'/3Izae8UATwSHizQiEVZEWf53wjM.jpg',
               u'release_date': u'2013-05-24',
               u'title': u'Fast & Furious 6',
               u'vote_average': 7.3,
               u'vote_count': 13},
              {u'adult': False,
               u'backdrop_path': u'/n9X2DKItL3V0yq1q1jrk8z5UAki.jpg',
               u'id': 68721,
               u'original_title': u'Iron Man 3',
               u'popularity': 55.118598761825,
               u'poster_path': u'/kC4NM99bJ5Xq03O6XQ6602GKRsi.jpg',
               u'release_date': u'2013-05-03',
               u'title': u'Iron Man 3',
               u'vote_average': 7.3,
               u'vote_count': 79},
              {u'adult': False,
               u'backdrop_path': u'/22DQWwjaam1LHTAEapxO2Wg7s2H.jpg',
               u'id': 47964,
               u'original_title': u'A Good Day to Die Hard',
               u'popularity': 53.9077809585504,
               u'poster_path': u'/7JKli6FqxK6kEsNRUW8JVGmGSNI.jpg',
               u'release_date': u'2013-02-14',
               u'title': u'A Good Day to Die Hard',
               u'vote_average': 6.0,
               u'vote_count': 32},
              {u'adult': False,
               u'backdrop_path': u'/rRK0LRpvRI2didoMaBFt1GqxjEy.jpg',
               u'id': 134411,
               u'original_title': u'Snitch',
               u'popularity': 48.6472963993062,
               u'poster_path': u'/vWRivfYs8dMJnFESCKOqXcEUUYN.jpg',
               u'release_date': u'2013-02-22',
               u'title': u'Snitch',
               u'vote_average': 7.7,
               u'vote_count': 42},
              {u'adult': False,
               u'backdrop_path': u'/jjAq3tCezdlQduusgtMhpY2XzW0.jpg',
               u'id': 49051,
               u'original_title': u'The Hobbit: An Unexpected Journey',
               u'popularity': 47.5020577063227,
               u'poster_path': u'/h1XjBJoWdOh8aegBoVYKgABQZSL.jpg',
               u'release_date': u'2012-12-12',
               u'title': u'The Hobbit: An Unexpected Journey',
               u'vote_average': 6.7,
               u'vote_count': 183},
              {u'adult': False,
               u'backdrop_path': u'/4cCQkOv4GfQoTtDzHl54KS3S39N.jpg',
               u'id': 68728,
               u'original_title': u'Oz: The Great and Powerful',
               u'popularity': 45.8321401309985,
               u'poster_path': u'/693zyX9HmZtqoDNLL1QPjMZHdq8.jpg',
               u'release_date': u'2013-03-08',
               u'title': u'Oz: The Great and Powerful',
               u'vote_average': 7.6,
               u'vote_count': 34},
              {u'adult': False,
               u'backdrop_path': u'/4wieJ74tXkZDMiiwJ6yMr7LgSpR.jpg',
               u'id': 60304,
               u'original_title': u'Hansel & Gretel: Witch Hunters',
               u'popularity': 32.6524484520598,
               u'poster_path': u'/yDIVWFJqFLIeS8E1R6GG9uwPMS3.jpg',
               u'release_date': u'2013-01-25',
               u'title': u'Hansel & Gretel: Witch Hunters',
               u'vote_average': 7.5,
               u'vote_count': 34},
              {u'adult': False,
               u'backdrop_path': u'/u4r1VxLPBZXGHMxUnckjes7RWVD.jpg',
               u'id': 82654,
               u'original_title': u'Warm Bodies',
               u'popularity': 30.5946592068883,
               u'poster_path': u'/7tv6NHYiYeskLJzGamxtknC3mPt.jpg',
               u'release_date': u'2013-02-01',
               u'title': u'Warm Bodies',
               u'vote_average': 7.6,
               u'vote_count': 30},
              {u'adult': False,
               u'backdrop_path': u'/qUcmEqnzIwlwZxSyTf3WliSfAjJ.jpg',
               u'id': 68718,
               u'original_title': u'Django Unchained',
               u'popularity': 29.1149763813121,
               u'poster_path': u'/hCk3wAojAgUa9Ey2tzutt8rzmgP.jpg',
               u'release_date': u'2012-12-25',
               u'title': u'Django Unchained',
               u'vote_average': 7.2,
               u'vote_count': 159},
              {u'adult': False,
               u'backdrop_path': u'/ns0IojuqJe24AHTxe8RVcWJUCDM.jpg',
               u'id': 54138,
               u'original_title': u'Star Trek Into Darkness',
               u'popularity': 27.6521203700075,
               u'poster_path': u'/bnttrKDyTUerPIGUXYX79CRWWUF.jpg',
               u'release_date': u'2013-05-16',
               u'title': u'Star Trek Into Darkness',
               u'vote_average': 8.5,
               u'vote_count': 16},
              {u'adult': False,
               u'backdrop_path': u'/glJAmPmXVBDpP0q2Z7yAs9q7Jr8.jpg',
               u'id': 119283,
               u'original_title': u'Parker',
               u'popularity': 24.2810191038002,
               u'poster_path': u'/dbWSgbfxxxLsGipXYuBYi4k4FTA.jpg',
               u'release_date': u'2013-01-25',
               u'title': u'Parker',
               u'vote_average': 5.9,
               u'vote_count': 9},
              {u'adult': False,
               u'backdrop_path': u'/y6a2HpdZ1MlsmAZVTn3XeDoyIka.jpg',
               u'id': 109431,
               u'original_title': u'Identity Thief',
               u'popularity': 22.3382127204636,
               u'poster_path': u'/lOF4rI6SxgRsVLW8odsauqnhB9Z.jpg',
               u'release_date': u'2013-02-07',
               u'title': u'Identity Thief',
               u'vote_average': 4.9,
               u'vote_count': 17},
              {u'adult': False,
               u'backdrop_path': u'/gIfO0pjuzOv0qun6VOuifa0c6OY.jpg',
               u'id': 13804,
               u'original_title': u'Fast And Furious',
               u'popularity': 20.1446806145099,
               u'poster_path': u'/ft8IqAGFs3V7i87z0t0EVRUjK1p.jpg',
               u'release_date': u'2009-03-11',
               u'title': u'Fast And Furious',
               u'vote_average': 7.7,
               u'vote_count': 41},
              {u'adult': False,
               u'backdrop_path': u'/pAIeqf7NpAE6EL0ZkIcaRkwcPyz.jpg',
               u'id': 75780,
               u'original_title': u'Jack Reacher',
               u'popularity': 19.1763149832215,
               u'poster_path': u'/38bmEXmuJuInLs9dwfgOGCHmZ7l.jpg',
               u'release_date': u'2012-12-21',
               u'title': u'Jack Reacher',
               u'vote_average': 7.3,
               u'vote_count': 54},
              {u'adult': False,
               u'backdrop_path': u'/lmIqH8Qsv3IvDg0PTFUuVr89eBT.jpg',
               u'id': 9799,
               u'original_title': u'The Fast and the Furious',
               u'popularity': 18.1965285044048,
               u'poster_path': u'/3cucyEuLOOjjJ8nem5facsTEy68.jpg',
               u'release_date': u'2001-06-17',
               u'title': u'The Fast and the Furious',
               u'vote_average': 7.9,
               u'vote_count': 46},
              {u'adult': False,
               u'backdrop_path': u'/nL1Q0micYpF5nNkaI2ZNeLuOLGZ.jpg',
               u'id': 51497,
               u'original_title': u'Fast Five',
               u'popularity': 17.4500929305629,
               u'poster_path': u'/cA81CI8odKv5KHRUUzJbj83yN7c.jpg',
               u'release_date': u'2011-04-28',
               u'title': u'Fast Five',
               u'vote_average': 8.0,
               u'vote_count': 51},
              {u'adult': False,
               u'backdrop_path': u'/hbn46fQaRmlpBuUrEiFqv0GDL6Y.jpg',
               u'id': 24428,
               u'original_title': u'The Avengers',
               u'popularity': 17.2196799692765,
               u'poster_path': u'/cezWGskPY5x7GaglTTRN4Fugfb8.jpg',
               u'release_date': u'2012-05-04',
               u'title': u'The Avengers',
               u'vote_average': 7.4,
               u'vote_count': 273},
              {u'adult': False,
               u'backdrop_path': None,
               u'id': 168259,
               u'original_title': u'Fast & Furious 7',
               u'popularity': 16.8820145528661,
               u'poster_path': u'/iYDlZgWg8ltTwDEcsvnLQfYkJKj.jpg',
               u'release_date': u'2014-07-11',
               u'title': u'Fast & Furious 7',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'adult': False,
               u'backdrop_path': u'/g62SFRNTiVK2e5FMqivziQ4SX6J.jpg',
               u'id': 109421,
               u'original_title': u'Side Effects',
               u'popularity': 16.6879135174643,
               u'poster_path': u'/ttD69Yhh2BV1WVqr27NRbF8ubOW.jpg',
               u'release_date': u'2013-02-08',
               u'title': u'Side Effects',
               u'vote_average': 5.1,
               u'vote_count': 17},
              {u'adult': False,
               u'backdrop_path': u'/7ObVZtidm7uGWPrNkep2kf2wUPN.jpg',
               u'id': 106021,
               u'original_title': u'The Expatriate',
               u'popularity': 16.338470937008,
               u'poster_path': u'/EWFPlsGbwFgTgnPfJe93OXdCI6.jpg',
               u'release_date': u'2012-09-26',
               u'title': u'Erased',
               u'vote_average': 5.7,
               u'vote_count': 10}],
 u'total_pages': 6142,
 u'total_results': 122821}
movie_rating(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • value (str) –
  • Required JSON Body (str) –
  • id (int) –
  • session_id (str) –
  • guest_session_id (str) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_rating(<parameters>)
{u'status_code': 1, u'status_message': u'Success'}
movie_releases(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:append_to_response (str) – Comma separated, any movie method
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_releases(<parameters>)
{u'countries': [{u'certification': u'R',
                 u'iso_3166_1': u'US',
                 u'release_date': u'1999-10-15'},
                {u'certification': u'18',
                 u'iso_3166_1': u'DE',
                 u'release_date': u'1999-11-11'},
                {u'certification': u'18',
                 u'iso_3166_1': u'GB',
                 u'release_date': u'1999-11-12'},
                {u'certification': u'16',
                 u'iso_3166_1': u'FR',
                 u'release_date': u'1999-11-10'},
                {u'certification': u'',
                 u'iso_3166_1': u'TR',
                 u'release_date': u'1999-12-10'},
                {u'certification': u'feibris',
                 u'iso_3166_1': u'BR',
                 u'release_date': u'1999-07-12'},
                {u'certification': u'K-18',
                 u'iso_3166_1': u'FI',
                 u'release_date': u'1999-11-12'},
                {u'certification': u'c',
                 u'iso_3166_1': u'BG',
                 u'release_date': u'2012-08-28'}],
 u'id': 550}
movie_reviews(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any movie method
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_reviews(<parameters>)
{u'id': 49026,
 u'page': 1,
 u'results': [{u'author': u'Travis Bell',
               u'content': u"I felt like this was a tremendous end to Nolan's Batman trilogy. The Dark Knight Rises may very well have been the weakest of all 3 films but when you're talking about a scale of this magnitude, it still makes this one of the best movies I've seen in the past few years.\r\n\r\nI expected a little more _Batman_ than we got (especially with a runtime of 2:45) but while the story around the fall of Bruce Wayne and Gotham City was good I didn't find it amazing. This might be in fact, one of my only criticisms\u2014it was a long movie but still, maybe too short for the story I felt was really being told. I feel confident in saying this big of a story could have been split into two movies.\r\n\r\nThe acting, editing, pacing, soundtrack and overall theme were the same 'as-close-to-perfect' as ever with any of Christopher Nolan's other films. Man does this guy know how to make a movie!\r\n\r\nYou don't have to be a Batman fan to enjoy these movies and I hope any of you who feel this way re-consider. These 3 movies are without a doubt in my mind, the finest display of comic mythology ever told on the big screen. They are damn near perfect.",
               u'id': u'5010553819c2952d1b000451',
               u'url': u'http://j.mp/QSjAK2'},
              {u'author': u'Chris',
               u'content': u"I personally thought this film is on par if not better than the Dark Knight.\r\n\r\nWhilst some think the film is too long for the story I didn't find this. The length of the film is longer than some (but doesn't feel it), I liked that the film took it's time rather than shoving more elements in it - I think this contributed to the dramatic ending (much like a classical piece of music will be relaxed and calm before the final crescendo).\r\n\r\nAt the end of the day whether you like this film will boil down to if you like films Christopher Nolan has directed and/or you like the Christopher Nolan Batman series so far.\r\n\r\nStupendously good film in my opinion.",
               u'id': u'5013bc76760ee372cb00253e',
               u'url': u'http://j.mp/P18dg1'},
              {u'author': u'GeekMasher',
               u'content': u'The Dark Knight Rises is one of the best movies to come out in 2012. The story compels you to watch it time and time again. It also has I of, I my opinion, the best bad guys in any movie, Bane! Batman was well played as all ways and the cast where well selected. I think this movie is the best batman to see the light of day or the darkest nights (pun intended).',
               u'id': u'51429a7519c29552e10eba16',
               u'url': u'http://j.mp/19nyIWg'}],
 u'total_pages': 1,
 u'total_results': 3}
movie_similar_movies(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any movie method
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_similar_movies(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/pbp2t6p44dt5Ll6MQoFTZKrnDPL.jpg',
               u'id': 52591,
               u'original_title': u'Confessions of a Pit Fighter',
               u'poster_path': u'/qOmYQRhnhBhCM51e212dOaTIrYB.jpg',
               u'release_date': u'2005-06-10',
               u'title': u'Confessions of a Pit Fighter',
               u'vote_average': 3.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/hnPGWzbv2EZCX9d803Emy3AajI5.jpg',
               u'id': 9339,
               u'original_title': u'Click',
               u'poster_path': u'/hsiJ9CsCEkUF63xwcbtaCwXuEF3.jpg',
               u'release_date': u'2006-06-22',
               u'title': u'Click',
               u'vote_average': 7.9,
               u'vote_count': 23},
              {u'backdrop_path': u'/snDywjmnJoAOKiAzeWu5QXg8yvT.jpg',
               u'id': 22094,
               u'original_title': u'Hard Times',
               u'poster_path': u'/6Akbb6imtNGfElJpyJZjN3uxSLW.jpg',
               u'release_date': u'1975-10-08',
               u'title': u'Hard Times',
               u'vote_average': 7.3,
               u'vote_count': 3},
              {u'backdrop_path': u'/vmpyNlphrzFlsiG8XcnaGeQ93WW.jpg',
               u'id': 159,
               u'original_title': u'Der Bewegte Mann',
               u'poster_path': u'/fPpMa0dZtWEzCE4DqYavN7I6zX1.jpg',
               u'release_date': u'1994-10-06',
               u'title': u'Maybe... Maybe Not',
               u'vote_average': 4.8,
               u'vote_count': 0},
              {u'backdrop_path': u'/cHdoSRtl0z607an2XVureR03PZ1.jpg',
               u'id': 21001,
               u'original_title': u'Like It Is',
               u'poster_path': u'/bMw3TUvXSd4ZijcOaDdqZBCmgcM.jpg',
               u'release_date': u'1998-04-17',
               u'title': u'Like It Is',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/xfKwb7i3M86l7iuj7r90KEPWEOv.jpg',
               u'id': 25974,
               u'original_title': u'Moscow Zero',
               u'poster_path': u'/hgsWnod1EIOD4yHrNtwZI1EB0Ic.jpg',
               u'release_date': u'2006-01-01',
               u'title': u'Moscow Zero',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/q0g0EY0Kc5tnRGRLKAxAZmRYv75.jpg',
               u'id': 15039,
               u'original_title': u'Against the Dark',
               u'poster_path': u'/kPqs0DRzRRd0x9Zr27mIR2PJONo.jpg',
               u'release_date': u'2009-01-01',
               u'title': u'Against the Dark',
               u'vote_average': 3.7,
               u'vote_count': 5},
              {u'backdrop_path': u'/pAqrJGedklZ3fUD4RbRNz6PI2zi.jpg',
               u'id': 22165,
               u'original_title': u'The Bridge to Nowhere',
               u'poster_path': u'/crF6sjMoMrxST9tjLL73cdfn9AP.jpg',
               u'release_date': u'2009-08-17',
               u'title': u'The Bridge to Nowhere',
               u'vote_average': 4.3,
               u'vote_count': 2},
              {u'backdrop_path': u'/vAiURKSJ5lYtz2G2d1L0qDjk7Sv.jpg',
               u'id': 9538,
               u'original_title': u'Scanners',
               u'poster_path': u'/2EA8DPKTtGqTT61VJTfZM0u41hz.jpg',
               u'release_date': u'1981-01-14',
               u'title': u'Scanners',
               u'vote_average': 8.5,
               u'vote_count': 2},
              {u'backdrop_path': u'/oxhnPJzgOPqxoxHpIEJ1InwAyQp.jpg',
               u'id': 70006,
               u'original_title': u'Never Back Down 2: The Beatdown',
               u'poster_path': u'/6JN5hCsU18iGAeruDmBCaDpcObZ.jpg',
               u'release_date': u'2011-09-13',
               u'title': u'Never Back Down 2: The Beatdown',
               u'vote_average': 6.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/ipZ2TVKPUz4MTjaPpOAP8yG1Cjy.jpg',
               u'id': 64205,
               u'original_title': u'BKO: Bangkok Knockout',
               u'poster_path': u'/dRZO7EEVxE2SwYTIxqiRjUP02mO.jpg',
               u'release_date': u'2010-12-16',
               u'title': u'BKO: Bangkok Knockout',
               u'vote_average': 6.5,
               u'vote_count': 2},
              {u'backdrop_path': u'/fZqW9wKii0dfBmVWSy6de25JFx0.jpg',
               u'id': 9103,
               u'original_title': u'The Quest',
               u'poster_path': u'/nQgMrXHYPAxVTYgnbhRGyCLcbHV.jpg',
               u'release_date': u'1996-08-01',
               u'title': u'The Quest',
               u'vote_average': 6.5,
               u'vote_count': 2},
              {u'backdrop_path': u'/5X0l0G0S95iTzJMptyIMZO80XNS.jpg',
               u'id': 54833,
               u'original_title': u'The Big Man',
               u'poster_path': u'/v2RAbH8HJuLdMYnwC9RAFx08aeU.jpg',
               u'release_date': u'1991-08-09',
               u'title': u'The Big Man',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/uH4Zl677z6oyvchLIjyHXA0wdz5.jpg',
               u'id': 104047,
               u'original_title': u'Punch',
               u'poster_path': u'/zECLTYvI1nJKxwFWBwedL3OT1nK.jpg',
               u'release_date': u'2003-02-07',
               u'title': u'Punch',
               u'vote_average': 3.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/27GgiNN5UVpJYxgxgQ0VZfdU7rR.jpg',
               u'id': 14440,
               u'original_title': u'The Tattooist',
               u'poster_path': u'/bSCT2vvrp3Tmh3Hkton2ljXam5m.jpg',
               u'release_date': u'2008-06-24',
               u'title': u'The Tattooist',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/o6Xif3e9flyYiuel1qGxGMvqKx0.jpg',
               u'id': 605,
               u'original_title': u'The Matrix Revolutions',
               u'poster_path': u'/sKogjhfs5q3azmpW7DFKKAeLEG8.jpg',
               u'release_date': u'2003-10-27',
               u'title': u'The Matrix Revolutions',
               u'vote_average': 7.5,
               u'vote_count': 78},
              {u'backdrop_path': u'/v3gnNqCUu3WGaN931bDaCsmjElr.jpg',
               u'id': 16825,
               u'original_title': u'La coda dello scorpione',
               u'poster_path': u'/ejihDlbPT7nx9P9FiUaIsdUjcBq.jpg',
               u'release_date': u'1971-08-16',
               u'title': u"The Case of the Scorpion's Tail",
               u'vote_average': 6.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/9UBtFxBdWDtwMLX5brS45Ryo840.jpg',
               u'id': 22538,
               u'original_title': u'Scott Pilgrim vs. The World',
               u'poster_path': u'/2B5zjs5E3xerqAyowpw3QcOCyLq.jpg',
               u'release_date': u'2010-08-13',
               u'title': u'Scott Pilgrim vs. The World',
               u'vote_average': 8.0,
               u'vote_count': 60},
              {u'backdrop_path': u'/hgfmNKEPVUNKokcwvLCa9gOkELw.jpg',
               u'id': 31979,
               u'original_title': u'Played',
               u'poster_path': u'/lTAJBzxIkSjMVVn5PjQEEJVMbhY.jpg',
               u'release_date': u'2006-01-01',
               u'title': u'Played',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/qDNiKJ46kQ6LHo9eyBK8u2QwRpF.jpg',
               u'id': 268,
               u'original_title': u'Batman',
               u'poster_path': u'/u782c0lom0YlLwSWX0X2o72OJDT.jpg',
               u'release_date': u'1989-06-23',
               u'title': u'Batman',
               u'vote_average': 8.3,
               u'vote_count': 38}],
 u'total_pages': 5,
 u'total_results': 99}
movie_top_rated(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_top_rated(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': None,
               u'id': 132179,
               u'original_title': u'The Prince of Town',
               u'poster_path': u'/cvSTHeXmNOVcS5Vc90yzuYZApw5.jpg',
               u'release_date': u'2011-09-01',
               u'title': u'The Prince of Town',
               u'vote_average': 9.3,
               u'vote_count': 12},
              {u'backdrop_path': u'/6xKCYgH16UuwEGAyroLU6p8HLIn.jpg',
               u'id': 238,
               u'original_title': u'The Godfather',
               u'poster_path': u'/d4KNaTrltq6bpkFS01pYtyXa09m.jpg',
               u'release_date': u'1972-03-24',
               u'title': u'The Godfather',
               u'vote_average': 9.2,
               u'vote_count': 125},
              {u'backdrop_path': u'/xa2rJIU0Bs56b9ek9ZuAcRe2S2k.jpg',
               u'id': 914,
               u'original_title': u'The Great Dictator',
               u'poster_path': u'/Wk1ideXjlGYVCtRwOiLmuC9uyu.jpg',
               u'release_date': u'1940-10-15',
               u'title': u'The Great Dictator',
               u'vote_average': 9.2,
               u'vote_count': 16},
              {u'backdrop_path': None,
               u'id': 132180,
               u'original_title': u'Stainless Assassin',
               u'poster_path': u'/vdiW5DLX9zau25bMAsetPqpF38s.jpg',
               u'release_date': u'2010-05-15',
               u'title': u'Stainless Assassin',
               u'vote_average': 9.2,
               u'vote_count': 12},
              {u'backdrop_path': None,
               u'id': 132181,
               u'original_title': u'The Oval Portrait',
               u'poster_path': u'/8FDIBr9v1Z9ty5lP6uoWV6uaeL5.jpg',
               u'release_date': u'2011-08-22',
               u'title': u'The Oval Portrait',
               u'vote_average': 9.2,
               u'vote_count': 12},
              {u'backdrop_path': u'/7u3pxc0K1wx32IleAkLv78MKgrw.jpg',
               u'id': 603,
               u'original_title': u'The Matrix',
               u'poster_path': u'/gynBNzwyaHKtXqlEKKLioNkjKgN.jpg',
               u'release_date': u'1999-03-31',
               u'title': u'The Matrix',
               u'vote_average': 9.1,
               u'vote_count': 248},
              {u'backdrop_path': u'/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg',
               u'id': 550,
               u'original_title': u'Fight Club',
               u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
               u'release_date': u'1999-10-15',
               u'title': u'Fight Club',
               u'vote_average': 9.1,
               u'vote_count': 174},
              {u'backdrop_path': u'/d9AqtruwS8nljKjL5aYzM42hQJr.jpg',
               u'id': 280,
               u'original_title': u'Terminator 2: Judgment Day',
               u'poster_path': u'/2y4dmgWYRMYXdD1UyJVcn2HSd1D.jpg',
               u'release_date': u'1991-07-01',
               u'title': u'Terminator 2: Judgment Day',
               u'vote_average': 9.1,
               u'vote_count': 106},
              {u'backdrop_path': u'/xGC2fY5KFmtuXnsuQwYQKFOLZFy.jpg',
               u'id': 429,
               u'original_title': u'The Good, the Bad and the Ugly',
               u'poster_path': u'/4Mfp4ouiGPmYGVw8J9pa3q7de5b.jpg',
               u'release_date': u'1966-12-23',
               u'title': u'The Good, the Bad and the Ugly',
               u'vote_average': 9.1,
               u'vote_count': 94},
              {u'backdrop_path': u'/jWDegvAE8XO2XDUHP9eQYlepJv1.jpg',
               u'id': 240,
               u'original_title': u'The Godfather: Part II',
               u'poster_path': u'/tHbMIIF51rguMNSastqoQwR0sBs.jpg',
               u'release_date': u'1974-12-20',
               u'title': u'The Godfather: Part II',
               u'vote_average': 9.1,
               u'vote_count': 61},
              {u'backdrop_path': u'/3R6vDW1yBBzejsma8SzzWuxj2AE.jpg',
               u'id': 311,
               u'original_title': u'Once Upon a Time in America',
               u'poster_path': u'/fqP3Q7DWMFqW7mh11hWXbNwN9rz.jpg',
               u'release_date': u'1984-02-17',
               u'title': u'Once Upon a Time in America',
               u'vote_average': 9.1,
               u'vote_count': 34},
              {u'backdrop_path': u'/xBKGJQsAIeweesB79KC89FpBrVr.jpg',
               u'id': 278,
               u'original_title': u'The Shawshank Redemption',
               u'poster_path': u'/9O7gLzmreU0nGkIB6K3BsJbzvNv.jpg',
               u'release_date': u'1994-09-14',
               u'title': u'The Shawshank Redemption',
               u'vote_average': 9.0,
               u'vote_count': 173},
              {u'backdrop_path': u'/bwSuLfJ0V15qWT7K5P28mFhP9rD.jpg',
               u'id': 11,
               u'original_title': u'Star Wars: Episode IV - A New Hope',
               u'poster_path': u'/tvSlBzAdRE29bZe5yYWrJ2ds137.jpg',
               u'release_date': u'1977-05-25',
               u'title': u'Star Wars: Episode IV - A New Hope',
               u'vote_average': 9.0,
               u'vote_count': 149},
              {u'backdrop_path': u'/tv8J6uCTKsTlASa8luJqrFiJlBX.jpg',
               u'id': 78,
               u'original_title': u'Blade Runner',
               u'poster_path': u'/ewq1lwhOT8GqBcQH1w8D1BagwTh.jpg',
               u'release_date': u'1982-06-25',
               u'title': u'Blade Runner',
               u'vote_average': 9.0,
               u'vote_count': 147},
              {u'backdrop_path': u'/AkE7LQs2hPMG5tpWYcum847Knre.jpg',
               u'id': 1891,
               u'original_title': u'Star Wars: Episode V - The Empire Strikes Back',
               u'poster_path': u'/dKz98Lyda4m1QaUUUsUpXFpYCXN.jpg',
               u'release_date': u'1980-05-21',
               u'title': u'Star Wars: Episode V - The Empire Strikes Back',
               u'vote_average': 9.0,
               u'vote_count': 144},
              {u'backdrop_path': u'/8BPZO0Bf8TeAy8znF43z8soK3ys.jpg',
               u'id': 122,
               u'original_title': u'The Lord of the Rings: The Return of the King',
               u'poster_path': u'/j6NCjU6Zh7SkfIeN5zDaoTmBn4m.jpg',
               u'release_date': u'2003-12-17',
               u'title': u'The Lord of the Rings: The Return of the King',
               u'vote_average': 9.0,
               u'vote_count': 135},
              {u'backdrop_path': u'/55LP95aktZlGn2uRKO15qEUrIfU.jpg',
               u'id': 105,
               u'original_title': u'Back to the Future',
               u'poster_path': u'/pTpxQB1N0waaSc3OSn0e9oc8kx9.jpg',
               u'release_date': u'1985-07-03',
               u'title': u'Back to the Future',
               u'vote_average': 9.0,
               u'vote_count': 110},
              {u'backdrop_path': u'/mGN0lH2phYfesyEVqP2xvGUaxAQ.jpg',
               u'id': 101,
               u'original_title': u'L\xe9on',
               u'poster_path': u'/alGc7hDKHLQ2m7Ic41LSp5hbIpI.jpg',
               u'release_date': u'1994-09-14',
               u'title': u'Leon: The Professional',
               u'vote_average': 9.0,
               u'vote_count': 86},
              {u'backdrop_path': u'/sovszUGOwcCfdcfg2xYGMnsRryf.jpg',
               u'id': 8587,
               u'original_title': u'The Lion King',
               u'poster_path': u'/pM4w7A48OcdHlKweMef8HV2EfFD.jpg',
               u'release_date': u'1994-06-24',
               u'title': u'The Lion King',
               u'vote_average': 9.0,
               u'vote_count': 69},
              {u'backdrop_path': u'/fRQATr704bMpLc5Skzpj3V9b2iW.jpg',
               u'id': 197,
               u'original_title': u'Braveheart',
               u'poster_path': u'/4T4xQJXSdTNbzUrlT6Eh13kiy5H.jpg',
               u'release_date': u'1995-05-24',
               u'title': u'Braveheart',
               u'vote_average': 9.0,
               u'vote_count': 65}],
 u'total_pages': 62,
 u'total_results': 1232}
movie_trailers(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:append_to_response (str) – Comma separated, any movie method
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_trailers(<parameters>)
{u'id': 550,
 u'quicktime': [],
 u'youtube': [{u'name': u'Trailer 1',
               u'size': u'HD',
               u'source': u'SUXWAEX2jlg',
               u'type': u'Trailer'}]}
movie_translations(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:append_to_response (str) – Comma separated, any movie method
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_translations(<parameters>)
{u'id': 550,
 u'translations': [{u'english_name': u'English',
                    u'iso_639_1': u'en',
                    u'name': u'English'},
                   {u'english_name': u'Spanish',
                    u'iso_639_1': u'es',
                    u'name': u'Espa\xf1ol'},
                   {u'english_name': u'Ukrainian',
                    u'iso_639_1': u'uk',
                    u'name': u'\u0423\u043a\u0440\u0430\u0457\u043d\u0441\u044c\u043a\u0438\u0439'},
                   {u'english_name': u'German',
                    u'iso_639_1': u'de',
                    u'name': u'Deutsch'},
                   {u'english_name': u'Portuguese',
                    u'iso_639_1': u'pt',
                    u'name': u'Portugu\xeas'},
                   {u'english_name': u'French',
                    u'iso_639_1': u'fr',
                    u'name': u'Fran\xe7ais'},
                   {u'english_name': u'Dutch',
                    u'iso_639_1': u'nl',
                    u'name': u'Nederlands'},
                   {u'english_name': u'Hungarian',
                    u'iso_639_1': u'hu',
                    u'name': u'Magyar'},
                   {u'english_name': u'Russian',
                    u'iso_639_1': u'ru',
                    u'name': u'P\u0443\u0441\u0441\u043a\u0438\u0439'},
                   {u'english_name': u'Italian',
                    u'iso_639_1': u'it',
                    u'name': u'Italiano'},
                   {u'english_name': u'Turkish',
                    u'iso_639_1': u'tr',
                    u'name': u'T\xfcrk\xe7e'},
                   {u'english_name': u'Mandarin',
                    u'iso_639_1': u'zh',
                    u'name': u'\u4e2d\u56fd'},
                   {u'english_name': u'Danish',
                    u'iso_639_1': u'da',
                    u'name': u'Dansk'},
                   {u'english_name': u'Swedish',
                    u'iso_639_1': u'sv',
                    u'name': u'svenska'},
                   {u'english_name': u'Polish',
                    u'iso_639_1': u'pl',
                    u'name': u'Polski'},
                   {u'english_name': u'Czech',
                    u'iso_639_1': u'cs',
                    u'name': u'\u010cesk\xfd'},
                   {u'english_name': u'Finnish',
                    u'iso_639_1': u'fi',
                    u'name': u'suomi'},
                   {u'english_name': u'Hebrew',
                    u'iso_639_1': u'he',
                    u'name': u'\u05e2\u05b4\u05d1\u05b0\u05e8\u05b4\u05d9\u05ea'}]}
movie_upcoming(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.movie_upcoming(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/tOjAcMiF1fysNtV9csAmOblrKSC.jpg',
               u'id': 53100,
               u'original_title': u'Bringing Up Bobby',
               u'poster_path': u'/rF6hzUnfp0iFDDi8rSSpY0z2pmk.jpg',
               u'release_date': u'2011-11-25',
               u'title': u'Bringing Up Bobby',
               u'vote_average': 7.0,
               u'vote_count': 2},
              {u'backdrop_path': None,
               u'id': 121691,
               u'original_title': u'Hellbound?',
               u'poster_path': u'/yv3JWFCDpBe9Upn9lF4J2xqlbME.jpg',
               u'release_date': u'2012-09-28',
               u'title': u'Hellbound?',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/AhHy2Kyj5ikvy8cTBM2EQenIC0Y.jpg',
               u'id': 76492,
               u'original_title': u'Hotel Transylvania',
               u'poster_path': u'/8EOM4vHOdTZo4BOdROKFMPttK7Z.jpg',
               u'release_date': u'2012-09-28',
               u'title': u'Hotel Transylvania',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/3HSb5LjnrgP11dF974Z1OfiLtUO.jpg',
               u'id': 59967,
               u'original_title': u'Looper',
               u'poster_path': u'/7jRzJ0OH6GsbpMEwyYdJ5krEJXO.jpg',
               u'release_date': u'2012-09-28',
               u'title': u'Looper',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': None,
               u'id': 84318,
               u'original_title': u'The Other Dream Team',
               u'poster_path': u'/tUFUA6UWe3jIHrmhMkBdDNyibzJ.jpg',
               u'release_date': u'2012-09-28',
               u'title': u'The Other Dream Team',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/vcLqVuSMx7dVfuOVKd4IL4RcMsa.jpg',
               u'id': 114150,
               u'original_title': u'Pitch Perfect',
               u'poster_path': u'/pkZVHqMqFTfuYUrHG37FTC5REjD.jpg',
               u'release_date': u'2012-10-05',
               u'title': u'Pitch Perfect',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/rEAuvuZLher0Jt9xGT3b90Yx5Zq.jpg',
               u'id': 32985,
               u'original_title': u'Solomon Kane',
               u'poster_path': u'/n5SHBE4ulsDDVa9gYttUYwp1VZU.jpg',
               u'release_date': u'2012-09-28',
               u'title': u'Solomon Kane',
               u'vote_average': 7.2,
               u'vote_count': 20},
              {u'backdrop_path': u'/mmTIlUkf1vjn8zDCyZ6XpFqPLZd.jpg',
               u'id': 82631,
               u'original_title': u"Won't Back Down",
               u'poster_path': u'/mmriKke2koxbnqvFPLazB0gWAjb.jpg',
               u'release_date': u'2012-09-28',
               u'title': u"Won't Back Down",
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/aPNIBz8IlwItnGqFZcvYith9IQJ.jpg',
               u'id': 79697,
               u'original_title': u'Butter',
               u'poster_path': u'/f4vDFX6wZ75BKQpXs2mrOQpfbbS.jpg',
               u'release_date': u'2012-03-16',
               u'title': u'Butter',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': None,
               u'id': 84192,
               u'original_title': u'Escape Fire: The Fight to Rescue American Healthcare',
               u'poster_path': u'/5sOvUyDXkm7P0QW6aYFJNosdeUD.jpg',
               u'release_date': u'2012-10-05',
               u'title': u'Escape Fire: The Fight to Rescue American Healthcare',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/L4SsHfdYkuFNgpjYj8ByjJRAcI.jpg',
               u'id': 62214,
               u'original_title': u'Frankenweenie',
               u'poster_path': u'/sn5V6z2RRKujHGthAGjdl3Evzj0.jpg',
               u'release_date': u'2012-10-05',
               u'title': u'Frankenweenie',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': None,
               u'id': 84284,
               u'original_title': u'The House I Live In',
               u'poster_path': u'/c7eFVXTU34xHnl261KAPJtiK1px.jpg',
               u'release_date': u'2012-10-05',
               u'title': u'The House I Live In',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': None,
               u'id': 89008,
               u'original_title': u'The Oranges',
               u'poster_path': u'/dzMXyP1n70f8Xq4FU5ZLh6FXKI6.jpg',
               u'release_date': u'2012-10-05',
               u'title': u'The Oranges',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': None,
               u'id': 82390,
               u'original_title': u'The Paperboy',
               u'poster_path': u'/qzL5f0fGXw8SmIfsiTvzCm2jZEq.jpg',
               u'release_date': u'2012-11-24',
               u'title': u'The Paperboy',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': None,
               u'id': 82675,
               u'original_title': u'Taken 2',
               u'poster_path': u'/yA2Ly2CYSaK1Wljzmz1SKPpZ1RH.jpg',
               u'release_date': u'2012-10-05',
               u'title': u'Taken 2',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/1D2HsFUey1BoiM16bjOEferT6yG.jpg',
               u'id': 84348,
               u'original_title': u'V/H/S',
               u'poster_path': u'/e2wdyen1CdKPGrTKoxLvDMffyM1.jpg',
               u'release_date': u'2012-10-05',
               u'title': u'V/H/S',
               u'vote_average': 8.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/rbO1MB4wTJk4eFyXKRjDejHtCXV.jpg',
               u'id': 9364,
               u'original_title': u'Wuthering Heights',
               u'poster_path': u'/7xToLdWDxRJPWLin5vUWdcaXYUs.jpg',
               u'release_date': u'2012-04-09',
               u'title': u'Wuthering Heights',
               u'vote_average': 5.6,
               u'vote_count': 5},
              {u'backdrop_path': u'/rkVH5HFCbzgqU3TjDikzB8yi6yU.jpg',
               u'id': 68734,
               u'original_title': u'Argo',
               u'poster_path': u'/pfe5X0mi7TFKaWtQkXonjrGwLCr.jpg',
               u'release_date': u'2012-10-12',
               u'title': u'Argo',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/aPNrZTGGj4uXIdcOIc5eNtsEVlc.jpg',
               u'id': 68450,
               u'original_title': u'The Art of Flight',
               u'poster_path': u'/2WvlTijDZX8NciqLyRKcLACxPF5.jpg',
               u'release_date': u'2011-09-08',
               u'title': u'The Art of Flight',
               u'vote_average': 9.0,
               u'vote_count': 3},
              {u'backdrop_path': None,
               u'id': 95571,
               u'original_title': u'Gayby',
               u'poster_path': u'/kif0M8G7mwNkOSDvljNIMEsqxGV.jpg',
               u'release_date': u'2012-10-12',
               u'title': u'Gayby',
               u'vote_average': 0.0,
               u'vote_count': 0}],
 u'total_pages': 5,
 u'total_results': 100}
network(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.network(<parameters>)
{u'id': 49, u'name': u'HBO'}
person(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:append_to_response (str) – Comma separated, any person method
Usage:
>>> api = tmdb.API(api_key)
>>> api.person(<parameters>)
{u'adult': False,
 u'also_known_as': [],
 u'biography': u'From Wikipedia, the free encyclopedia.\n\nWilliam Bradley "Brad" Pitt (born December 18, 1963) is an American actor and film producer. Pitt has received two Academy Award nominations and four Golden Globe Award nominations, winning one. He has been described as one of the world\'s most attractive men, a label for which he has received substantial media attention.\n\nPitt began his acting career with television guest appearances, including a role on the CBS prime-time soap opera Dallas in 1987. He later gained recognition as the cowboy hitchhiker who seduces Geena Davis\'s character in the 1991 road movie Thelma & Louise. Pitt\'s first leading roles in big-budget productions came with A River Runs Through It (1992) and Interview with the Vampire (1994). He was cast opposite Anthony Hopkins in the 1994 drama Legends of the Fall, which earned him his first Golden Globe nomination. In 1995 he gave critically acclaimed performances in the crime thriller Seven and the science fiction film 12 Monkeys, the latter securing him a Golden Globe Award for Best Supporting Actor and an Academy Award nomination. Four years later, in 1999, Pitt starred in the cult hit Fight Club. He then starred in the major international hit as Rusty Ryan in Ocean\'s Eleven (2001) and its sequels, Ocean\'s Twelve (2004) and Ocean\'s Thirteen (2007). His greatest commercial successes have been Troy (2004) and Mr. & Mrs. Smith (2005). Pitt received his second Academy Award nomination for his title role performance in the 2008 film The Curious Case of Benjamin Button.\n\nFollowing a high-profile relationship with actress Gwyneth Paltrow, Pitt was married to actress Jennifer Aniston for five years. Pitt lives with actress Angelina Jolie in a relationship that has generated wide publicity. He and Jolie have six children\u2014Maddox, Pax, Zahara, Shiloh, Knox, and Vivienne. Since beginning his relationship with Jolie, he has become increasingly involved in social issues both in the United States and internationally. Pitt owns a production company named Plan B Entertainment, whose productions include the 2007 Academy Award winning Best Picture, The Departed.\n\nDescription above from the Wikipedia article Brad Pitt, licensed under CC-BY-SA, full list of contributors on Wikipedia.',
 u'birthday': u'1963-12-18',
 u'deathday': u'',
 u'homepage': u'http://simplybrad.com/',
 u'id': 287,
 u'name': u'Brad Pitt',
 u'place_of_birth': u'Shawnee, Oklahoma, United States',
 u'profile_path': u'/w8zJQuN7tzlm6FY9mfGKihxp3Cb.jpg'}
person_changes(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • start_date (str) – YYYY-MM-DD
  • end_date (str) – YYYY-MM-DD
Usage:
>>> api = tmdb.API(api_key)
>>> api.person_changes(<parameters>)
{u'changes': [{u'items': [{u'action': u'created',
                           u'id': u'50745cd3760ee35edd0001a4',
                           u'time': u'2012-10-09 17:20:19 UTC'}],
               u'key': u'general'},
              {u'items': [{u'action': u'added',
                           u'id': u'50745cd3760ee35edd0001a5',
                           u'time': u'2012-10-09 17:20:19 UTC',
                           u'value': u'Brad Pitt'}],
               u'key': u'name'}]}
person_combined_credits(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any person method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.person_combined_credits(<parameters>)
{u'cast': [{u'adult': False,
            u'character': u'Jeffrey Goines',
            u'id': 63,
            u'media_type': u'movie',
            u'original_title': u'Twelve Monkeys',
            u'poster_path': u'/vxiIABQhiFlfODwamoevrzXvowU.jpg',
            u'release_date': u'1995-12-27',
            u'title': u'Twelve Monkeys'},
           {u'adult': False,
            u'character': u"Mickey O'Neil",
            u'id': 107,
            u'media_type': u'movie',
            u'original_title': u'Snatch',
            u'poster_path': u'/on9JlbGEccLsYkjeEph2Whm1DIp.jpg',
            u'release_date': u'2000-12-06',
            u'title': u'Snatch'},
           {u'adult': False,
            u'character': u'Rusty Ryan',
            u'id': 161,
            u'media_type': u'movie',
            u'original_title': u"Ocean's Eleven",
            u'poster_path': u'/9TFmI0eQuOGTxfgUWyykQcUMJZV.jpg',
            u'release_date': u'2001-12-06',
            u'title': u"Ocean's Eleven"},
           {u'adult': False,
            u'character': u'Rusty Ryan',
            u'id': 163,
            u'media_type': u'movie',
            u'original_title': u"Ocean's Twelve",
            u'poster_path': u'/q71ovWCbeWGRnGmZCLaPLWQLQA.jpg',
            u'release_date': u'2004-12-09',
            u'title': u"Ocean's Twelve"},
           {u'adult': False,
            u'character': u'Paul Maclean',
            u'id': 293,
            u'media_type': u'movie',
            u'original_title': u'A River Runs Through It',
            u'poster_path': u'/xX4H1hZG9IgSRkC0LANbPQ0StJi.jpg',
            u'release_date': u'1992-09-13',
            u'title': u'A River Runs Through It'},
           {u'adult': False,
            u'character': u'Floyd',
            u'id': 319,
            u'media_type': u'movie',
            u'original_title': u'True Romance',
            u'poster_path': u'/xBO8R3CZfrJ9rrwrZoJ68PgJyAR.jpg',
            u'release_date': u'1993-09-09',
            u'title': u'True Romance'},
           {u'adult': False,
            u'character': u'Himself',
            u'id': 492,
            u'media_type': u'movie',
            u'original_title': u'Being John Malkovich',
            u'poster_path': u'/gLhl4MBEC6yHTInwV7TxV1D3FLp.jpg',
            u'release_date': u'1999-09-30',
            u'title': u'Being John Malkovich'},
           {u'adult': False,
            u'character': u'Tyler Durden',
            u'id': 550,
            u'media_type': u'movie',
            u'original_title': u'Fight Club',
            u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
            u'release_date': u'1999-10-14',
            u'title': u'Fight Club'},
           {u'adult': False,
            u'character': u'Louis de Pointe du Lac',
            u'id': 628,
            u'media_type': u'movie',
            u'original_title': u'Interview with the Vampire',
            u'poster_path': u'/qHRoxkDokG0rpRFeHHykgDf3Chy.jpg',
            u'release_date': u'1994-11-11',
            u'title': u'Interview with the Vampire'},
           {u'adult': False,
            u'character': u'Achilles',
            u'id': 652,
            u'media_type': u'movie',
            u'original_title': u'Troy',
            u'poster_path': u'/edMlij7nw2NMla32xskDnzMCFBM.jpg',
            u'release_date': u'2004-05-13',
            u'title': u'Troy'},
           {u'adult': False,
            u'character': u'John Smith',
            u'id': 787,
            u'media_type': u'movie',
            u'original_title': u'Mr. & Mrs. Smith',
            u'poster_path': u'/dqs5BmwSULtB28Kls3IB6khTQwp.jpg',
            u'release_date': u'2005-06-09',
            u'title': u'Mr. & Mrs. Smith'},
           {u'adult': False,
            u'character': u'Michael Sullivan',
            u'id': 819,
            u'media_type': u'movie',
            u'original_title': u'Sleepers',
            u'poster_path': u'/xU8af1eMtVSjxRzN8ZrUeeIfZkP.jpg',
            u'release_date': u'1996-10-18',
            u'title': u'Sleepers'},
           {u'adult': False,
            u'character': u'Heinrich Harrer',
            u'id': 978,
            u'media_type': u'movie',
            u'original_title': u'Seven Years in Tibet',
            u'poster_path': u'/cflSeFUVDCf73Tzh5sB204JbQ6j.jpg',
            u'release_date': u'1997-10-08',
            u'title': u'Seven Years in Tibet'},
           {u'adult': False,
            u'character': u'Tom Bishop',
            u'id': 1535,
            u'media_type': u'movie',
            u'original_title': u'Spy Game',
            u'poster_path': u'/yJv2k86Sx0bkYE3bxEXZRq7jev0.jpg',
            u'release_date': u'2001-11-18',
            u'title': u'Spy Game'},
           {u'adult': False,
            u'character': u'J.D.',
            u'id': 1541,
            u'media_type': u'movie',
            u'original_title': u'Thelma & Louise',
            u'poster_path': u'/uxfIGF3rHOfu9IyvHbGVmFvvPgH.jpg',
            u'release_date': u'1991-05-24',
            u'title': u'Thelma & Louise'},
           {u'adult': False,
            u'character': u'Jesse James',
            u'id': 4512,
            u'media_type': u'movie',
            u'original_title': u'The Assassination of Jesse James by the Coward Robert Ford',
            u'poster_path': u'/lSFYLoaL4eW7Q5VQ7SZQP4EHRCt.jpg',
            u'release_date': u'2007-09-20',
            u'title': u'The Assassination of Jesse James by the Coward Robert Ford'},
           {u'adult': False,
            u'character': u'Brad, 1st Bachelor',
            u'id': 4912,
            u'media_type': u'movie',
            u'original_title': u'Confessions of a Dangerous Mind',
            u'poster_path': u'/vQqxMsivH5cKNlEJJcYBcBQZ5rZ.jpg',
            u'release_date': u'2002-12-30',
            u'title': u'Confessions of a Dangerous Mind'},
           {u'adult': False,
            u'character': u'Benjamin Button',
            u'id': 4922,
            u'media_type': u'movie',
            u'original_title': u'The Curious Case of Benjamin Button',
            u'poster_path': u'/fNBuHmJjlmQ63Kz6k7SFKU1d8sG.jpg',
            u'release_date': u'2008-11-24',
            u'title': u'The Curious Case of Benjamin Button'},
           {u'adult': False,
            u'character': u'Chad Feldheimer',
            u'id': 4944,
            u'media_type': u'movie',
            u'original_title': u'Burn After Reading',
            u'poster_path': u'/8ZvcWWewpWdDbkA6dCMma11ZL2l.jpg',
            u'release_date': u'2008-09-12',
            u'title': u'Burn After Reading'},
           {u'adult': False,
            u'character': u'Billy Canton',
            u'id': 10917,
            u'media_type': u'movie',
            u'original_title': u'Too Young to Die?',
            u'poster_path': u'/7qwH5pdWhScueSoZlorJLxqoNvH.jpg',
            u'release_date': u'1990-02-26',
            u'title': u'Too Young to Die?'},
           {u'adult': False,
            u'character': u'Detective Frank Harris',
            u'id': 14239,
            u'media_type': u'movie',
            u'original_title': u'Cool World',
            u'poster_path': u'/eSR3vFpgGQfYQYI2fMbwIZp70lp.jpg',
            u'release_date': u'1992-07-10',
            u'title': u'Cool World'},
           {u'adult': False,
            u'character': u'Lt. Aldo Raine',
            u'id': 16869,
            u'media_type': u'movie',
            u'original_title': u'Inglourious Basterds',
            u'poster_path': u'/keAMrS08NxKvMxh8GRDhS9UCph4.jpg',
            u'release_date': u'2009-08-21',
            u'title': u'Inglourious Basterds'},
           {u'adult': False,
            u'character': u'Himself',
            u'id': 30565,
            u'media_type': u'movie',
            u'original_title': u'The Hamster Factor and Other Tales of Twelve Monkeys',
            u'poster_path': u'/sfPxX29hVdBq8cP5839Dx91cCW9.jpg',
            u'release_date': u'1997-01-01',
            u'title': u'The Hamster Factor and Other Tales of Twelve Monkeys'},
           {u'adult': False,
            u'character': u'Metro Man (voice)',
            u'id': 38055,
            u'media_type': u'movie',
            u'original_title': u'Megamind',
            u'poster_path': u'/b4mcRWB2TofqhiGDEuXJKkbthif.jpg',
            u'release_date': u'2010-11-04',
            u'title': u'Megamind'},
           {u'adult': False,
            u'character': u"Mickey O'Neil (Snatch) (archive footage)",
            u'id': 68996,
            u'media_type': u'movie',
            u'original_title': u'Ultimate Fights from the Movies',
            u'poster_path': u'/2KIKXjKoNTmpi22gsU3KUMv6wKA.jpg',
            u'release_date': u'2002-04-16',
            u'title': u'Ultimate Fights from the Movies'},
           {u'adult': False,
            u'character': u'Robert \u201cRusty\u201d Charles Ryan',
            u'id': 298,
            u'media_type': u'movie',
            u'original_title': u"Ocean's Thirteen",
            u'poster_path': u'/2ERIEmAO4wOR3evQZihjb52VfEG.jpg',
            u'release_date': u'2007-06-07',
            u'title': u"Ocean's Thirteen"},
           {u'adult': False,
            u'character': u'Gerry Lane',
            u'id': 72190,
            u'media_type': u'movie',
            u'original_title': u'World War Z',
            u'poster_path': u'/gAt1PrsrFY1nX6UzebeiHP8njE9.jpg',
            u'release_date': u'2013-06-21',
            u'title': u'World War Z'},
           {u'adult': False,
            u'character': u'John Dean',
            u'id': 8947,
            u'media_type': u'movie',
            u'original_title': u'Dirty Tricks',
            u'poster_path': None,
            u'release_date': u'2013-12-31',
            u'title': u'Dirty Tricks'},
           {u'adult': False,
            u'character': u'Rick',
            u'id': 26642,
            u'media_type': u'movie',
            u'original_title': u'The Dark Side of the Sun',
            u'poster_path': u'/pofw83GCrfG2B6JxH53n8vX1pDv.jpg',
            u'release_date': u'1987-12-31',
            u'title': u'The Dark Side of the Sun'},
           {u'adult': False,
            u'character': u'Elliott Fowler',
            u'id': 50463,
            u'media_type': u'movie',
            u'original_title': u'The Favor',
            u'poster_path': u'/68a68qALehxulfbL2P56OKAJ6Ci.jpg',
            u'release_date': u'1994-04-29',
            u'title': u'The Favor'},
           {u'adult': False,
            u'character': u'Sinbad',
            u'id': 14411,
            u'media_type': u'movie',
            u'original_title': u'Sinbad: Legend of the Seven Seas',
            u'poster_path': u'/6LELf4ZzVBJwR9mNq86Mf5QVERS.jpg',
            u'release_date': u'2003-07-02',
            u'title': u'Sinbad: Legend of the Seven Seas'},
           {u'adult': False,
            u'character': u'Joe Maloney',
            u'id': 48448,
            u'media_type': u'movie',
            u'original_title': u'Across the Tracks',
            u'poster_path': u'/o2Xvw7Wfzk1Q10yDNOgVx63CsIv.jpg',
            u'release_date': u'1991-02-14',
            u'title': u'Across the Tracks'},
           {u'adult': False,
            u'character': u'Jackie Cogan',
            u'id': 64689,
            u'media_type': u'movie',
            u'original_title': u'Killing Them Softly',
            u'poster_path': u'/pIS0JWCYJYesGNAd6gWbtSwzgsF.jpg',
            u'release_date': u'2012-11-30',
            u'title': u'Killing Them Softly'},
           {u'adult': False,
            u'character': u'Joe Black',
            u'id': 297,
            u'media_type': u'movie',
            u'original_title': u'Meet Joe Black',
            u'poster_path': u'/nlxPnkZY3vY1iehJriKMQcT6eua.jpg',
            u'release_date': u'1998-11-12',
            u'title': u'Meet Joe Black'},
           {u'adult': False,
            u'character': u'Richard',
            u'id': 1164,
            u'media_type': u'movie',
            u'original_title': u'Babel',
            u'poster_path': u'/tHhtDiDO2onzly2qsYuIaFJsTdj.jpg',
            u'release_date': u'2006-10-27',
            u'title': u'Babel'},
           {u'adult': False,
            u'character': u'Johnny Suede',
            u'id': 45145,
            u'media_type': u'movie',
            u'original_title': u'Johnny Suede',
            u'poster_path': u'/3z4OZo5j1hkQ3AI8xTzuyqUD9Ru.jpg',
            u'release_date': u'1991-06-15',
            u'title': u'Johnny Suede'},
           {u'adult': False,
            u'character': u'Tristan Ludlow',
            u'id': 4476,
            u'media_type': u'movie',
            u'original_title': u'Legends of the Fall',
            u'poster_path': u'/uh0sJcx3SLtclJSuKAXl6Tt6AV0.jpg',
            u'release_date': u'1994-12-16',
            u'title': u'Legends of the Fall'},
           {u'adult': False,
            u'character': u'Jerry Welbach',
            u'id': 6073,
            u'media_type': u'movie',
            u'original_title': u'The Mexican',
            u'poster_path': u'/a7PuqWv0ENFg8dt9k51AID6P1kh.jpg',
            u'release_date': u'2001-03-01',
            u'title': u'The Mexican'},
           {u'adult': False,
            u'character': u'Frankie McGuire',
            u'id': 4477,
            u'media_type': u'movie',
            u'original_title': u"The Devil's Own",
            u'poster_path': u'/1zusKhAtJ3YhbuA6J184Vm4INB3.jpg',
            u'release_date': u'1997-03-13',
            u'title': u"The Devil's Own"},
           {u'adult': False,
            u'character': u'Detective David Mills',
            u'id': 807,
            u'media_type': u'movie',
            u'original_title': u'Se7en',
            u'poster_path': u'/g66CLfP5NYKYgOO8H28AnWWfrvU.jpg',
            u'release_date': u'1995-09-22',
            u'title': u'Se7en'},
           {u'adult': False,
            u'character': u'Early Grayce',
            u'id': 10909,
            u'media_type': u'movie',
            u'original_title': u'Kalifornia',
            u'poster_path': u'/y8SJxeBmkmSWPTurQEacZmrEyey.jpg',
            u'release_date': u'1993-09-03',
            u'title': u'Kalifornia'},
           {u'adult': False,
            u'character': u"Mr. O'Brien",
            u'id': 8967,
            u'media_type': u'movie',
            u'original_title': u'The Tree of Life',
            u'poster_path': u'/wt5Q6SQFeU2mW7UKF10mTwyyHog.jpg',
            u'release_date': u'2011-05-27',
            u'title': u'The Tree of Life'},
           {u'adult': False,
            u'character': u'Billy Beane',
            u'id': 60308,
            u'media_type': u'movie',
            u'original_title': u'Moneyball',
            u'poster_path': u'/3oAa8mJJ97CH9AeGEY6vjAxqcvZ.jpg',
            u'release_date': u'2011-09-22',
            u'title': u'Moneyball'},
           {u'adult': False,
            u'character': u'Henry B. Northup',
            u'id': 76203,
            u'media_type': u'movie',
            u'original_title': u'Twelve Years a Slave',
            u'poster_path': u'/xosImeLYPS0Q1I2OOKXh1pjmnGQ.jpg',
            u'release_date': u'2013-10-18',
            u'title': u'Twelve Years a Slave'},
           {u'adult': False,
            u'character': u'Will the Krill (voice)',
            u'id': 65759,
            u'media_type': u'movie',
            u'original_title': u'Happy Feet Two',
            u'poster_path': u'/gY8lWCObaGvcDsmeM8QHBF4AZVk.jpg',
            u'release_date': u'2011-11-17',
            u'title': u'Happy Feet Two'},
           {u'adult': False,
            u'character': u'Westray',
            u'id': 109091,
            u'media_type': u'movie',
            u'original_title': u'The Counselor',
            u'poster_path': u'/qsFyIJ7p9BACoFRppCfhNB1igwp.jpg',
            u'release_date': u'2013-10-25',
            u'title': u'The Counselor'},
           {u'adult': False,
            u'character': u'Chief Judge Vaughn R. Walker',
            u'id': 109404,
            u'media_type': u'movie',
            u'original_title': u'8',
            u'poster_path': u'/28fDtVBr6PyHsFFqyKJCeN3ysBP.jpg',
            u'release_date': u'2012-03-03',
            u'title': u'8'},
           {u'adult': False,
            u'character': u'Dwight Ingalls',
            u'id': 21799,
            u'media_type': u'movie',
            u'original_title': u'Cutting Class',
            u'poster_path': u'/y8eBkmikGYZmhmZfNjgzWD5Lo1d.jpg',
            u'release_date': u'1989-07-01',
            u'title': u'Cutting Class'},
           {u'adult': False,
            u'character': u'Narrator (voice)',
            u'id': 86822,
            u'media_type': u'movie',
            u'original_title': u'Voyage of Time',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'Voyage of Time'},
           {u'adult': False,
            u'character': None,
            u'id': 145206,
            u'media_type': u'movie',
            u'original_title': u'20,000 Leagues Under the Sea: Captain Nemo',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'20,000 Leagues Under the Sea: Captain Nemo'},
           {u'adult': False,
            u'character': u'Yuri Trush',
            u'id': 145266,
            u'media_type': u'movie',
            u'original_title': u'The Tiger',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'The Tiger'},
           {u'adult': False,
            u'character': u'Brian',
            u'id': 55059,
            u'media_type': u'movie',
            u'original_title': u'Happy Together',
            u'poster_path': u'/5H766FOKWY0GsbdMdQktqQYv3ku.jpg',
            u'release_date': u'1989-05-04',
            u'title': u'Happy Together'},
           {u'adult': False,
            u'character': u'',
            u'id': 228150,
            u'media_type': u'movie',
            u'original_title': u'Fury',
            u'poster_path': None,
            u'release_date': u'2014-11-14',
            u'title': u'Fury'},
           {u'character': u'',
            u'credit_id': u'525333fb19c295794002c720',
            u'episode_count': 2,
            u'first_air_date': u'1985-09-24',
            u'id': 54,
            u'media_type': u'tv',
            u'name': u'Growing Pains',
            u'original_name': u'Growing Pains',
            u'poster_path': u'/eKyeUFwjc0LhPSp129IHpXniJVR.jpg'},
           {u'character': u'',
            u'credit_id': u'525713d5760ee3776a113c77',
            u'episode_count': 1,
            u'first_air_date': u'1952-01-14',
            u'id': 1709,
            u'media_type': u'tv',
            u'name': u'The Today Show',
            u'original_name': u'The Today Show',
            u'poster_path': u'/o7bSMUPaIxYbbsgC6VTbrvOVDpN.jpg'},
           {u'character': u'',
            u'credit_id': u'5257157c760ee3776a132ba8',
            u'episode_count': 2,
            u'first_air_date': u'2000-04-12',
            u'id': 1795,
            u'media_type': u'tv',
            u'name': u'Jackass',
            u'original_name': u'Jackass',
            u'poster_path': u'/mz9PZo93dnIYHp1udcYsnBSLYTS.jpg'},
           {u'character': u'',
            u'credit_id': u'52571af119c29571140d5eda',
            u'episode_count': 1,
            u'first_air_date': u'1983-04-04',
            u'id': 1900,
            u'media_type': u'tv',
            u'name': u'Live! with Kelly and Michael',
            u'original_name': u'Live! with Kelly and Michael',
            u'poster_path': u'/nuwhsprEgH31SROiJtIk0mxF82M.jpg'},
           {u'character': u'',
            u'credit_id': u'525763be760ee36aaa33f8e7',
            u'episode_count': 1,
            u'first_air_date': None,
            u'id': 4325,
            u'media_type': u'tv',
            u'name': u'Pet Star',
            u'original_name': u'Pet Star',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'525764f9760ee36aaa357d18',
            u'episode_count': 1,
            u'first_air_date': u'1988-10-08',
            u'id': 4346,
            u'media_type': u'tv',
            u'name': u"Freddy's Nightmares",
            u'original_name': u"Freddy's Nightmares",
            u'poster_path': u'/sMYfjEjK6rEF6FeiGum6g67Wor6.jpg'},
           {u'character': u'',
            u'credit_id': u'5257713f760ee36aaa496071',
            u'episode_count': 1,
            u'first_air_date': u'1993-09-13',
            u'id': 4573,
            u'media_type': u'tv',
            u'name': u"Late Night with Conan O'Brien",
            u'original_name': u"Late Night with Conan O'Brien",
            u'poster_path': u'/v4N5l6JooObhXbjXoFaKbx92wB9.jpg'},
           {u'character': u'Albigence Waldo',
            u'credit_id': u'525782e7760ee36aaa605ae7',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'media_type': u'tv',
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'James K. Polk',
            u'credit_id': u'525782e7760ee36aaa605b0f',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'media_type': u'tv',
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'William Lloyd Garrison',
            u'credit_id': u'525782e7760ee36aaa605b19',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'media_type': u'tv',
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'George Hewes',
            u'credit_id': u'525782e7760ee36aaa605b23',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'media_type': u'tv',
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'John Russell Young',
            u'credit_id': u'525782e7760ee36aaa605b2d',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'media_type': u'tv',
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'5257fa0319c29531db2ed3bb',
            u'episode_count': 1,
            u'first_air_date': u'1994-01-03',
            u'id': 9937,
            u'media_type': u'tv',
            u'name': u'Intimate Portrait',
            u'original_name': u'Intimate Portrait',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'5258833a760ee346614043a6',
            u'episode_count': 3,
            u'first_air_date': u'1929-05-16',
            u'id': 27023,
            u'media_type': u'tv',
            u'name': u'The Academy Awards',
            u'original_name': u'The Academy Awards',
            u'poster_path': u'/oQJeREgBeF1Afz9DABo5ymwu63Y.jpg'},
           {u'character': u'Walker Lovejoy',
            u'credit_id': u'525895bf760ee3466158aa8e',
            u'episode_count': 6,
            u'first_air_date': u'1990-07-25',
            u'id': 29999,
            u'media_type': u'tv',
            u'name': u'Glory Days',
            u'original_name': u'Glory Days',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'525704eb760ee3776a008abe',
            u'episode_count': 1,
            u'first_air_date': u'1987-09-29',
            u'id': 1448,
            u'media_type': u'tv',
            u'name': u'Thirtysomething',
            u'original_name': u'Thirtysomething',
            u'poster_path': u'/tlEWRrWe2SCd0cYfk3X5LEoiOpm.jpg'},
           {u'character': u'',
            u'credit_id': u'52570765760ee3776a03124d',
            u'episode_count': 1,
            u'first_air_date': u'1987-04-12',
            u'id': 1486,
            u'media_type': u'tv',
            u'name': u'21 Jump Street',
            u'original_name': u'21 Jump Street',
            u'poster_path': u'/5zobhoPvdfqQOmvRRukhoJDiJ3M.jpg'},
           {u'character': u'',
            u'credit_id': u'5257107819c295731c02cf9b',
            u'episode_count': 1,
            u'first_air_date': u'1994-09-22',
            u'id': 1668,
            u'media_type': u'tv',
            u'name': u'Friends',
            u'original_name': u'Friends',
            u'poster_path': u'/oQR7HXiCWpWvmUN1wo3asxrkAeZ.jpg'},
           {u'character': u'',
            u'credit_id': u'52572302760ee3776a22dc59',
            u'episode_count': 1,
            u'first_air_date': u'1997-01-12',
            u'id': 2122,
            u'media_type': u'tv',
            u'name': u'King of the Hill',
            u'original_name': u'King of the Hill',
            u'poster_path': u'/r6dIrTjWLE3GfcTZzrDYikt6YDn.jpg'},
           {u'character': u'',
            u'credit_id': u'52572b4e760ee3776a2d9c26',
            u'episode_count': 1,
            u'first_air_date': u'1996-07-22',
            u'id': 2224,
            u'media_type': u'tv',
            u'name': u'The Daily Show',
            u'original_name': u'The Daily Show',
            u'poster_path': u'/pnQmYxMlJBvnyFElFHbzsPlOUUx.jpg'},
           {u'character': u'',
            u'credit_id': u'525734f6760ee3776a3977e7',
            u'episode_count': 1,
            u'first_air_date': u'1989-06-10',
            u'id': 2391,
            u'media_type': u'tv',
            u'name': u'Tales from the Crypt',
            u'original_name': u'Tales from the Crypt',
            u'poster_path': u'/faZKMT856LWSnzgVh3L4BMazGmz.jpg'},
           {u'character': u'',
            u'credit_id': u'52573d96760ee36aaa047b7e',
            u'episode_count': 1,
            u'first_air_date': u'1986-09-17',
            u'id': 2589,
            u'media_type': u'tv',
            u'name': u'Head of the Class',
            u'original_name': u'Head of the Class',
            u'poster_path': u'/Dyy3E7SqkeuYpiQET2rIwsGPxZ.jpg'},
           {u'character': u'',
            u'credit_id': u'525753c6760ee36aaa1f53c7',
            u'episode_count': 1,
            u'first_air_date': u'2002-06-11',
            u'id': 3626,
            u'media_type': u'tv',
            u'name': u'American Idol',
            u'original_name': u'American Idol',
            u'poster_path': u'/2aqueDlNwOWrszV0hKsxVk5yOgK.jpg'},
           {u'character': u'',
            u'credit_id': u'5258094919c29531db3e2f4a',
            u'episode_count': 6,
            u'first_air_date': u'2003-06-04',
            u'id': 10946,
            u'media_type': u'tv',
            u'name': u'Celebrities Uncensored',
            u'original_name': u'Celebrities Uncensored',
            u'poster_path': None}],
 u'crew': [{u'adult': False,
            u'department': u'Production',
            u'id': 652,
            u'job': u'Other',
            u'media_type': u'movie',
            u'original_title': u'Troy',
            u'poster_path': u'/edMlij7nw2NMla32xskDnzMCFBM.jpg',
            u'release_date': u'2004-05-13',
            u'title': u'Troy'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 1988,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'A Mighty Heart',
            u'poster_path': u'/8khwSri6av5MtP1BmyeN1gEHVJN.jpg',
            u'release_date': u'2007-05-21',
            u'title': u'A Mighty Heart'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 7510,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'Running with Scissors',
            u'poster_path': u'/pYFF3iMWDPcwXKpRM0GLIsnPf22.jpg',
            u'release_date': u'2006-10-27',
            u'title': u'Running with Scissors'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 23483,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'Kick-Ass',
            u'poster_path': u'/8GUzMZqDAWk3kobuTdXhGRp3HD.jpg',
            u'release_date': u'2010-04-16',
            u'title': u'Kick-Ass'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 4512,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'The Assassination of Jesse James by the Coward Robert Ford',
            u'poster_path': u'/lSFYLoaL4eW7Q5VQ7SZQP4EHRCt.jpg',
            u'release_date': u'2007-09-20',
            u'title': u'The Assassination of Jesse James by the Coward Robert Ford'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 113833,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'The Normal Heart',
            u'poster_path': None,
            u'release_date': u'2014-01-01',
            u'title': u'The Normal Heart'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 64689,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'Killing Them Softly',
            u'poster_path': u'/pIS0JWCYJYesGNAd6gWbtSwzgsF.jpg',
            u'release_date': u'2012-11-30',
            u'title': u'Killing Them Softly'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 174349,
            u'job': u'Executive Producer',
            u'media_type': u'movie',
            u'original_title': u'Big Men',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'Big Men'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 76203,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'Twelve Years a Slave',
            u'poster_path': u'/xosImeLYPS0Q1I2OOKXh1pjmnGQ.jpg',
            u'release_date': u'2013-10-18',
            u'title': u'Twelve Years a Slave'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 218277,
            u'job': u'Executive Producer',
            u'media_type': u'movie',
            u'original_title': u'Pretty/Handsome',
            u'poster_path': u'/hiASAaSle8sjUZ9BHs4XrA30shS.jpg',
            u'release_date': u'2008-06-01',
            u'title': u'Pretty/Handsome'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 72190,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'World War Z',
            u'poster_path': u'/gAt1PrsrFY1nX6UzebeiHP8njE9.jpg',
            u'release_date': u'2013-06-21',
            u'title': u'World War Z'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 1422,
            u'job': u'Producer',
            u'media_type': u'movie',
            u'original_title': u'The Departed',
            u'poster_path': u'/tGLO9zw5ZtCeyyEWgbYGgsFxC6i.jpg',
            u'release_date': u'2006-10-05',
            u'title': u'The Departed'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 38167,
            u'job': u'Executive Producer',
            u'media_type': u'movie',
            u'original_title': u'Eat Pray Love',
            u'poster_path': u'/s57E4AfPIU1fxwpGGRahk6A0DUl.jpg',
            u'release_date': u'2010-08-12',
            u'title': u'Eat Pray Love'}],
 u'id': 287}
person_external_ids(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.person_external_ids(<parameters>)
{u'freebase_id': u'/en/brad_pitt',
 u'freebase_mid': u'/m/0c6qh',
 u'id': 287,
 u'imdb_id': u'nm0000093',
 u'tvrage_id': 59436}
person_images(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.person_images(<parameters>)
{u'id': 287,
 u'profiles': [{u'aspect_ratio': 0.66,
                u'file_path': u'/w8zJQuN7tzlm6FY9mfGKihxp3Cb.jpg',
                u'height': 1969,
                u'iso_639_1': None,
                u'width': 1295},
               {u'aspect_ratio': 0.67,
                u'file_path': u'/cLUacutO7dOMksQK8Zg0q2Gybsx.jpg',
                u'height': 1230,
                u'iso_639_1': None,
                u'width': 820},
               {u'aspect_ratio': 0.71,
                u'file_path': u'/zEbgoayf0MfuSznehhXdaP2YkeH.jpg',
                u'height': 983,
                u'iso_639_1': None,
                u'width': 700}]}
person_latest(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Usage:
>>> api = tmdb.API(api_key)
>>> api.person_latest(<parameters>)
{u'adult': False,
 u'also_known_as': [],
 u'biography': None,
 u'birthday': None,
 u'deathday': None,
 u'homepage': None,
 u'id': 1108200,
 u'name': u'Ted Koland',
 u'place_of_birth': None,
 u'profile_path': None}
person_movie_credits(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any person method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.person_movie_credits(<parameters>)
{u'cast': [{u'adult': False,
            u'character': u'Jeffrey Goines',
            u'id': 63,
            u'original_title': u'Twelve Monkeys',
            u'poster_path': u'/vxiIABQhiFlfODwamoevrzXvowU.jpg',
            u'release_date': u'1995-12-27',
            u'title': u'Twelve Monkeys'},
           {u'adult': False,
            u'character': u"Mickey O'Neil",
            u'id': 107,
            u'original_title': u'Snatch',
            u'poster_path': u'/on9JlbGEccLsYkjeEph2Whm1DIp.jpg',
            u'release_date': u'2000-12-06',
            u'title': u'Snatch'},
           {u'adult': False,
            u'character': u'Rusty Ryan',
            u'id': 161,
            u'original_title': u"Ocean's Eleven",
            u'poster_path': u'/9TFmI0eQuOGTxfgUWyykQcUMJZV.jpg',
            u'release_date': u'2001-12-06',
            u'title': u"Ocean's Eleven"},
           {u'adult': False,
            u'character': u'Rusty Ryan',
            u'id': 163,
            u'original_title': u"Ocean's Twelve",
            u'poster_path': u'/q71ovWCbeWGRnGmZCLaPLWQLQA.jpg',
            u'release_date': u'2004-12-09',
            u'title': u"Ocean's Twelve"},
           {u'adult': False,
            u'character': u'Paul Maclean',
            u'id': 293,
            u'original_title': u'A River Runs Through It',
            u'poster_path': u'/xX4H1hZG9IgSRkC0LANbPQ0StJi.jpg',
            u'release_date': u'1992-09-13',
            u'title': u'A River Runs Through It'},
           {u'adult': False,
            u'character': u'Floyd',
            u'id': 319,
            u'original_title': u'True Romance',
            u'poster_path': u'/xBO8R3CZfrJ9rrwrZoJ68PgJyAR.jpg',
            u'release_date': u'1993-09-09',
            u'title': u'True Romance'},
           {u'adult': False,
            u'character': u'Himself',
            u'id': 492,
            u'original_title': u'Being John Malkovich',
            u'poster_path': u'/gLhl4MBEC6yHTInwV7TxV1D3FLp.jpg',
            u'release_date': u'1999-09-30',
            u'title': u'Being John Malkovich'},
           {u'adult': False,
            u'character': u'Tyler Durden',
            u'id': 550,
            u'original_title': u'Fight Club',
            u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
            u'release_date': u'1999-10-14',
            u'title': u'Fight Club'},
           {u'adult': False,
            u'character': u'Louis de Pointe du Lac',
            u'id': 628,
            u'original_title': u'Interview with the Vampire',
            u'poster_path': u'/qHRoxkDokG0rpRFeHHykgDf3Chy.jpg',
            u'release_date': u'1994-11-11',
            u'title': u'Interview with the Vampire'},
           {u'adult': False,
            u'character': u'Achilles',
            u'id': 652,
            u'original_title': u'Troy',
            u'poster_path': u'/edMlij7nw2NMla32xskDnzMCFBM.jpg',
            u'release_date': u'2004-05-13',
            u'title': u'Troy'},
           {u'adult': False,
            u'character': u'John Smith',
            u'id': 787,
            u'original_title': u'Mr. & Mrs. Smith',
            u'poster_path': u'/dqs5BmwSULtB28Kls3IB6khTQwp.jpg',
            u'release_date': u'2005-06-09',
            u'title': u'Mr. & Mrs. Smith'},
           {u'adult': False,
            u'character': u'Michael Sullivan',
            u'id': 819,
            u'original_title': u'Sleepers',
            u'poster_path': u'/xU8af1eMtVSjxRzN8ZrUeeIfZkP.jpg',
            u'release_date': u'1996-10-18',
            u'title': u'Sleepers'},
           {u'adult': False,
            u'character': u'Heinrich Harrer',
            u'id': 978,
            u'original_title': u'Seven Years in Tibet',
            u'poster_path': u'/cflSeFUVDCf73Tzh5sB204JbQ6j.jpg',
            u'release_date': u'1997-10-08',
            u'title': u'Seven Years in Tibet'},
           {u'adult': False,
            u'character': u'Tom Bishop',
            u'id': 1535,
            u'original_title': u'Spy Game',
            u'poster_path': u'/yJv2k86Sx0bkYE3bxEXZRq7jev0.jpg',
            u'release_date': u'2001-11-18',
            u'title': u'Spy Game'},
           {u'adult': False,
            u'character': u'J.D.',
            u'id': 1541,
            u'original_title': u'Thelma & Louise',
            u'poster_path': u'/uxfIGF3rHOfu9IyvHbGVmFvvPgH.jpg',
            u'release_date': u'1991-05-24',
            u'title': u'Thelma & Louise'},
           {u'adult': False,
            u'character': u'Jesse James',
            u'id': 4512,
            u'original_title': u'The Assassination of Jesse James by the Coward Robert Ford',
            u'poster_path': u'/lSFYLoaL4eW7Q5VQ7SZQP4EHRCt.jpg',
            u'release_date': u'2007-09-20',
            u'title': u'The Assassination of Jesse James by the Coward Robert Ford'},
           {u'adult': False,
            u'character': u'Brad, 1st Bachelor',
            u'id': 4912,
            u'original_title': u'Confessions of a Dangerous Mind',
            u'poster_path': u'/vQqxMsivH5cKNlEJJcYBcBQZ5rZ.jpg',
            u'release_date': u'2002-12-30',
            u'title': u'Confessions of a Dangerous Mind'},
           {u'adult': False,
            u'character': u'Benjamin Button',
            u'id': 4922,
            u'original_title': u'The Curious Case of Benjamin Button',
            u'poster_path': u'/fNBuHmJjlmQ63Kz6k7SFKU1d8sG.jpg',
            u'release_date': u'2008-11-24',
            u'title': u'The Curious Case of Benjamin Button'},
           {u'adult': False,
            u'character': u'Chad Feldheimer',
            u'id': 4944,
            u'original_title': u'Burn After Reading',
            u'poster_path': u'/8ZvcWWewpWdDbkA6dCMma11ZL2l.jpg',
            u'release_date': u'2008-09-12',
            u'title': u'Burn After Reading'},
           {u'adult': False,
            u'character': u'Billy Canton',
            u'id': 10917,
            u'original_title': u'Too Young to Die?',
            u'poster_path': u'/7qwH5pdWhScueSoZlorJLxqoNvH.jpg',
            u'release_date': u'1990-02-26',
            u'title': u'Too Young to Die?'},
           {u'adult': False,
            u'character': u'Detective Frank Harris',
            u'id': 14239,
            u'original_title': u'Cool World',
            u'poster_path': u'/eSR3vFpgGQfYQYI2fMbwIZp70lp.jpg',
            u'release_date': u'1992-07-10',
            u'title': u'Cool World'},
           {u'adult': False,
            u'character': u'Lt. Aldo Raine',
            u'id': 16869,
            u'original_title': u'Inglourious Basterds',
            u'poster_path': u'/keAMrS08NxKvMxh8GRDhS9UCph4.jpg',
            u'release_date': u'2009-08-21',
            u'title': u'Inglourious Basterds'},
           {u'adult': False,
            u'character': u'Himself',
            u'id': 30565,
            u'original_title': u'The Hamster Factor and Other Tales of Twelve Monkeys',
            u'poster_path': u'/sfPxX29hVdBq8cP5839Dx91cCW9.jpg',
            u'release_date': u'1997-01-01',
            u'title': u'The Hamster Factor and Other Tales of Twelve Monkeys'},
           {u'adult': False,
            u'character': u'Metro Man (voice)',
            u'id': 38055,
            u'original_title': u'Megamind',
            u'poster_path': u'/b4mcRWB2TofqhiGDEuXJKkbthif.jpg',
            u'release_date': u'2010-11-04',
            u'title': u'Megamind'},
           {u'adult': False,
            u'character': u"Mickey O'Neil (Snatch) (archive footage)",
            u'id': 68996,
            u'original_title': u'Ultimate Fights from the Movies',
            u'poster_path': u'/2KIKXjKoNTmpi22gsU3KUMv6wKA.jpg',
            u'release_date': u'2002-04-16',
            u'title': u'Ultimate Fights from the Movies'},
           {u'adult': False,
            u'character': u'Robert \u201cRusty\u201d Charles Ryan',
            u'id': 298,
            u'original_title': u"Ocean's Thirteen",
            u'poster_path': u'/2ERIEmAO4wOR3evQZihjb52VfEG.jpg',
            u'release_date': u'2007-06-07',
            u'title': u"Ocean's Thirteen"},
           {u'adult': False,
            u'character': u'Gerry Lane',
            u'id': 72190,
            u'original_title': u'World War Z',
            u'poster_path': u'/gAt1PrsrFY1nX6UzebeiHP8njE9.jpg',
            u'release_date': u'2013-06-21',
            u'title': u'World War Z'},
           {u'adult': False,
            u'character': u'John Dean',
            u'id': 8947,
            u'original_title': u'Dirty Tricks',
            u'poster_path': None,
            u'release_date': u'2013-12-31',
            u'title': u'Dirty Tricks'},
           {u'adult': False,
            u'character': u'Rick',
            u'id': 26642,
            u'original_title': u'The Dark Side of the Sun',
            u'poster_path': u'/pofw83GCrfG2B6JxH53n8vX1pDv.jpg',
            u'release_date': u'1987-12-31',
            u'title': u'The Dark Side of the Sun'},
           {u'adult': False,
            u'character': u'Elliott Fowler',
            u'id': 50463,
            u'original_title': u'The Favor',
            u'poster_path': u'/68a68qALehxulfbL2P56OKAJ6Ci.jpg',
            u'release_date': u'1994-04-29',
            u'title': u'The Favor'},
           {u'adult': False,
            u'character': u'Sinbad',
            u'id': 14411,
            u'original_title': u'Sinbad: Legend of the Seven Seas',
            u'poster_path': u'/6LELf4ZzVBJwR9mNq86Mf5QVERS.jpg',
            u'release_date': u'2003-07-02',
            u'title': u'Sinbad: Legend of the Seven Seas'},
           {u'adult': False,
            u'character': u'Joe Maloney',
            u'id': 48448,
            u'original_title': u'Across the Tracks',
            u'poster_path': u'/o2Xvw7Wfzk1Q10yDNOgVx63CsIv.jpg',
            u'release_date': u'1991-02-14',
            u'title': u'Across the Tracks'},
           {u'adult': False,
            u'character': u'Jackie Cogan',
            u'id': 64689,
            u'original_title': u'Killing Them Softly',
            u'poster_path': u'/pIS0JWCYJYesGNAd6gWbtSwzgsF.jpg',
            u'release_date': u'2012-11-30',
            u'title': u'Killing Them Softly'},
           {u'adult': False,
            u'character': u'Joe Black',
            u'id': 297,
            u'original_title': u'Meet Joe Black',
            u'poster_path': u'/nlxPnkZY3vY1iehJriKMQcT6eua.jpg',
            u'release_date': u'1998-11-12',
            u'title': u'Meet Joe Black'},
           {u'adult': False,
            u'character': u'Richard',
            u'id': 1164,
            u'original_title': u'Babel',
            u'poster_path': u'/tHhtDiDO2onzly2qsYuIaFJsTdj.jpg',
            u'release_date': u'2006-10-27',
            u'title': u'Babel'},
           {u'adult': False,
            u'character': u'Johnny Suede',
            u'id': 45145,
            u'original_title': u'Johnny Suede',
            u'poster_path': u'/3z4OZo5j1hkQ3AI8xTzuyqUD9Ru.jpg',
            u'release_date': u'1991-06-15',
            u'title': u'Johnny Suede'},
           {u'adult': False,
            u'character': u'Tristan Ludlow',
            u'id': 4476,
            u'original_title': u'Legends of the Fall',
            u'poster_path': u'/uh0sJcx3SLtclJSuKAXl6Tt6AV0.jpg',
            u'release_date': u'1994-12-16',
            u'title': u'Legends of the Fall'},
           {u'adult': False,
            u'character': u'Jerry Welbach',
            u'id': 6073,
            u'original_title': u'The Mexican',
            u'poster_path': u'/a7PuqWv0ENFg8dt9k51AID6P1kh.jpg',
            u'release_date': u'2001-03-01',
            u'title': u'The Mexican'},
           {u'adult': False,
            u'character': u'Frankie McGuire',
            u'id': 4477,
            u'original_title': u"The Devil's Own",
            u'poster_path': u'/1zusKhAtJ3YhbuA6J184Vm4INB3.jpg',
            u'release_date': u'1997-03-13',
            u'title': u"The Devil's Own"},
           {u'adult': False,
            u'character': u'Detective David Mills',
            u'id': 807,
            u'original_title': u'Se7en',
            u'poster_path': u'/g66CLfP5NYKYgOO8H28AnWWfrvU.jpg',
            u'release_date': u'1995-09-22',
            u'title': u'Se7en'},
           {u'adult': False,
            u'character': u'Early Grayce',
            u'id': 10909,
            u'original_title': u'Kalifornia',
            u'poster_path': u'/y8SJxeBmkmSWPTurQEacZmrEyey.jpg',
            u'release_date': u'1993-09-03',
            u'title': u'Kalifornia'},
           {u'adult': False,
            u'character': u"Mr. O'Brien",
            u'id': 8967,
            u'original_title': u'The Tree of Life',
            u'poster_path': u'/wt5Q6SQFeU2mW7UKF10mTwyyHog.jpg',
            u'release_date': u'2011-05-27',
            u'title': u'The Tree of Life'},
           {u'adult': False,
            u'character': u'Billy Beane',
            u'id': 60308,
            u'original_title': u'Moneyball',
            u'poster_path': u'/3oAa8mJJ97CH9AeGEY6vjAxqcvZ.jpg',
            u'release_date': u'2011-09-22',
            u'title': u'Moneyball'},
           {u'adult': False,
            u'character': u'Henry B. Northup',
            u'id': 76203,
            u'original_title': u'Twelve Years a Slave',
            u'poster_path': u'/xosImeLYPS0Q1I2OOKXh1pjmnGQ.jpg',
            u'release_date': u'2013-10-18',
            u'title': u'Twelve Years a Slave'},
           {u'adult': False,
            u'character': u'Will the Krill (voice)',
            u'id': 65759,
            u'original_title': u'Happy Feet Two',
            u'poster_path': u'/gY8lWCObaGvcDsmeM8QHBF4AZVk.jpg',
            u'release_date': u'2011-11-17',
            u'title': u'Happy Feet Two'},
           {u'adult': False,
            u'character': u'Westray',
            u'id': 109091,
            u'original_title': u'The Counselor',
            u'poster_path': u'/qsFyIJ7p9BACoFRppCfhNB1igwp.jpg',
            u'release_date': u'2013-10-25',
            u'title': u'The Counselor'},
           {u'adult': False,
            u'character': u'Chief Judge Vaughn R. Walker',
            u'id': 109404,
            u'original_title': u'8',
            u'poster_path': u'/28fDtVBr6PyHsFFqyKJCeN3ysBP.jpg',
            u'release_date': u'2012-03-03',
            u'title': u'8'},
           {u'adult': False,
            u'character': u'Dwight Ingalls',
            u'id': 21799,
            u'original_title': u'Cutting Class',
            u'poster_path': u'/y8eBkmikGYZmhmZfNjgzWD5Lo1d.jpg',
            u'release_date': u'1989-07-01',
            u'title': u'Cutting Class'},
           {u'adult': False,
            u'character': u'Narrator (voice)',
            u'id': 86822,
            u'original_title': u'Voyage of Time',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'Voyage of Time'},
           {u'adult': False,
            u'character': None,
            u'id': 145206,
            u'original_title': u'20,000 Leagues Under the Sea: Captain Nemo',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'20,000 Leagues Under the Sea: Captain Nemo'},
           {u'adult': False,
            u'character': u'Yuri Trush',
            u'id': 145266,
            u'original_title': u'The Tiger',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'The Tiger'},
           {u'adult': False,
            u'character': u'Brian',
            u'id': 55059,
            u'original_title': u'Happy Together',
            u'poster_path': u'/5H766FOKWY0GsbdMdQktqQYv3ku.jpg',
            u'release_date': u'1989-05-04',
            u'title': u'Happy Together'},
           {u'adult': False,
            u'character': u'',
            u'id': 228150,
            u'original_title': u'Fury',
            u'poster_path': None,
            u'release_date': u'2014-11-14',
            u'title': u'Fury'}],
 u'crew': [{u'adult': False,
            u'department': u'Production',
            u'id': 652,
            u'job': u'Other',
            u'original_title': u'Troy',
            u'poster_path': u'/edMlij7nw2NMla32xskDnzMCFBM.jpg',
            u'release_date': u'2004-05-13',
            u'title': u'Troy'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 1988,
            u'job': u'Producer',
            u'original_title': u'A Mighty Heart',
            u'poster_path': u'/8khwSri6av5MtP1BmyeN1gEHVJN.jpg',
            u'release_date': u'2007-05-21',
            u'title': u'A Mighty Heart'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 7510,
            u'job': u'Producer',
            u'original_title': u'Running with Scissors',
            u'poster_path': u'/pYFF3iMWDPcwXKpRM0GLIsnPf22.jpg',
            u'release_date': u'2006-10-27',
            u'title': u'Running with Scissors'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 23483,
            u'job': u'Producer',
            u'original_title': u'Kick-Ass',
            u'poster_path': u'/8GUzMZqDAWk3kobuTdXhGRp3HD.jpg',
            u'release_date': u'2010-04-16',
            u'title': u'Kick-Ass'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 4512,
            u'job': u'Producer',
            u'original_title': u'The Assassination of Jesse James by the Coward Robert Ford',
            u'poster_path': u'/lSFYLoaL4eW7Q5VQ7SZQP4EHRCt.jpg',
            u'release_date': u'2007-09-20',
            u'title': u'The Assassination of Jesse James by the Coward Robert Ford'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 113833,
            u'job': u'Producer',
            u'original_title': u'The Normal Heart',
            u'poster_path': None,
            u'release_date': u'2014-01-01',
            u'title': u'The Normal Heart'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 64689,
            u'job': u'Producer',
            u'original_title': u'Killing Them Softly',
            u'poster_path': u'/pIS0JWCYJYesGNAd6gWbtSwzgsF.jpg',
            u'release_date': u'2012-11-30',
            u'title': u'Killing Them Softly'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 174349,
            u'job': u'Executive Producer',
            u'original_title': u'Big Men',
            u'poster_path': None,
            u'release_date': u'',
            u'title': u'Big Men'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 76203,
            u'job': u'Producer',
            u'original_title': u'Twelve Years a Slave',
            u'poster_path': u'/xosImeLYPS0Q1I2OOKXh1pjmnGQ.jpg',
            u'release_date': u'2013-10-18',
            u'title': u'Twelve Years a Slave'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 218277,
            u'job': u'Executive Producer',
            u'original_title': u'Pretty/Handsome',
            u'poster_path': u'/hiASAaSle8sjUZ9BHs4XrA30shS.jpg',
            u'release_date': u'2008-06-01',
            u'title': u'Pretty/Handsome'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 72190,
            u'job': u'Producer',
            u'original_title': u'World War Z',
            u'poster_path': u'/gAt1PrsrFY1nX6UzebeiHP8njE9.jpg',
            u'release_date': u'2013-06-21',
            u'title': u'World War Z'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 1422,
            u'job': u'Producer',
            u'original_title': u'The Departed',
            u'poster_path': u'/tGLO9zw5ZtCeyyEWgbYGgsFxC6i.jpg',
            u'release_date': u'2006-10-05',
            u'title': u'The Departed'},
           {u'adult': False,
            u'department': u'Production',
            u'id': 38167,
            u'job': u'Executive Producer',
            u'original_title': u'Eat Pray Love',
            u'poster_path': u'/s57E4AfPIU1fxwpGGRahk6A0DUl.jpg',
            u'release_date': u'2010-08-12',
            u'title': u'Eat Pray Love'}],
 u'id': 287}

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.person_popular(<parameters>)
{u'page': 1,
 u'results': [{u'adult': False,
               u'id': 8784,
               u'name': u'Daniel Craig',
               u'profile_path': u'/wWMdqiqW6unT6TnXydQbOtYffeO.jpg'},
              {u'adult': False,
               u'id': 20005,
               u'name': u'Moira Kelly',
               u'profile_path': u'/4cDCNxqYgJ0ueUqIpM4lUBnBb5f.jpg'},
              {u'adult': False,
               u'id': 17282,
               u'name': u'Takashi Miike',
               u'profile_path': u'/sAuA3MamBI87lB9rirbdqgcuOu0.jpg'},
              {u'adult': False,
               u'id': 62,
               u'name': u'Bruce Willis',
               u'profile_path': u'/szRtf6oUR9cT6whTbRc5sCQGi8a.jpg'},
              {u'adult': False,
               u'id': 9340,
               u'name': u'Lana Wachowski',
               u'profile_path': u'/8mbcXfOpmOiDLk6ZWfMsBGHEnet.jpg'},
              {u'adult': False,
               u'id': 31,
               u'name': u'Tom Hanks',
               u'profile_path': u'/1TGabQuX8wlHFNTxFijX2hweNNR.jpg'},
              {u'adult': False,
               u'id': 28846,
               u'name': u'Alexander Skarsg\xe5rd',
               u'profile_path': u'/6UlvGpmOVYYzWIGsC558bUYPm0U.jpg'},
              {u'adult': False,
               u'id': 287,
               u'name': u'Brad Pitt',
               u'profile_path': u'/w8zJQuN7tzlm6FY9mfGKihxp3Cb.jpg'},
              {u'adult': False,
               u'id': 11108,
               u'name': u'Simon Pegg',
               u'profile_path': u'/sxfrOKHpm0WV72rFqGmLkzavkJS.jpg'},
              {u'adult': False,
               u'id': 45982,
               u'name': u'Alberto Sordi',
               u'profile_path': u'/qfrgQ551SxM2i4LMIFLX7kScUc7.jpg'},
              {u'adult': False,
               u'id': 1146550,
               u'name': u'Andreea Valean',
               u'profile_path': None},
              {u'adult': False,
               u'id': 1123441,
               u'name': u'Lynn Redgrave',
               u'profile_path': None},
              {u'adult': False,
               u'id': 1132416,
               u'name': u'Richard Dreyfuss',
               u'profile_path': None},
              {u'adult': False,
               u'id': 11090,
               u'name': u'Edgar Wright',
               u'profile_path': u'/usP3f3DB3BgNgwlvBd5nQNXUCQv.jpg'},
              {u'adult': False,
               u'id': 114463,
               u'name': u'Michelle Jenner',
               u'profile_path': u'/jMi1nhPPjIn7TRZ2PrNWVQFbhpB.jpg'},
              {u'adult': False,
               u'id': 1149851,
               u'name': u'Maurizio Forestieri',
               u'profile_path': u'/cqg6n5wMERepaoMr3Ak5wH9Myuw.jpg'},
              {u'adult': False,
               u'id': 24829,
               u'name': u'Jean-Guy Fechner',
               u'profile_path': u'/kWwHjF14w30SMuC8V4W2GofIMvE.jpg'},
              {u'adult': False,
               u'id': 524,
               u'name': u'Natalie Portman',
               u'profile_path': u'/d30Z0EKHJcDMYaJfLr2X6rVoUrI.jpg'},
              {u'adult': False,
               u'id': 14999,
               u'name': u'George A. Romero',
               u'profile_path': u'/q1XONnZT4ccRVGd9gSAv0F0D8te.jpg'},
              {u'adult': False,
               u'id': 17067,
               u'name': u'Karoline Herfurth',
               u'profile_path': u'/8HVqhIaLQA3MOTO88Ncn6VOCzdp.jpg'}],
 u'total_pages': 13,
 u'total_results': 243}
person_tv_credits(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any person method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.person_tv_credits(<parameters>)
{u'cast': [{u'character': u'',
            u'credit_id': u'525333fb19c295794002c720',
            u'episode_count': 2,
            u'first_air_date': u'1985-09-24',
            u'id': 54,
            u'name': u'Growing Pains',
            u'original_name': u'Growing Pains',
            u'poster_path': u'/eKyeUFwjc0LhPSp129IHpXniJVR.jpg'},
           {u'character': u'',
            u'credit_id': u'5257157c760ee3776a132ba8',
            u'episode_count': 2,
            u'first_air_date': u'2000-04-12',
            u'id': 1795,
            u'name': u'Jackass',
            u'original_name': u'Jackass',
            u'poster_path': u'/mz9PZo93dnIYHp1udcYsnBSLYTS.jpg'},
           {u'character': u'',
            u'credit_id': u'52572b4e760ee3776a2d9c26',
            u'episode_count': 1,
            u'first_air_date': u'1996-07-22',
            u'id': 2224,
            u'name': u'The Daily Show',
            u'original_name': u'The Daily Show',
            u'poster_path': u'/pnQmYxMlJBvnyFElFHbzsPlOUUx.jpg'},
           {u'character': u'',
            u'credit_id': u'525763be760ee36aaa33f8e7',
            u'episode_count': 1,
            u'first_air_date': None,
            u'id': 4325,
            u'name': u'Pet Star',
            u'original_name': u'Pet Star',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'5257713f760ee36aaa496071',
            u'episode_count': 1,
            u'first_air_date': u'1993-09-13',
            u'id': 4573,
            u'name': u"Late Night with Conan O'Brien",
            u'original_name': u"Late Night with Conan O'Brien",
            u'poster_path': u'/v4N5l6JooObhXbjXoFaKbx92wB9.jpg'},
           {u'character': u'Albigence Waldo',
            u'credit_id': u'525782e7760ee36aaa605ae7',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'James K. Polk',
            u'credit_id': u'525782e7760ee36aaa605b0f',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'William Lloyd Garrison',
            u'credit_id': u'525782e7760ee36aaa605b19',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'George Hewes',
            u'credit_id': u'525782e7760ee36aaa605b23',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'John Russell Young',
            u'credit_id': u'525782e7760ee36aaa605b2d',
            u'episode_count': 0,
            u'first_air_date': None,
            u'id': 5741,
            u'name': u'Freedom: A History of Us',
            u'original_name': u'Freedom: A History of Us',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'5257fa0319c29531db2ed3bb',
            u'episode_count': 1,
            u'first_air_date': u'1994-01-03',
            u'id': 9937,
            u'name': u'Intimate Portrait',
            u'original_name': u'Intimate Portrait',
            u'poster_path': None},
           {u'character': u'Walker Lovejoy',
            u'credit_id': u'525895bf760ee3466158aa8e',
            u'episode_count': 6,
            u'first_air_date': u'1990-07-25',
            u'id': 29999,
            u'name': u'Glory Days',
            u'original_name': u'Glory Days',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'525704eb760ee3776a008abe',
            u'episode_count': 1,
            u'first_air_date': u'1987-09-29',
            u'id': 1448,
            u'name': u'Thirtysomething',
            u'original_name': u'Thirtysomething',
            u'poster_path': u'/tlEWRrWe2SCd0cYfk3X5LEoiOpm.jpg'},
           {u'character': u'',
            u'credit_id': u'52570765760ee3776a03124d',
            u'episode_count': 1,
            u'first_air_date': u'1987-04-12',
            u'id': 1486,
            u'name': u'21 Jump Street',
            u'original_name': u'21 Jump Street',
            u'poster_path': u'/5zobhoPvdfqQOmvRRukhoJDiJ3M.jpg'},
           {u'character': u'',
            u'credit_id': u'5257107819c295731c02cf9b',
            u'episode_count': 1,
            u'first_air_date': u'1994-09-22',
            u'id': 1668,
            u'name': u'Friends',
            u'original_name': u'Friends',
            u'poster_path': u'/oQR7HXiCWpWvmUN1wo3asxrkAeZ.jpg'},
           {u'character': u'',
            u'credit_id': u'525713d5760ee3776a113c77',
            u'episode_count': 1,
            u'first_air_date': u'1952-01-14',
            u'id': 1709,
            u'name': u'The Today Show',
            u'original_name': u'The Today Show',
            u'poster_path': u'/o7bSMUPaIxYbbsgC6VTbrvOVDpN.jpg'},
           {u'character': u'',
            u'credit_id': u'52571af119c29571140d5eda',
            u'episode_count': 1,
            u'first_air_date': u'1983-04-04',
            u'id': 1900,
            u'name': u'Live! with Kelly and Michael',
            u'original_name': u'Live! with Kelly and Michael',
            u'poster_path': u'/nuwhsprEgH31SROiJtIk0mxF82M.jpg'},
           {u'character': u'',
            u'credit_id': u'52572302760ee3776a22dc59',
            u'episode_count': 1,
            u'first_air_date': u'1997-01-12',
            u'id': 2122,
            u'name': u'King of the Hill',
            u'original_name': u'King of the Hill',
            u'poster_path': u'/r6dIrTjWLE3GfcTZzrDYikt6YDn.jpg'},
           {u'character': u'',
            u'credit_id': u'525734f6760ee3776a3977e7',
            u'episode_count': 1,
            u'first_air_date': u'1989-06-10',
            u'id': 2391,
            u'name': u'Tales from the Crypt',
            u'original_name': u'Tales from the Crypt',
            u'poster_path': u'/faZKMT856LWSnzgVh3L4BMazGmz.jpg'},
           {u'character': u'',
            u'credit_id': u'52573d96760ee36aaa047b7e',
            u'episode_count': 1,
            u'first_air_date': u'1986-09-17',
            u'id': 2589,
            u'name': u'Head of the Class',
            u'original_name': u'Head of the Class',
            u'poster_path': u'/Dyy3E7SqkeuYpiQET2rIwsGPxZ.jpg'},
           {u'character': u'',
            u'credit_id': u'525753c6760ee36aaa1f53c7',
            u'episode_count': 1,
            u'first_air_date': u'2002-06-11',
            u'id': 3626,
            u'name': u'American Idol',
            u'original_name': u'American Idol',
            u'poster_path': u'/2aqueDlNwOWrszV0hKsxVk5yOgK.jpg'},
           {u'character': u'',
            u'credit_id': u'525764f9760ee36aaa357d18',
            u'episode_count': 1,
            u'first_air_date': u'1988-10-08',
            u'id': 4346,
            u'name': u"Freddy's Nightmares",
            u'original_name': u"Freddy's Nightmares",
            u'poster_path': u'/sMYfjEjK6rEF6FeiGum6g67Wor6.jpg'},
           {u'character': u'',
            u'credit_id': u'5258094919c29531db3e2f4a',
            u'episode_count': 6,
            u'first_air_date': u'2003-06-04',
            u'id': 10946,
            u'name': u'Celebrities Uncensored',
            u'original_name': u'Celebrities Uncensored',
            u'poster_path': None},
           {u'character': u'',
            u'credit_id': u'5258833a760ee346614043a6',
            u'episode_count': 3,
            u'first_air_date': u'1929-05-16',
            u'id': 27023,
            u'name': u'The Academy Awards',
            u'original_name': u'The Academy Awards',
            u'poster_path': u'/oQJeREgBeF1Afz9DABo5ymwu63Y.jpg'}],
 u'crew': [],
 u'id': 287}
classmethod register(name, schema_cls, docs=u'')

Creates a method on the API class with name name.

Parameters:
  • name – name of the method, will overwrite if already exists
  • schema_cls – class as returned by class_from_schema.
review(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.review(<parameters>)
{u'author': u'Chris',
 u'content': u"I personally thought this film is on par if not better than the Dark Knight.\r\n\r\nWhilst some think the film is too long for the story I didn't find this. The length of the film is longer than some (but doesn't feel it), I liked that the film took it's time rather than shoving more elements in it - I think this contributed to the dramatic ending (much like a classical piece of music will be relaxed and calm before the final crescendo).\r\n\r\nAt the end of the day whether you like this film will boil down to if you like films Christopher Nolan has directed and/or you like the Christopher Nolan Batman series so far.\r\n\r\nStupendously good film in my opinion.",
 u'id': u'5013bc76760ee372cb00253e',
 u'iso_639_1': u'en',
 u'media_id': 49026,
 u'media_title': u'The Dark Knight Rises',
 u'media_type': u'Movie',
 u'url': u'http://j.mp/P18dg1'}
search_collection(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:query (str) – CGI escaped string

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.search_collection(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/zuW6fOiusv4X9nnW3paHGfXcSll.jpg',
               u'id': 86311,
               u'name': u'The Avengers Collection',
               u'poster_path': u'/fMSxlk2zPpcXBn4R3TK3uqYjOpa.jpg'},
              {u'backdrop_path': None,
               u'id': 138966,
               u'name': u'The Toxic Avenger Series',
               u'poster_path': None},
              {u'backdrop_path': None,
               u'id': 32135,
               u'name': u'The Toxic Avenger Collection',
               u'poster_path': None},
              {u'backdrop_path': u'/zE4wyiYkgqu7qsNXlsjckWfimYo.jpg',
               u'id': 14706,
               u'name': u'Ultimate Avengers Collection',
               u'poster_path': u'/s77dIqIExEslhZevh5ek3NvMg80.jpg'},
              {u'backdrop_path': None,
               u'id': 142748,
               u'name': u'The Avengers Collection: Phase 1',
               u'poster_path': None}],
 u'total_pages': 1,
 u'total_results': 5}
search_company(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:query (str) – CGI escaped string

Optional

Parameters:page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.search_company(<parameters>)
{u'page': 1,
 u'results': [{u'id': 34,
               u'logo_path': u'/56VlAu08MIE926dQNfBcUwTY8np.png',
               u'name': u'Sony Pictures'},
              {u'id': 2251,
               u'logo_path': None,
               u'name': u'Sony Pictures Animation'},
              {u'id': 58,
               u'logo_path': None,
               u'name': u'Sony Pictures Classics'},
              {u'id': 5752,
               u'logo_path': None,
               u'name': u'Sony Pictures Entertainment'},
              {u'id': 7431,
               u'logo_path': None,
               u'name': u'Sony Pictures Entertainment (SPE)'},
              {u'id': 5388,
               u'logo_path': None,
               u'name': u'Sony Pictures Home Entertainment'},
              {u'id': 3045,
               u'logo_path': None,
               u'name': u'Sony Pictures Releasing'},
              {u'id': 8285,
               u'logo_path': None,
               u'name': u'Sony Pictures Studio'}],
 u'total_pages': 1,
 u'total_results': 8}
search_keyword(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:query (str) – CGI escaped string

Optional

Parameters:page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.search_keyword(<parameters>)
{u'page': 1,
 u'results': [{u'id': 1721, u'name': u'fight'},
              {u'id': 6211, u'name': u'fighter'},
              {u'id': 9878, u'name': u'fighter jet'},
              {u'id': 2533, u'name': u'fighter pilot'},
              {u'id': 12985, u'name': u'fighter jet the man'}],
 u'total_pages': 1,
 u'total_results': 5}
search_list(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:query (str) – CGI escaped string

Optional

Parameters:
  • include_adult (str) – Toggle the inclusion of adult lists.
  • page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.search_list(<parameters>)
{u'page': 1,
 u'results': [{u'description': u'A list of the films that were nominated at the 2012 Oscars for best picture.',
               u'favorite_count': 1,
               u'id': u'50941340760ee35da9000053',
               u'iso_639_1': u'en',
               u'item_count': 9,
               u'list_type': u'movie',
               u'name': u'84th Academy Awards (2012) - Best Picture Nominations',
               u'poster_path': u'/zRqBleU93WncYnIwt8LAanQerZ7.jpg'},
              {u'description': u'A list of the films that were nominated at the 2011 Oscars for best picture.',
               u'favorite_count': 1,
               u'id': u'509431ad19c2950b01000003',
               u'iso_639_1': u'en',
               u'item_count': 10,
               u'list_type': u'movie',
               u'name': u'83rd Academy Awards (2011) - Best Picture Nominations',
               u'poster_path': u'/iAHDZPyLD3NW7GuNV6U1TVtb0hN.jpg'},
              {u'description': u'A list of the films that were nominated at the 2010 Oscars for best picture.',
               u'favorite_count': 2,
               u'id': u'50956fd2760ee3698a001fb0',
               u'iso_639_1': u'en',
               u'item_count': 10,
               u'list_type': u'movie',
               u'name': u'82nd Academy Awards (2010) - Best Picture Nominations',
               u'poster_path': u'/8iwe0iP49A6Gqcv31jBleZDZqI4.jpg'},
              {u'description': u'A list of the films that were nominated at the 2009 Oscars for best picture.',
               u'favorite_count': 2,
               u'id': u'50957064760ee3698a001fc0',
               u'iso_639_1': u'en',
               u'item_count': 5,
               u'list_type': u'movie',
               u'name': u'81st Academy Awards (2009) - Best Picture Nominations',
               u'poster_path': u'/gShtwIvdSHgCEQRZfymNkEUEwFm.jpg'},
              {u'description': u'A list of the films that were nominated at the 2008 Oscars for best picture.',
               u'favorite_count': 1,
               u'id': u'509ec007760ee36f0c000916',
               u'iso_639_1': u'en',
               u'item_count': 5,
               u'list_type': u'movie',
               u'name': u'80th Academy Awards (2008) - Best Picture Nominations',
               u'poster_path': u'/nWwFabqFaBbukXdkUCmtnrFxPNh.jpg'},
              {u'description': u"Here's my list of best picture winners for the Oscars. Thought it would be neat to see them all together. There's a lot of movies here I have never even heard of.",
               u'favorite_count': 1,
               u'id': u'509ec17b19c2950a0600050d',
               u'iso_639_1': u'en',
               u'item_count': 84,
               u'list_type': u'movie',
               u'name': u'Best Picture Winners - The Academy Awards',
               u'poster_path': u'/efBm2Nm2v5kQnO0w3hYcW6hVsJU.jpg'}],
 u'total_pages': 1,
 u'total_results': 6}
search_movie(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:query (str) – CGI escaped string

Optional

Parameters:
  • language (str) – ISO 639-1 code.
  • primary_release_year (str) – Filter the results so that only the primary release dates have this value.
  • include_adult (str) – Toggle the inclusion of adult titles. Expected value is: true or false
  • search_type (str) – By default, the search type is ‘phrase’. This is almost guaranteed the option you will want. It’s a great all purpose search type and by far the most tuned for every day querying. For those wanting more of an “autocomplete” type search, set this option to ‘ngram’.
  • year (str) – Filter the results release dates to matches that include this value.
  • page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.search_movie(<parameters>)
{u'page': 1,
 u'results': [{u'adult': False,
               u'backdrop_path': u'/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg',
               u'id': 550,
               u'original_title': u'Fight Club',
               u'popularity': 61151.745,
               u'poster_path': u'/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg',
               u'release_date': u'1999-10-15',
               u'title': u'Fight Club',
               u'vote_average': 9.1,
               u'vote_count': 174},
              {u'adult': False,
               u'backdrop_path': u'/5Z0FScA1bB6EbdGmZCUBeUk32eV.jpg',
               u'id': 14476,
               u'original_title': u'Clubbed',
               u'popularity': 1.729,
               u'poster_path': u'/bl6PEQtmohEP1zP9srNZY6bXyHg.jpg',
               u'release_date': u'2008-10-02',
               u'title': u'Clubbed',
               u'vote_average': 7.8,
               u'vote_count': 3},
              {u'adult': False,
               u'backdrop_path': u'/qw2Qb42xtyE1B449JoTgb1mVCe1.jpg',
               u'id': 51021,
               u'original_title': u'Lure: Teen Fight Club',
               u'popularity': 0.266,
               u'poster_path': u'/aRTX5Y52yGbVL6TGnyI4E8jjtz4.jpg',
               u'release_date': u'2010-11-16',
               u'title': u'Lure: Teen Fight Club',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'adult': False,
               u'backdrop_path': u'/tcoAGvTo96R7Y9ZGVCCz7BZvrvb.jpg',
               u'id': 104782,
               u'original_title': u'Florence Fight Club',
               u'popularity': 0.085,
               u'poster_path': u'/eQqqu0srTYcclWqylvgpLyU87hV.jpg',
               u'release_date': u'2010-01-01',
               u'title': u'Florence Fight Club',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'adult': False,
               u'backdrop_path': None,
               u'id': 115584,
               u'original_title': u'Fight Club \u2013 The \u201cI am Jack\u2019s Laryngitis\u201d Edit',
               u'popularity': 0.06,
               u'poster_path': None,
               u'release_date': None,
               u'title': u'Fight Club \u2013 The \u201cI am Jack\u2019s Laryngitis\u201d Edit',
               u'vote_average': 0.0,
               u'vote_count': 0}],
 u'total_pages': 1,
 u'total_results': 5}
search_person(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:query (str) – CGI escaped string

Optional

Parameters:
  • search_type (str) – By default, the search type is ‘phrase’. This is almost guaranteed the option you will want. It’s a great all purpose search type and by far the most tuned for every day querying. For those wanting more of an “autocomplete” type search, set this option to ‘ngram’.
  • include_adult (str) – Toggle the inclusion of adult titles. Expected value is: true or false
  • page (int) – Minimum 1, maximum 1000.
Usage:
>>> api = tmdb.API(api_key)
>>> api.search_person(<parameters>)
{u'page': 1,
 u'results': [{u'adult': False,
               u'id': 287,
               u'name': u'Brad Pitt',
               u'profile_path': u'/w8zJQuN7tzlm6FY9mfGKihxp3Cb.jpg'}],
 u'total_pages': 1,
 u'total_results': 1}
search_tv(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:query (str) – CGI escaped string

Optional

Parameters:
  • search_type (str) – By default, the search type is ‘phrase’. This is almost guaranteed the option you will want. It’s a great all purpose search type and by far the most tuned for every day querying. For those wanting more of an “autocomplete” type search, set this option to ‘ngram’.
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
  • first_air_date_year (str) – Filter the results to only match shows that have a air date with with value.
Usage:
>>> api = tmdb.API(api_key)
>>> api.search_tv(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/dRaV8HGx7Z9xmw77qSs8prp5OuI.jpg',
               u'first_air_date': u'2008-01-20',
               u'id': 1396,
               u'name': u'Breaking Bad',
               u'original_name': u'Breaking Bad',
               u'popularity': 12.4586534614178,
               u'poster_path': u'/iRDNn9EHKuBhGa77UBteazvsZa1.jpg',
               u'vote_average': 8.7,
               u'vote_count': 8}],
 u'total_pages': 1,
 u'total_results': 1}
tv(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any tv series method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv(<parameters>)
{u'backdrop_path': u'/dRaV8HGx7Z9xmw77qSs8prp5OuI.jpg',
 u'created_by': [{u'id': 66633,
                  u'name': u'Vince Gilligan',
                  u'profile_path': u'/wSTvJGz7QbJf1HK2Mv1Cev6W9TV.jpg'}],
 u'episode_run_time': [45, 47],
 u'first_air_date': u'2008-01-20',
 u'genres': [{u'id': 18, u'name': u'Drama'}],
 u'homepage': u'http://www.amctv.com/shows/breaking-bad',
 u'id': 1396,
 u'in_production': False,
 u'languages': [u'en'],
 u'last_air_date': u'2013-09-29',
 u'name': u'Breaking Bad',
 u'networks': [{u'id': 174, u'name': u'AMC'}],
 u'number_of_episodes': 62,
 u'number_of_seasons': 5,
 u'origin_country': [u'US'],
 u'original_name': u'Breaking Bad',
 u'overview': u"Breaking Bad is an American crime drama television series created and produced by Vince Gilligan. Set and produced in Albuquerque, New Mexico, Breaking Bad is the story of Walter White, a struggling high school chemistry teacher who is diagnosed with inoperable lung cancer at the beginning of the series. He turns to a life of crime, producing and selling methamphetamine, in order to secure his family's financial future before he dies, teaming with his former student, Jesse Pinkman. Heavily serialized, the series is known for positioning its characters in seemingly inextricable corners and has been labeled a contemporary western by its creator.",
 u'popularity': 12.4586534614178,
 u'poster_path': u'/iRDNn9EHKuBhGa77UBteazvsZa1.jpg',
 u'seasons': [{u'air_date': u'2009-02-17',
               u'poster_path': u'/AngNuUbXSciwLnUXtdOBHqphxNr.jpg',
               u'season_number': 0},
              {u'air_date': u'2008-01-20',
               u'poster_path': u'/l5s5lfqpdP4uigrZtu5Sg8hfWqG.jpg',
               u'season_number': 1},
              {u'air_date': u'2009-03-08',
               u'poster_path': u'/mYsNUgov0AtEnwpNeopj1lgMTf2.jpg',
               u'season_number': 2},
              {u'air_date': u'2010-03-21',
               u'poster_path': u'/iS71H8LZoxjh6267LHSHda8LS3L.jpg',
               u'season_number': 3},
              {u'air_date': u'2011-07-17',
               u'poster_path': u'/yeYikV0L4kFlXL6KCamV7yikIUz.jpg',
               u'season_number': 4},
              {u'air_date': u'2012-07-15',
               u'poster_path': u'/8bnD50mYDcoYER5ZcarjBGgAEb6.jpg',
               u'season_number': 5}],
 u'status': u'Ended',
 u'vote_average': 8.6875,
 u'vote_count': 8}
tv_credits(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any collection method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_credits(<parameters>)
{u'cast': [{u'character': u'Walter White',
            u'credit_id': u'52542282760ee313280017f9',
            u'id': 17419,
            u'name': u'Bryan Cranston',
            u'order': 0,
            u'profile_path': u'/vr3YaG9ehqQY82fsxOFZvlqncX7.jpg'},
           {u'character': u'Skyler White',
            u'credit_id': u'52542282760ee3132800181b',
            u'id': 134531,
            u'name': u'Anna Gunn',
            u'order': 1,
            u'profile_path': u'/lKlGjfmu9mJcF4upNrhtG3X9uyq.jpg'},
           {u'character': u'Jesse Pinkman',
            u'credit_id': u'52542282760ee31328001845',
            u'id': 84497,
            u'name': u'Aaron Paul',
            u'order': 2,
            u'profile_path': u'/oTceEUb6A9Bg6DeUTJBTETUOEAy.jpg'},
           {u'character': u'Hank Schrader',
            u'credit_id': u'52542283760ee3132800187b',
            u'id': 14329,
            u'name': u'Dean Norris',
            u'order': 3,
            u'profile_path': u'/500eNhWneDTXQuEXg6BR269IjHr.jpg'},
           {u'character': u'Marie Schrader',
            u'credit_id': u'52542283760ee31328001891',
            u'id': 1217934,
            u'name': u'Betsy Brandt',
            u'order': 4,
            u'profile_path': u'/zpmsca1HCVqYrtWXV9xdmsECDTI.jpg'},
           {u'character': u'Walter White Jr.',
            u'credit_id': u'52542284760ee313280018a9',
            u'id': 1223196,
            u'name': u'RJ Mitte',
            u'order': 5,
            u'profile_path': u'/hO5HJKM6p6SQjpdV8Fs64BJWzmT.jpg'},
           {u'character': u'Saul Goodman',
            u'credit_id': u'5271b180760ee35afc09bb8d',
            u'id': 59410,
            u'name': u'Bob Odenkirk',
            u'order': 11,
            u'profile_path': u'/p905eCTyeda8xqMSKoRY14ZvdiH.jpg'}],
 u'crew': [{u'department': u'Production',
            u'id': 29779,
            u'job': u'Executive Producer',
            u'name': u'Michelle MacLaren',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 5162,
            u'job': u'Executive Producer',
            u'name': u'Mark Johnson',
            u'profile_path': u'/yKGF6cbzyP03Gl1QhVLCu1gWSW6.jpg'},
           {u'department': u'Production',
            u'id': 66633,
            u'job': u'Executive Producer',
            u'name': u'Vince Gilligan',
            u'profile_path': u'/wSTvJGz7QbJf1HK2Mv1Cev6W9TV.jpg'}],
 u'id': 1396}
tv_external_ids(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_external_ids(<parameters>)
{u'freebase_id': u'/en/breaking_bad',
 u'freebase_mid': u'/m/03d34x8',
 u'id': 1396,
 u'imdb_id': u'tt0903747',
 u'tvdb_id': 81189,
 u'tvrage_id': 18164}
tv_images(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –

Optional

Parameters:
  • include_image_language (str) – Comma separated, a valid ISO 69-1.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_images(<parameters>)
{u'backdrops': [{u'aspect_ratio': 1.78,
                 u'file_path': u'/dRaV8HGx7Z9xmw77qSs8prp5OuI.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/mojM8NJQlpTWpiD68rcOWnzcEVR.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/nIh1ygw5kVRaEFqXcj8CTi3pKK5.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/bbFaLaLv8TwR7KKnZ3reHGS4VQO.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/bFWW5vVZS1YW0a0Cq0liYakj6vt.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/siv4GtEMtrqljl0qiTGCvzolXWH.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/wvFckSZAG1OVPEwM8YUtLC3DOWk.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/162VmHV23N1FqQhYjZiZCH9GkQA.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/yG8QDHyrVMBe5H7Q7cIPKq45Iq0.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/gzqjlgcYIHZSnUS1bnxVDxQwCR0.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/eIOpMbnMqiAgBS8cZocAATRsb28.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/9V1yohvMOePVd6b1WiUItPEN8sK.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/bzoZjhbpriBT2N5kwgK0weUfVOX.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/n5kIjzyYNdDfJbfNkG68j3qDm6n.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/qfWveejMEeA4zGgscX8YUUTLuTB.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/6tRuCy7VXidZVRXIR4ThBx2omK3.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/3FnSPz1nqkaW65dj4BWRN185adp.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/va7jNaQUsIdWADokQSdPXeJYk1O.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/nXlTbIrgroOCCKQSsMizmqQ4NAG.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/bZ23G5JiNmeZG9t6hRMLhY9W3gP.jpg',
                 u'height': 720.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1280.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/eSzpy96DwBujGFj0xMbXBcGcfxX.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/mrPw1gAXXV8OYQTr8ipKuYTuaa6.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/gVqPqjyiDmpoNJOFjvg0b8WCC3R.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/bagJdiz7JzB1bb87x24qKwrgWwK.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/an69IYogpnY2spo1dGVjmTy0m49.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/eCaT3wx244KPmnMchvag3kSGGw5.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/u3TcKJ1qqgd8D3Dd73FnIMVVsur.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/yFVUqiugxQLLrYxwsIcGQ3P8FWO.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/qamG9LeH42UombW1bfZlIlzO5Y1.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/6u4YG0oNzhFaFJs080ljlpSgpfD.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/ewRICWQvNXsViiUouM3M3jm5VyI.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/qgSmYpFBZdfHbjssjJN1XOrb2Us.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/tJAeZ3OoWDC1LVe7IBmGnBSOYZX.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/zzSjSRC04z7dc4xQopWTJYmXb9g.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/vIgu5fsJH50QcSz2hmfaqJHovUo.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/upeNbWF5wKZUOUcUW4EnVfYYjRo.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/oyOGhA8G74rd8c6VdeU3Mi7v8n7.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/2X0RK6uztO7J5XBSRtRcNGlzGml.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/gN14vIo5T2G3kwtdS1lHuFeJXJ9.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/2cxsSpTNb8SFczKLrnXlhw2p7hW.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/yjcJtXWrQfU96l3b46iMvNNpg3Z.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/5sHew9rjOsALuDVxwu0pJexOXWA.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/61nBiocMvOxvPtJgxk3GLCePvcf.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/aIOpF9Fp1SbYpSusJ3scDTYrqod.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/bTJLGUbqcGAuZnNvp59zjqqLzOR.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/y3Roit8o1v7EYXGqH7AQMNUBZQR.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/mpfWjvSmNaYCzfUmfnGe1A1wkbu.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/77q8qOwsEJyZGDf3nzhq13bg98X.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/zintOUBVjVapaNN3vAmm1rcfY1p.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/rmOmfel02YAgVRUdb9tlRyLW8mm.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/23RzDwwd78gCffMoBXoOKKSRlcr.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/m5apfrjjgc7jbOwRTXqDF5EXXfO.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/nxVC9a6TjeoKr6Ezkfz1jRSlf6L.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/qnnW0CY89lQZPgNrwpARJOBQtI1.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/k2N2DpK7kDcM0rXLKuTV6bUTIZN.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/ebQo1jOfx9UR9cPzBa6bHpxMWhq.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/rMvlRVBngldwWCoGqxQoPdJRnwC.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/abFs25RWEvn8WkLholkqFAUC8OF.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/lPQn4F48YL5IwwrjPx6QRRuDyjR.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/v5F4chUYiRnH9cI2JCpWrrK3q6D.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/ymrPqhHl8v9tf3eK3f9byggZ0n7.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0},
                {u'aspect_ratio': 1.78,
                 u'file_path': u'/99PL1OnOT9PVZx09qerR0s1g0Gx.jpg',
                 u'height': 1080.0,
                 u'iso_639_1': None,
                 u'vote_average': 0.0,
                 u'vote_count': 0,
                 u'width': 1920.0}],
 u'id': 1396,
 u'posters': [{u'aspect_ratio': 0.68,
               u'file_path': u'/iRDNn9EHKuBhGa77UBteazvsZa1.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 5.29761904761905,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/51H0ifZ0TM5sAp4yBvolUpFaPaC.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/xkbl9GV6p9JwDPXIYwODVcunlRT.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/u69b0G6HlfrwkchQdn8lzEEjFxt.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/8VxH7FSiCDmSZyfxsqz25ZWbP7O.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/hyWz3p2KCxw3T3OTyFzQgYvkhJf.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/7pFpIXpn2DOst3bOMQIqCEHeAWS.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/mmtUaqRpsWcqb4ISF3CaoK0ptO7.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/i5bfplXbyLm7BvofUBVj7Zaan4w.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/mVIvcV9IEsfnTdbNXPNWkiU6N7t.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/e6Ydx9xHuiQa6qsx20LR4x71DCS.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/3bHLOzAOY2Rn4c5YrvALzZVE6tg.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/t9r2UYuRppdZKmeYHSgdx09uHzl.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/3feoWsQPtBdUhrOCVPB1iazSb2W.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/fO3OqQQEIZN44K9jcs0Q4JuFHOl.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/uL7s6lRsApvFuxQFqT5FA1SuSdX.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/6uiT7QidRjVVywFgOAUQoY7iPup.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/1gNZDkSc1kb9azLYVQHS9DCBpAs.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/zdipQZmcmaCUNGsXP6OdBEjDCSP.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/xd8tk9ox8QvQClvD48bmQc2t6dx.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/pOLOC2tzz70N1RngVZtfhJuB5Fp.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/85fOzuORUuQlDPSNkFCDnaUXZtv.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/21YJ4mM7C9V5e2esqeB4AoBjKPy.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/xMvrBjxu2EskHhiZ2sNgufBhGzF.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/wnoMOVO06oI55fWrR0mQUbquERh.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/nXXSNb8qXn66DeZL0BIG79Omyo2.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/biPjf15logCBAIptiM1YYCOeTxE.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/ccxTzJHWYhAGg3MFaTzGfpFAXGi.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/oAJvOW85rXKs8GlWoT5jssd7qNU.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0},
              {u'aspect_ratio': 0.68,
               u'file_path': u'/fzNaunYfNFvVesiIvcEgr8h4qix.jpg',
               u'height': 1000.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 680.0}]}
tv_on_the_air(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_on_the_air(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/fbYSM5VXo9Gaq8V6vlCSv6KRHlx.jpg',
               u'first_air_date': u'2007-09-24',
               u'id': 1418,
               u'name': u'The Big Bang Theory',
               u'original_name': u'The Big Bang Theory',
               u'popularity': 11.5535887985512,
               u'poster_path': u'/mYOWdfjuYqiZC1VS2SPefW3g38Q.jpg',
               u'vote_average': 8.8,
               u'vote_count': 31},
              {u'backdrop_path': u'/ghyPciT8yfUDTvVjw8xunO6S5ha.jpg',
               u'first_air_date': u'1999-09-20',
               u'id': 2734,
               u'name': u'Law & Order: Special Victims Unit',
               u'original_name': u'Law & Order: Special Victims Unit',
               u'popularity': 9.91637980901835,
               u'poster_path': u'/7x6B75S7mvMiVf2rmyyHdyxgBP.jpg',
               u'vote_average': 8.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/lJ41HJE9WFwJcv97JZgAieAkLsv.jpg',
               u'first_air_date': u'2003-09-23',
               u'id': 4614,
               u'name': u'NCIS',
               u'original_name': u'NCIS',
               u'popularity': 8.65341203884912,
               u'poster_path': u'/4fXBP3R2n193C6QvthPmvFprNs0.jpg',
               u'vote_average': 9.0,
               u'vote_count': 3},
              {u'backdrop_path': u'/27cshLy9anL9G0g6tBQjWkPACx5.jpg',
               u'first_air_date': u'2003-09-22',
               u'id': 2691,
               u'name': u'Two and a Half Men',
               u'original_name': u'Two and a Half Men',
               u'popularity': 4.93450662449812,
               u'poster_path': u'/xelYee3gb9FwnQ2rVE9mnj3sNAl.jpg',
               u'vote_average': 7.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/faW7Ky7j1jEn8X366oG2VpUtuvr.jpg',
               u'first_air_date': u'1975-10-11',
               u'id': 1667,
               u'name': u'Saturday Night Live',
               u'original_name': u'Saturday Night Live',
               u'popularity': 4.62572793147955,
               u'poster_path': u'/daNm0Tx09oJ5SZSa7M744Ezi7LQ.jpg',
               u'vote_average': 8.3,
               u'vote_count': 3},
              {u'backdrop_path': u'/jGfC9Z0AGBWVtsoPSNX399eARZX.jpg',
               u'first_air_date': u'2011-10-05',
               u'id': 1413,
               u'name': u'American Horror Story',
               u'original_name': u'American Horror Story',
               u'popularity': 4.29531979881881,
               u'poster_path': u'/aq7GRQMSWrVeSU9P1xrlEibjdP5.jpg',
               u'vote_average': 8.6,
               u'vote_count': 6},
              {u'backdrop_path': u'/xus42dRSs7bPlnoQkrgrV4ZMSUv.jpg',
               u'first_air_date': u'2002-10-20',
               u'id': 45,
               u'name': u'Top Gear',
               u'original_name': u'Top Gear',
               u'popularity': 3.66881695594066,
               u'poster_path': u'/l44jW1b3vMvtphoubTC1mRcYz1m.jpg',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/mIOAjMxqJhVVv07fpIOPQN1TPNs.jpg',
               u'first_air_date': u'2011-09-20',
               u'id': 1420,
               u'name': u'New Girl',
               u'original_name': u'New Girl',
               u'popularity': 3.34965207165466,
               u'poster_path': u'/iirKvUv5IFBFnJx9Rhhza95Gn22.jpg',
               u'vote_average': 6.3,
               u'vote_count': 2},
              {u'backdrop_path': u'/53YG3cXfRIzVY7uIJMPSDu5kbZH.jpg',
               u'first_air_date': u'2014-01-19',
               u'id': 57774,
               u'name': u'Looking',
               u'original_name': u'Looking',
               u'popularity': 3.33622521564925,
               u'poster_path': u'/9prQbZnshCPYbSoxAZPSjDIggoq.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/mRApMhtHABq8t4IboWI3RvepWWN.jpg',
               u'first_air_date': u'2013-01-11',
               u'id': 41727,
               u'name': u'Banshee',
               u'original_name': u'Banshee',
               u'popularity': 3.17398986510082,
               u'poster_path': u'/kQ26o4lj2WBfG8zD8xBLsd84GBa.jpg',
               u'vote_average': 9.3,
               u'vote_count': 3},
              {u'backdrop_path': u'/vFGQEMDQzf5tkThlyfWaiffxIKp.jpg',
               u'first_air_date': u'2005-09-13',
               u'id': 1622,
               u'name': u'Supernatural',
               u'original_name': u'Supernatural',
               u'popularity': 3.11489170202992,
               u'poster_path': u'/8oIaF6EV4sCXSLnPv19KQtRRrjv.jpg',
               u'vote_average': 9.1,
               u'vote_count': 6},
              {u'backdrop_path': u'/sDSfnBJB8oWfm53tyimQBFmD9kd.jpg',
               u'first_air_date': u'2009-03-08',
               u'id': 1419,
               u'name': u'Castle',
               u'original_name': u'Castle',
               u'popularity': 2.94097387171674,
               u'poster_path': u'/zBPHFtJ1Vl0yhQEgTdxIswcGzzV.jpg',
               u'vote_average': 8.8,
               u'vote_count': 12},
              {u'backdrop_path': u'/fzPAPCdO0hTolzsRgWCkJVu3SQO.jpg',
               u'first_air_date': u'2005-09-12',
               u'id': 1911,
               u'name': u'Bones',
               u'original_name': u'Bones',
               u'popularity': 2.81454928308749,
               u'poster_path': u'/4UGIjLJ8fX1LYtivNIyRFVkXUhx.jpg',
               u'vote_average': 9.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/dujFtBLGYmekTB1vUg1eQj0hy47.jpg',
               u'first_air_date': u'2009-04-09',
               u'id': 8592,
               u'name': u'Parks and Recreation',
               u'original_name': u'Parks and Recreation',
               u'popularity': 2.77872544971382,
               u'poster_path': u'/xt4FRS94639HNRf2IUCqdPRxNuD.jpg',
               u'vote_average': 8.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/2IVOSXUZYsCbbJxaiszHYoJMaJv.jpg',
               u'first_air_date': u'2013-03-30',
               u'id': 45094,
               u'name': u'The Following',
               u'original_name': u'The Following',
               u'popularity': 2.66040158414138,
               u'poster_path': u'/bOABsbXsCrmCs6KqKA077IbKR0y.jpg',
               u'vote_average': 6.6,
               u'vote_count': 4},
              {u'backdrop_path': u'/hLZmWeRSCBIskZ1sCFO14b4H3SE.jpg',
               u'first_air_date': u'2010-03-16',
               u'id': 1436,
               u'name': u'Justified',
               u'original_name': u'Justified',
               u'popularity': 1.7940629699477,
               u'poster_path': u'/ey0u2QeTZDjLmpeb3itHhOSFL5m.jpg',
               u'vote_average': 8.6,
               u'vote_count': 4},
              {u'backdrop_path': u'/9quXduCcoWcUtcnMOKZb9J77Gev.jpg',
               u'first_air_date': u'2009-09-17',
               u'id': 18347,
               u'name': u'Community',
               u'original_name': u'Community',
               u'popularity': 1.79199317279452,
               u'poster_path': u'/4mW6xxN8pHtfECWGNHQQmoP34J.jpg',
               u'vote_average': 9.3,
               u'vote_count': 5},
              {u'backdrop_path': u'/7FKInN6nPjnqch1Ytym0KvCMdQE.jpg',
               u'first_air_date': u'2011-09-22',
               u'id': 1411,
               u'name': u'Person of Interest',
               u'original_name': u'Person of Interest',
               u'popularity': 1.78541559275514,
               u'poster_path': u'/ttDoHm3VbCBRVdKxgffUG2pPPbu.jpg',
               u'vote_average': 8.0,
               u'vote_count': 6},
              {u'backdrop_path': u'/scivLGg7zdqmdw5eDW3rvrEavr6.jpg',
               u'first_air_date': u'2012-10-10',
               u'id': 1412,
               u'name': u'Arrow',
               u'original_name': u'Arrow',
               u'popularity': 1.64221548027791,
               u'poster_path': u'/tTCFtCkQ3FduLuuPyc2YqAhO4Xb.jpg',
               u'vote_average': 8.3,
               u'vote_count': 4},
              {u'backdrop_path': u'/rBC3uuats7KOYxEoCieq2cvHmCo.jpg',
               u'first_air_date': u'2002-06-11',
               u'id': 3626,
               u'name': u'American Idol',
               u'original_name': u'American Idol',
               u'popularity': 1.63472747850521,
               u'poster_path': u'/2aqueDlNwOWrszV0hKsxVk5yOgK.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0}],
 u'total_pages': 4,
 u'total_results': 79}

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_popular(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/A9jyYzO8XEogAHV7LBxF2vWAAXj.jpg',
               u'first_air_date': u'1999-01-31',
               u'id': 1434,
               u'name': u'Family Guy',
               u'original_name': u'Family Guy',
               u'popularity': 13.790419427048,
               u'poster_path': u'/n3UBzIx28m3FpC2EDwVJIjvPxnl.jpg',
               u'vote_average': 8.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/6tL4eiGmXJZI2eMWh1rgHdv58kb.jpg',
               u'first_air_date': u'1996-07-22',
               u'id': 2224,
               u'name': u'The Daily Show',
               u'original_name': u'The Daily Show',
               u'popularity': 13.4722825949149,
               u'poster_path': u'/pnQmYxMlJBvnyFElFHbzsPlOUUx.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/gyjHOqa3UhJ6XcKhSSLAlZV38Dl.jpg',
               u'first_air_date': u'2011-04-17',
               u'id': 1399,
               u'name': u'Game of Thrones',
               u'original_name': u'Game of Thrones',
               u'popularity': 10.2458449125787,
               u'poster_path': u'/97p6ypjCkiqxNc1b44oO630IMmn.jpg',
               u'vote_average': 9.38888888888889,
               u'vote_count': 9},
              {u'backdrop_path': u'/knB3yzqu3ofy1mR9A3oREijnU7e.jpg',
               u'first_air_date': u'1994-09-19',
               u'id': 4588,
               u'name': u'ER',
               u'original_name': u'ER',
               u'popularity': 9.89607208948336,
               u'poster_path': u'/qnllIuJI11tskEolTd3QsbR0TuC.jpg',
               u'vote_average': 6.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/fxX3PtHJBj18QJ31jUMNelMKGDe.jpg',
               u'first_air_date': u'2004-11-16',
               u'id': 1408,
               u'name': u'House',
               u'original_name': u'House',
               u'popularity': 9.19286324052243,
               u'poster_path': u'/j2Ny9P6RY9i3lfxdyePEUVSN4o5.jpg',
               u'vote_average': 8.33333333333333,
               u'vote_count': 3},
              {u'backdrop_path': u'/oxxDLIIUfLUANRiK7fhPuKOlKpz.jpg',
               u'first_air_date': u'1959-10-02',
               u'id': 6357,
               u'name': u'The Twilight Zone',
               u'original_name': u'The Twilight Zone',
               u'popularity': 9.16107665720407,
               u'poster_path': u'/zj7T398lYzWFMH4yWdm7g0elUAI.jpg',
               u'vote_average': 10.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/dRaV8HGx7Z9xmw77qSs8prp5OuI.jpg',
               u'first_air_date': u'2008-01-20',
               u'id': 1396,
               u'name': u'Breaking Bad',
               u'original_name': u'Breaking Bad',
               u'popularity': 8.45479759011426,
               u'poster_path': u'/j5k6ZTYqamPDZplCCXuokjJ2PoJ.jpg',
               u'vote_average': 8.875,
               u'vote_count': 12},
              {u'backdrop_path': u'/dzlh310N8QfUDqgoo0CO7r3hThp.jpg',
               u'first_air_date': u'2002-06-03',
               u'id': 2097,
               u'name': u'Crank Yankers',
               u'original_name': u'Crank Yankers',
               u'popularity': 7.32,
               u'poster_path': u'/jtU36qpj08j7yVmMklwawQFHFyj.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/wY9tYxyhFRDGkQIFGpk4VkVsiXR.jpg',
               u'first_air_date': u'1989-12-17',
               u'id': 456,
               u'name': u'The Simpsons',
               u'original_name': u'The Simpsons',
               u'popularity': 7.29736254806427,
               u'poster_path': u'/oadXgs77zoLQm04J9dG4fQ3Huwn.jpg',
               u'vote_average': 8.3,
               u'vote_count': 5},
              {u'backdrop_path': u'/xoAZmXIULNTZFRQTimeV7e84zxt.jpg',
               u'first_air_date': u'1979-08-24',
               u'id': 1803,
               u'name': u'The Facts of Life',
               u'original_name': u'The Facts of Life',
               u'popularity': 7.0088,
               u'poster_path': u'/9UqHOIl3nnzsCUobMCfgnhkwi7L.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/7P1HSNGCeMAM4hoMjATzlZ1wfOg.jpg',
               u'first_air_date': u'2000-10-06',
               u'id': 1431,
               u'name': u'CSI: Crime Scene Investigation',
               u'original_name': u'CSI: Crime Scene Investigation',
               u'popularity': 6.81113734071392,
               u'poster_path': u'/5W2qOtSh52ZgJTiaioEsmnbp2xu.jpg',
               u'vote_average': 4.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/8ISefhDLp5WBdIgJrauvvchSNzp.jpg',
               u'first_air_date': u'2001-11-06',
               u'id': 1973,
               u'name': u'24',
               u'original_name': u'24',
               u'popularity': 6.62384520295129,
               u'poster_path': u'/8MkrR4VhXuq1OunAx6ONdoRN1iL.jpg',
               u'vote_average': 7.5,
               u'vote_count': 3},
              {u'backdrop_path': u'/6BVPbctq0RVCtjiopUddIoqHyR6.jpg',
               u'first_air_date': u'1999-09-22',
               u'id': 4461,
               u'name': u'Rove',
               u'original_name': u'Rove',
               u'popularity': 6.5164717206,
               u'poster_path': u'/5ZuXifDbgvl3XHVSXNUBVskSmQf.jpg',
               u'vote_average': 0.0,
               u'vote_count': 0},
              {u'backdrop_path': u'/kgadTwNJYYGZ7LTrw9X7KDiRCfV.jpg',
               u'first_air_date': u'2006-10-01',
               u'id': 1405,
               u'name': u'Dexter',
               u'original_name': u'Dexter',
               u'popularity': 6.30021577329623,
               u'poster_path': u'/eIoAzf9czDSWqYneE1fZTQ3iJhB.jpg',
               u'vote_average': 8.64285714285714,
               u'vote_count': 7},
              {u'backdrop_path': u'/kL9nHBwMfFsVWROL8hRpSVGNigp.jpg',
               u'first_air_date': u'2007-07-24',
               u'id': 4920,
               u'name': u'Damages',
               u'original_name': u'Damages',
               u'popularity': 5.981,
               u'poster_path': u'/6hcca4kh8XhUI5bSc7Em8SJz5jp.jpg',
               u'vote_average': 7.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/m9Vf8V4j9P6oiVgeCPbC1YObaa3.jpg',
               u'first_air_date': u'1997-01-12',
               u'id': 2122,
               u'name': u'King of the Hill',
               u'original_name': u'King of the Hill',
               u'popularity': 5.83303019806081,
               u'poster_path': u'/r6dIrTjWLE3GfcTZzrDYikt6YDn.jpg',
               u'vote_average': 3.0,
               u'vote_count': 1},
              {u'backdrop_path': u'/ghyPciT8yfUDTvVjw8xunO6S5ha.jpg',
               u'first_air_date': u'1999-09-20',
               u'id': 2734,
               u'name': u'Law & Order: Special Victims Unit',
               u'original_name': u'Law & Order: Special Victims Unit',
               u'popularity': 5.81079859264717,
               u'poster_path': u'/tsxiLPFlpNlJaMFlKIFqffGkiJt.jpg',
               u'vote_average': 8.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/ikUfFMLSU47N9PXRGb91cO6VPFn.jpg',
               u'first_air_date': u'1987-09-28',
               u'id': 655,
               u'name': u'Star Trek: The Next Generation',
               u'original_name': u'Star Trek: The Next Generation',
               u'popularity': 5.7932029846227,
               u'poster_path': u'/lLOFWqf93nZQiwEW0g8aXdEZgp6.jpg',
               u'vote_average': 7.25,
               u'vote_count': 2},
              {u'backdrop_path': u'/odkSy8k2ukwQiaV6IbwgiIitQ3F.jpg',
               u'first_air_date': u'2006-03-12',
               u'id': 4392,
               u'name': u'Big Love',
               u'original_name': u'Big Love',
               u'popularity': 5.66592090311432,
               u'poster_path': u'/vkmApTL7BDUYjIoPPWbTNH7bUPc.jpg',
               u'vote_average': 7.5,
               u'vote_count': 1},
              {u'backdrop_path': u'/fbYSM5VXo9Gaq8V6vlCSv6KRHlx.jpg',
               u'first_air_date': u'2007-09-24',
               u'id': 1418,
               u'name': u'The Big Bang Theory',
               u'original_name': u'The Big Bang Theory',
               u'popularity': 5.51313041118904,
               u'poster_path': u'/mYOWdfjuYqiZC1VS2SPefW3g38Q.jpg',
               u'vote_average': 7.70833333333333,
               u'vote_count': 12}],
 u'total_pages': 3027,
 u'total_results': 60530}
tv_season(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • season_number (int) –
  • id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any tv season method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season(<parameters>)
{u'air_date': u'2008-01-20',
 u'episodes': [{u'air_date': u'2008-01-20',
                u'episode_number': 1,
                u'name': u'Pilot',
                u'overview': u'When an unassuming high school chemistry teacher discovers he has a rare form of lung cancer, he decides to team up with a former student and create a top of the line crystal meth in a used RV, to provide for his family once he is gone.',
                u'still_path': u'/2IksiG9RPQ4lxYxgiKEhns0N4Zx.jpg',
                u'vote_average': 0.0,
                u'vote_count': 0},
               {u'air_date': u'2008-01-27',
                u'episode_number': 2,
                u'name': u"The Cat's in the Bag",
                u'overview': u"Walt and Jesse attempt to tie up loose ends. The desperate situation gets more complicated with the flip of a coin. Walt's wife, Skyler, becomes suspicious of Walt's strange behavior.",
                u'still_path': u'/vJ1vrL8e8yvQr0YgQTnblsCYpX.jpg',
                u'vote_average': 0.0,
                u'vote_count': 0},
               {u'air_date': u'2008-02-10',
                u'episode_number': 3,
                u'name': u"...and the Bag's in the River",
                u'overview': u'Walter fights with Jesse over his drug use, causing him to leave Walter alone with their captive, Krazy-8. Meanwhile, Hank has a scared straight moment with Walter Jr. after his aunt discovers he has been smoking pot. Also, Skylar is upset when Walter stays away from home.',
                u'still_path': u'/7g6DF8h278O3Srf4jF8cvqDjoie.jpg',
                u'vote_average': 0.0,
                u'vote_count': 0},
               {u'air_date': u'2008-02-17',
                u'episode_number': 4,
                u'name': u'Cancer Man',
                u'overview': u"Walter finally tells his family that he has been stricken with cancer. Meanwhile, the DEA believes Albuquerque has a new, big time player to worry about. Meanwhile, a worthy recipient is the target of a depressed Walter's anger, and Jesse makes a surprise visit to his parents home.",
                u'still_path': u'/8GDbEW4xRO2z5H0DcJirRm7ClRm.jpg',
                u'vote_average': 0.0,
                u'vote_count': 0},
               {u'air_date': u'2008-02-24',
                u'episode_number': 5,
                u'name': u'Gray Matter',
                u'overview': u"Walter and Skyler attend a former colleague's party. Jesse tries to free himself from the drugs, while Skyler organizes an intervention.",
                u'still_path': u'/mBFdvMaBCqAZf89UPabErBgWIHD.jpg',
                u'vote_average': 0.0,
                u'vote_count': 0},
               {u'air_date': u'2008-03-02',
                u'episode_number': 6,
                u'name': u"Crazy Handful of Nothin'",
                u'overview': u'The side effects of chemo begin to plague Walt. Meanwhile, the DEA rounds up suspected dealers.',
                u'still_path': u'/dv0pPCHt7dzJf4bitJeiCsj6FS8.jpg',
                u'vote_average': 0.0,
                u'vote_count': 0},
               {u'air_date': u'2008-03-09',
                u'episode_number': 7,
                u'name': u'A No-Rough-Stuff Type Deal',
                u'overview': u"Walter accepts his new identity as a drug dealer after a PTA meeting. Elsewhere, Jesse decides to put his aunt's house on the market and Skyler is the recipient of a baby shower.",
                u'still_path': u'/aE3Ixy32djH9PeU4vCn8RAyfd6k.jpg',
                u'vote_average': 0.0,
                u'vote_count': 0}],
 u'id': 3572,
 u'name': u'Season 1',
 u'overview': u"The first season of the American television drama series Breaking Bad premiered on January 20, 2008 and concluded on March 9, 2008. It consisted of seven episodes, each running approximately 47 minutes in length, except the pilot episode which runs approximately 57 minutes. AMC broadcast the first season on Sundays at 10:00 pm in the United States. Season one was to consist of nine episodes, which was reduced to seven by the writer's strike. The complete first season was released on Region 1 DVD on February 24, 2009 and Region A Blu-ray on March 16, 2010.",
 u'poster_path': u'/l5s5lfqpdP4uigrZtu5Sg8hfWqG.jpg',
 u'season_number': 1}
tv_season_credits(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • season_number (int) –
  • id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season_credits(<parameters>)
{u'cast': [{u'character': u'Walter White',
            u'credit_id': u'52542282760ee313280017f9',
            u'id': 17419,
            u'name': u'Bryan Cranston',
            u'order': 0,
            u'profile_path': u'/vr3YaG9ehqQY82fsxOFZvlqncX7.jpg'},
           {u'character': u'Skyler White',
            u'credit_id': u'52542282760ee3132800181b',
            u'id': 134531,
            u'name': u'Anna Gunn',
            u'order': 1,
            u'profile_path': u'/lKlGjfmu9mJcF4upNrhtG3X9uyq.jpg'},
           {u'character': u'Jesse Pinkman',
            u'credit_id': u'52542282760ee31328001845',
            u'id': 84497,
            u'name': u'Aaron Paul',
            u'order': 2,
            u'profile_path': u'/oTceEUb6A9Bg6DeUTJBTETUOEAy.jpg'},
           {u'character': u'Hank Schrader',
            u'credit_id': u'52542283760ee3132800187b',
            u'id': 14329,
            u'name': u'Dean Norris',
            u'order': 3,
            u'profile_path': u'/500eNhWneDTXQuEXg6BR269IjHr.jpg'},
           {u'character': u'Marie Schrader',
            u'credit_id': u'52542283760ee31328001891',
            u'id': 1217934,
            u'name': u'Betsy Brandt',
            u'order': 4,
            u'profile_path': u'/zpmsca1HCVqYrtWXV9xdmsECDTI.jpg'},
           {u'character': u'Walter White Jr.',
            u'credit_id': u'52542284760ee313280018a9',
            u'id': 1223196,
            u'name': u'RJ Mitte',
            u'order': 5,
            u'profile_path': u'/hO5HJKM6p6SQjpdV8Fs64BJWzmT.jpg'}],
 u'crew': [{u'department': u'Production',
            u'id': 1223202,
            u'job': u'Producer',
            u'name': u'Diane Mercer',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 17419,
            u'job': u'Producer',
            u'name': u'Bryan Cranston',
            u'profile_path': u'/vr3YaG9ehqQY82fsxOFZvlqncX7.jpg'},
           {u'department': u'Production',
            u'id': 1223198,
            u'job': u'Producer',
            u'name': u'Moira Walley-Beckett',
            u'profile_path': None},
           {u'department': u'Writing',
            u'id': 24951,
            u'job': u'Writer',
            u'name': u'Peter Gould',
            u'profile_path': None},
           {u'department': u'Writing',
            u'id': 1223198,
            u'job': u'Writer',
            u'name': u'Moira Walley-Beckett',
            u'profile_path': None},
           {u'department': u'Writing',
            u'id': 103009,
            u'job': u'Writer',
            u'name': u'Thomas Schnauz',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 1218856,
            u'job': u'Producer',
            u'name': u'Patty Lin',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 29924,
            u'job': u'Producer',
            u'name': u'John Shiban',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 1223199,
            u'job': u'Producer',
            u'name': u'Melissa Bernstein',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 1223201,
            u'job': u'Producer',
            u'name': u'Karen Moore',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 24951,
            u'job': u'Producer',
            u'name': u'Peter Gould',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 1223193,
            u'job': u'Producer',
            u'name': u'George Mastras',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 103009,
            u'job': u'Producer',
            u'name': u'Thomas Schnauz',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 1223200,
            u'job': u'Producer',
            u'name': u'Stewart Lyons',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 1223194,
            u'job': u'Producer',
            u'name': u'Sam Catlin',
            u'profile_path': None},
           {u'department': u'Production',
            u'id': 66633,
            u'job': u'Executive Producer',
            u'name': u'Vince Gilligan',
            u'profile_path': u'/wSTvJGz7QbJf1HK2Mv1Cev6W9TV.jpg'},
           {u'department': u'Production',
            u'id': 5162,
            u'job': u'Executive Producer',
            u'name': u'Mark Johnson',
            u'profile_path': u'/yKGF6cbzyP03Gl1QhVLCu1gWSW6.jpg'},
           {u'department': u'Production',
            u'id': 29779,
            u'job': u'Executive Producer',
            u'name': u'Michelle MacLaren',
            u'profile_path': None}],
 u'id': 3572}
tv_season_episode(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • episode_number (int) –
  • season_number (int) –
  • id (int) –

Optional

Parameters:
  • append_to_response (str) – Comma separated, any tv series method
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season_episode(<parameters>)
{u'air_date': u'2008-01-20',
 u'episode_number': 1,
 u'id': 62085,
 u'name': u'Pilot',
 u'overview': u'When an unassuming high school chemistry teacher discovers he has a rare form of lung cancer, he decides to team up with a former student and create a top of the line crystal meth in a used RV, to provide for his family once he is gone.',
 u'production_code': None,
 u'season_number': 1,
 u'still_path': u'/2IksiG9RPQ4lxYxgiKEhns0N4Zx.jpg',
 u'vote_average': 0.0,
 u'vote_count': 0}
tv_season_episode_credits(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • episode_number (int) –
  • season_number (int) –
  • id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season_episode_credits(<parameters>)
{u'cast': [{u'character': u'Walter White',
            u'credit_id': u'52542282760ee313280017f9',
            u'id': 17419,
            u'name': u'Bryan Cranston',
            u'order': 0,
            u'profile_path': u'/vr3YaG9ehqQY82fsxOFZvlqncX7.jpg'},
           {u'character': u'Skyler White',
            u'credit_id': u'52542282760ee3132800181b',
            u'id': 134531,
            u'name': u'Anna Gunn',
            u'order': 1,
            u'profile_path': u'/lKlGjfmu9mJcF4upNrhtG3X9uyq.jpg'},
           {u'character': u'Jesse Pinkman',
            u'credit_id': u'52542282760ee31328001845',
            u'id': 84497,
            u'name': u'Aaron Paul',
            u'order': 2,
            u'profile_path': u'/oTceEUb6A9Bg6DeUTJBTETUOEAy.jpg'},
           {u'character': u'Hank Schrader',
            u'credit_id': u'52542283760ee3132800187b',
            u'id': 14329,
            u'name': u'Dean Norris',
            u'order': 3,
            u'profile_path': u'/500eNhWneDTXQuEXg6BR269IjHr.jpg'},
           {u'character': u'Marie Schrader',
            u'credit_id': u'52542283760ee31328001891',
            u'id': 1217934,
            u'name': u'Betsy Brandt',
            u'order': 4,
            u'profile_path': u'/zpmsca1HCVqYrtWXV9xdmsECDTI.jpg'},
           {u'character': u'Walter White Jr.',
            u'credit_id': u'52542284760ee313280018a9',
            u'id': 1223196,
            u'name': u'RJ Mitte',
            u'order': 5,
            u'profile_path': u'/hO5HJKM6p6SQjpdV8Fs64BJWzmT.jpg'}],
 u'crew': [{u'department': u'Writing',
            u'id': 66633,
            u'job': u'Writer',
            u'name': u'Vince Gilligan',
            u'profile_path': u'/wSTvJGz7QbJf1HK2Mv1Cev6W9TV.jpg'},
           {u'department': u'Directing',
            u'id': 66633,
            u'job': u'Director',
            u'name': u'Vince Gilligan',
            u'profile_path': u'/wSTvJGz7QbJf1HK2Mv1Cev6W9TV.jpg'}],
 u'guest_stars': [{u'character': u'Carmen Molina',
                   u'credit_id': u'52542273760ee31328000676',
                   u'id': 115688,
                   u'name': u'Carmen Serano',
                   u'order': 0,
                   u'profile_path': u'/gJOeg4jtRZR5xRBizYX2IibByVj.jpg'},
                  {u'character': u'Emilio Koyama',
                   u'credit_id': u'52542273760ee3132800068e',
                   u'id': 92495,
                   u'name': u'John Koyama',
                   u'order': 1,
                   u'profile_path': None},
                  {u'character': u"Chad's Girlfriend",
                   u'credit_id': u'52542275760ee313280006a2',
                   u'id': 1223192,
                   u'name': u'Roberta Marquez Seret',
                   u'order': 2,
                   u'profile_path': None},
                  {u'character': u'Jock',
                   u'credit_id': u'52542275760ee313280006b4',
                   u'id': 1216132,
                   u'name': u'Aaron Hill',
                   u'order': 3,
                   u'profile_path': u'/vTqz2FIutFJPG73j7gFDTWomTbb.jpg'},
                  {u'character': u'Krazy-8',
                   u'credit_id': u'52725845760ee3046b09426e',
                   u'id': 1046460,
                   u'name': u'Max Arciniega',
                   u'order': 31,
                   u'profile_path': u'/hRyw2cglnWU42vHZUag7b9dIf4u.jpg'},
                  {u'character': u'Bogdan Wolynetz',
                   u'credit_id': u'5272587a760ee3045009ddec',
                   u'id': 1223197,
                   u'name': u'Marius Stan',
                   u'order': 32,
                   u'profile_path': None},
                  {u'character': u'Dr. Belknap (as Greg Chase)',
                   u'credit_id': u'52725cb1760ee3044d0b9984',
                   u'id': 161591,
                   u'name': u'Gregory Chase',
                   u'order': 33,
                   u'profile_path': None},
                  {u'character': u'Steven Gomez',
                   u'credit_id': u'5271b489760ee35b3e0881a7',
                   u'id': 61535,
                   u'name': u'Steven Michael Quezada',
                   u'order': 34,
                   u'profile_path': None}],
 u'id': 62085}
tv_season_episode_external_ids(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • episode_number (int) –
  • season_number (int) –
  • id (int) –

Optional

Parameters:language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season_episode_external_ids(<parameters>)
{u'freebase_id': None,
 u'freebase_mid': u'/m/03mb620',
 u'id': 62085,
 u'imdb_id': u'tt0959621',
 u'tvdb_id': 349232,
 u'tvrage_id': 637041}
tv_season_episode_images(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • episode_number (int) –
  • season_number (int) –
  • id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season_episode_images(<parameters>)
{u'id': 62085,
 u'stills': [{u'aspect_ratio': 1.48,
              u'file_path': u'/2IksiG9RPQ4lxYxgiKEhns0N4Zx.jpg',
              u'height': 271.0,
              u'iso_639_1': None,
              u'vote_average': 0.0,
              u'vote_count': 0,
              u'width': 400.0}]}
tv_season_external_ids(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • season_number (int) –
  • id (int) –

Optional

Parameters:language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season_external_ids(<parameters>)
{u'freebase_id': u'/en/breaking_bad_season_1',
 u'freebase_mid': u'/m/05yy27m',
 u'id': 3572,
 u'tvdb_id': 30272,
 u'tvrage_id': None}
tv_season_images(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:
  • season_number (int) –
  • id (int) –

Optional

Parameters:
  • include_image_language (str) – Comma separated, a valid ISO 69-1.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_season_images(<parameters>)
{u'id': 3572,
 u'posters': [{u'aspect_ratio': 0.69,
               u'file_path': u'/6lP6ac4wNmWgtfVvrsl53bMqrKS.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/wr0pPDfwn4gNQxjNWpkazhN13tZ.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/zPrE7NvhW6kk9acm8yXjdgDcXZJ.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/8yHDd0EVpNpWk1VBa9QP4iUmw0v.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/zJV0m4IFtsmF2QsCk4Yrwv5frNn.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/z6eMdUp2mF2rsmOnZH2N0S9QGFY.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/tFnhmMscpXZxiceNOSC6ooxtn51.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/spPmYZAq2xLKQOEIdBPkhiRxrb9.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/ryreluyqCf6CxlEFbZSceVGw8NL.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/m8V6Fm2dV7tNvjCmBpROSU3Zrq4.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/oW0G4MKWcyNaRGckZf8WRFyO5cH.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/tkZ9bXm9iFNEdZmblSl8rxgpstT.jpg',
               u'height': 578.0,
               u'iso_639_1': None,
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/l5s5lfqpdP4uigrZtu5Sg8hfWqG.jpg',
               u'height': 578.0,
               u'iso_639_1': u'en',
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0},
              {u'aspect_ratio': 0.69,
               u'file_path': u'/2lhO5zd1nnf7PjC7dGCUo45Volz.jpg',
               u'height': 578.0,
               u'iso_639_1': u'en',
               u'vote_average': 0.0,
               u'vote_count': 0,
               u'width': 400.0}]}
tv_top_rated(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Optional

Parameters:
  • page (int) – Minimum 1, maximum 1000.
  • language (str) – ISO 639-1 code.
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_top_rated(<parameters>)
{u'page': 1,
 u'results': [{u'backdrop_path': u'/2APnNWNDQtcKgC8lXYwtJVAyNfi.jpg',
               u'first_air_date': u'2010-07-25',
               u'id': 19885,
               u'name': u'Sherlock',
               u'original_name': u'Sherlock',
               u'popularity': 5.447638885,
               u'poster_path': u'/aCt2etumGt5aAXCyMoZALqXhnqD.jpg',
               u'vote_average': 9.58333333333333,
               u'vote_count': 6},
              {u'backdrop_path': u'/j0QVEEo7j9lsKJueIlDGWKVSOhg.jpg',
               u'first_air_date': u'1999-01-10',
               u'id': 1398,
               u'name': u'The Sopranos',
               u'original_name': u'The Sopranos',
               u'popularity': 2.24655854635189,
               u'poster_path': u'/z8BBNlEjVDdtHPtPYVCxa9VFnQk.jpg',
               u'vote_average': 9.5,
               u'vote_count': 6},
              {u'backdrop_path': None,
               u'first_air_date': u'2005-03-26',
               u'id': 57243,
               u'name': u'Doctor Who',
               u'original_name': u'Doctor Who',
               u'popularity': 2.78326,
               u'poster_path': u'/4a94ptIdYz0JwSzo0dCNuPCcfM8.jpg',
               u'vote_average': 9.5,
               u'vote_count': 2},
              {u'backdrop_path': u'/gyjHOqa3UhJ6XcKhSSLAlZV38Dl.jpg',
               u'first_air_date': u'2011-04-17',
               u'id': 1399,
               u'name': u'Game of Thrones',
               u'original_name': u'Game of Thrones',
               u'popularity': 10.2458449125787,
               u'poster_path': u'/97p6ypjCkiqxNc1b44oO630IMmn.jpg',
               u'vote_average': 9.38888888888889,
               u'vote_count': 9},
              {u'backdrop_path': u'/8naafX2PPZ0J2YsxUMt7ODOsVpZ.jpg',
               u'first_air_date': u'1999-03-28',
               u'id': 615,
               u'name': u'Futurama',
               u'original_name': u'Futurama',
               u'popularity': 2.3089174515,
               u'poster_path': u'/9OGPL6RIxsm9tz5BPzi3mg726is.jpg',
               u'vote_average': 9.33333333333333,
               u'vote_count': 3},
              {u'backdrop_path': u'/RzFEhhjane7TK1USqZ5JJc4pKa.jpg',
               u'first_air_date': u'2006-02-03',
               u'id': 2490,
               u'name': u'The IT Crowd',
               u'original_name': u'The IT Crowd',
               u'popularity': 1.02,
               u'poster_path': u'/neEcKPGAIictrApAeD2wQvK4eeP.jpg',
               u'vote_average': 9.0,
               u'vote_count': 3},
              {u'backdrop_path': u'/6rJIYw5QMWGaP9gHZbYHfzQgOd9.jpg',
               u'first_air_date': u'2001-10-02',
               u'id': 4556,
               u'name': u'Scrubs',
               u'original_name': u'Scrubs',
               u'popularity': 2.5980394646,
               u'poster_path': u'/cCTErasMoYRWIrruLTDACVWk67H.jpg',
               u'vote_average': 9.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/rd6vbo08CU21CG6kQdZlz2Gpprk.jpg',
               u'first_air_date': u'2009-09-23',
               u'id': 1421,
               u'name': u'Modern Family',
               u'original_name': u'Modern Family',
               u'popularity': 3.27051044231692,
               u'poster_path': u'/zgwm6oVA91iRdipjzEj9IV1SS8X.jpg',
               u'vote_average': 9.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/s6j17VsUe66HXvo6PfgWxUlyeVg.jpg',
               u'first_air_date': u'2009-09-22',
               u'id': 1435,
               u'name': u'The Good Wife',
               u'original_name': u'The Good Wife',
               u'popularity': 1.4740158,
               u'poster_path': u'/ueresyKVXxEaEDgJXnpeADGHkC4.jpg',
               u'vote_average': 9.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/nRQb7ymvt0NJvRR2YaSwFWJdAW0.jpg',
               u'first_air_date': u'2011-06-23',
               u'id': 37680,
               u'name': u'Suits',
               u'original_name': u'Suits',
               u'popularity': 0.5108,
               u'poster_path': u'/9mRRbi2akSRqtwJx6EyCfo3gaky.jpg',
               u'vote_average': 9.0,
               u'vote_count': 2},
              {u'backdrop_path': u'/dRaV8HGx7Z9xmw77qSs8prp5OuI.jpg',
               u'first_air_date': u'2008-01-20',
               u'id': 1396,
               u'name': u'Breaking Bad',
               u'original_name': u'Breaking Bad',
               u'popularity': 8.45479759011426,
               u'poster_path': u'/j5k6ZTYqamPDZplCCXuokjJ2PoJ.jpg',
               u'vote_average': 8.875,
               u'vote_count': 12},
              {u'backdrop_path': u'/qm7w1YTkPyVXvxR6IizPVL9QkZA.jpg',
               u'first_air_date': u'1993-09-10',
               u'id': 4087,
               u'name': u'The X-Files',
               u'original_name': u'The X-Files',
               u'popularity': 2.60736183518339,
               u'poster_path': u'/9QLl0uPDJ676lob32hSpaboPIwn.jpg',
               u'vote_average': 8.875,
               u'vote_count': 4},
              {u'backdrop_path': u'/aUDXk7DNvbmsqPrJnLnG6MVi9Bv.jpg',
               u'first_air_date': u'2004-09-22',
               u'id': 1432,
               u'name': u'Veronica Mars',
               u'original_name': u'Veronica Mars',
               u'popularity': 1.939828166,
               u'poster_path': u'/ewG884trMtmm8FrEAxOKVQDd8cD.jpg',
               u'vote_average': 8.875,
               u'vote_count': 4},
              {u'backdrop_path': u'/kx83c2RmyYi9XGtPoYqFXAEDtK3.jpg',
               u'first_air_date': u'2002-09-20',
               u'id': 1437,
               u'name': u'Firefly',
               u'original_name': u'Firefly',
               u'popularity': 1.544779565,
               u'poster_path': u'/jFykyPcd92ecGJwwiqhssoS6MTO.jpg',
               u'vote_average': 8.875,
               u'vote_count': 4},
              {u'backdrop_path': u'/9quXduCcoWcUtcnMOKZb9J77Gev.jpg',
               u'first_air_date': u'2009-09-17',
               u'id': 18347,
               u'name': u'Community',
               u'original_name': u'Community',
               u'popularity': 1.757958,
               u'poster_path': u'/4mW6xxN8pHtfECWGNHQQmoP34J.jpg',
               u'vote_average': 8.875,
               u'vote_count': 4},
              {u'backdrop_path': u'/rABRffXmTOICewnkODvuqrNt5FK.jpg',
               u'first_air_date': u'1997-08-13',
               u'id': 2190,
               u'name': u'South Park',
               u'original_name': u'South Park',
               u'popularity': 4.0649270393075,
               u'poster_path': u'/hIn4ujzVk8iWZhz3JI6LHIX2CY8.jpg',
               u'vote_average': 8.83333333333333,
               u'vote_count': 3},
              {u'backdrop_path': u'/aibLX9jyoA0C9kVWWKwMaMgdO9h.jpg',
               u'first_air_date': u'2013-04-04',
               u'id': 40008,
               u'name': u'Hannibal',
               u'original_name': u'Hannibal',
               u'popularity': 0.84,
               u'poster_path': u'/meAZ5lyjVLIU2p4oFCHVS8GjYOC.jpg',
               u'vote_average': 8.75,
               u'vote_count': 2},
              {u'backdrop_path': u'/t5OyPBZuKbS3gcjWj7vm7xQICNv.jpg',
               u'first_air_date': u'1994-09-22',
               u'id': 1668,
               u'name': u'Friends',
               u'original_name': u'Friends',
               u'popularity': 4.93897743596318,
               u'poster_path': u'/oQR7HXiCWpWvmUN1wo3asxrkAeZ.jpg',
               u'vote_average': 8.66666666666667,
               u'vote_count': 3},
              {u'backdrop_path': u'/kgadTwNJYYGZ7LTrw9X7KDiRCfV.jpg',
               u'first_air_date': u'2006-10-01',
               u'id': 1405,
               u'name': u'Dexter',
               u'original_name': u'Dexter',
               u'popularity': 6.30021577329623,
               u'poster_path': u'/eIoAzf9czDSWqYneE1fZTQ3iJhB.jpg',
               u'vote_average': 8.64285714285714,
               u'vote_count': 7},
              {u'backdrop_path': u'/uU9SpM6hpsxUHC7xWEFmUVz2HfC.jpg',
               u'first_air_date': u'2003-01-23',
               u'id': 1428,
               u'name': u'MythBusters',
               u'original_name': u'MythBusters',
               u'popularity': 0.2,
               u'poster_path': u'/pcBNVuM6NyqZ9NY5VzP06YS4CkU.jpg',
               u'vote_average': 8.5,
               u'vote_count': 2}],
 u'total_pages': 3,
 u'total_results': 48}
tv_translations(api, *positional, **params)

For more information on return value see official API docs

For information about possible exceptions see tmdb.errors documentation.

Required

Parameters:id (int) –
Usage:
>>> api = tmdb.API(api_key)
>>> api.tv_translations(<parameters>)
{u'id': 1396,
 u'translations': [{u'english_name': u'English',
                    u'iso_639_1': u'en',
                    u'name': u'English'},
                   {u'english_name': u'Dutch',
                    u'iso_639_1': u'nl',
                    u'name': u'Nederlands'},
                   {u'english_name': u'Turkish',
                    u'iso_639_1': u'tr',
                    u'name': u'T\xfcrk\xe7e'},
                   {u'english_name': u'Slovak',
                    u'iso_639_1': u'sk',
                    u'name': u'Sloven\u0161\u010dina'},
                   {u'english_name': u'German',
                    u'iso_639_1': u'de',
                    u'name': u'Deutsch'},
                   {u'english_name': u'Russian',
                    u'iso_639_1': u'ru',
                    u'name': u'P\u0443\u0441\u0441\u043a\u0438\u0439'},
                   {u'english_name': u'French',
                    u'iso_639_1': u'fr',
                    u'name': u'Fran\xe7ais'},
                   {u'english_name': u'Hungarian',
                    u'iso_639_1': u'hu',
                    u'name': u'Magyar'},
                   {u'english_name': u'Mandarin',
                    u'iso_639_1': u'zh',
                    u'name': u'\u4e2d\u56fd'}]}