tvdb_api_client: an unofficial API for the TVDB

tvdb_api_client is an unofficial API for the TVDB.

In a nutshell

Installation

uv is an extremely fast Python package installer. You can use it to install tvdb_api_client and try it out:

$ uv pip install tvdb_api_client

Usage

Initialise the client and fetch data:

from tvdb_api_client import TheTVDBClient

client = TheTVDBClient(api_key="your-api-key")

# Get a TV series by its TVDB id
series = client.get_series_by_id(81189)  # Breaking Bad

# Get all episodes for a TV series
episodes = client.get_episodes_by_series(81189)

Once the client has been initialised, you can use it to:

• get a TV series by its TVDB id
• get all episodes for a TV series by its TVDB id
• access raw API responses for custom processing

Links

• Documentation
• Changelog