tvdb-v4-python

This is the official tvdb api v4 python package

Instalation

python3 -m pip install tvdb_v4_official

Getting Started

some projects require a user supplied pin as well as an apikey

import tvdb_v4_official

tvdb = tvdb_v4_official.TVDB("APIKEY")
# OR:
# tvdb = tvdb_v4_official.TVDB("APIKEY", pin="YOUR PIN HERE")

# fetching several pages of series info
series_list = [ ]
for j in range(5): # Pages are numbered from 0
    series_list += tvdb.get_all_series(j)

# fetching a series
series = tvdb.get_series(121361)

# fetching a season's episode list
series = tvdb.get_series_extended(121361)
for season in sorted(series["seasons"], key=lambda x: (x["type"]["name"], x["number"])):
    if season["type"]["name"] == "Aired Order" and season["number"] == 1:
	    season = tvdb.get_season_extended(season["id"])
	    break
else:
    season = None
if season is not None:
    print(season["episodes"])

# fetch a page of episodes from a series by season_type (type is "default" if unspecified)
info = tvdb.get_series_episodes(121361, page=0)
print(info["series"])
for ep in info["episodes"]:
    print(ep)

# fetching a movie
movie = tvdb.get_movie(31) # avengers

# access a movie's characters
movie = tvdb.get_movie_extended(31)
for c in movie["characters"]:
    print(c)

# fetching a person record
person = tvdb.get_person_extended(characters[0]["peopleId"])