A library that provides a Python interface to the TvMaze API.

The easiest way to install the latest version is by using pip/easy_install to pull it from PyPI:

pip install python-tvmaze

You may also use Git to clone the repository from Github and install it manually:

git clone https://github.com/yakupadakli/python-tvmaze.git
cd python-tvmaze
python setup.py install

Python 3.8, 3.9 and 3.11 is supported for now.

from tvmaze.api import Api
api = Api()

A list of all shows, with all primary information included.

api.show.list()  # default page is 0
api.show.list(page=1)

Retrieve all primary information for a given show.

api.show.get(1)

A complete list of episodes for the given show.

api.show.episodes(1)

Retrieve one specific episode from this show given its season number and episode number.

api.show.episode_by_number(1)

Retrieve one specific episode from this show given its season number and episode number.

api.show.episode_by_number(1, season=1, number=1)

Retrieve all episodes from this show that have aired on a specific date.

api.show.episodes_by_date(1, "2013-07-01")

A complete list of seasons for the given show.

api.show.seasons(1)

A list of main cast for a show.

api.show.cast(1)

A list of main crew for a show.

api.show.crew(1)

A list of AKA's (aliases) for a show. An AKA with its country set to null indicates an AKA in the show's original country.

api.show.akas(1)

Retrieve all primary information for a given person.

api.people.get(1)

Retrieve all (show-level) cast credits for a person.

api.people.cast_credits(1)

Retrieve all (show-level) crew credits for a person.

api.people.crew_credits(100)

The schedule is a complete list of episodes that air today.

api.schedule.today()

The schedule is a complete list of episodes that air in a given country on a given date.

api.schedule.filter(country_code="US", date="2014-12-01")

The full schedule is a list of all future episodes known to TVmaze, regardless of their country.

api.schedule.full()

Search through all the shows by the show's name.

api.search.shows("girls")

Search through all the shows by the show's name and the single search endpoint which either returns exactly one result, or no result at all.

api.search.single_show("girls")

If you already know a show's tvrage, thetvdb or IMDB ID, you can use this endpoint to find this exact show on TVmaze

api.search.lookup_show("tvrage", "24493")
api.search.lookup_show("thetvdb", "81189")
api.search.lookup_show("imdb", "tt0944947")

Search through all the people by the name.

api.search.people("lauren")

Retrieve all primary information for a given character.

api.character.get(1)

Retrieve all primary information for a given episode.

api.episode.get(1)

Retrieve all primary information for a given network.

api.network.get(1)

Retrieve all primary information for a given web channel.

api.web_channel.get(1)