Skip to main content

tvdb_api_client: an unofficial API for the TVDB

build lint tests license codecov readthedocs pypi downloads build automation: yam Lint: ruff

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

Metadata

Release files for tvdb_api_client 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tvdb_api_client 0.8.0
File Size Uploaded
tvdb_api_client-0.8.0.tar.gz 6.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tvdb_api_client 0.8.0
File Interpreter ABI Platform
tvdb_api_client-0.8.0-py3-none-any.whl Python 3 none any Details

Total release size: 14.1 kB

Release files / tvdb_api_client-0.8.0.tar.gz

Download URL tvdb_api_client-0.8.0.tar.gz
Size 6.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a98f7a68786cba4fced77b03605903f82a56f5feb5c18396b4e506a1cb27e8ab
BLAKE2b-256 checksum
How to use checksums
2306804bf1385a48f209a4e98ec25a5fe941e906f7e261373c1779260f1febd6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / tvdb_api_client-0.8.0-py3-none-any.whl

Download URL tvdb_api_client-0.8.0-py3-none-any.whl
Size 7.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6f7678f4d87a5fe21306d8b64e3e461230aabf094ba34cd80703c60ff3a69a1e
BLAKE2b-256 checksum
How to use checksums
874984457fa9511e415ce319371cfd1cca9b8024b85308829a2e21edb07815a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.8.0 This release

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.0

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page