Skip to content

spapanik/tvdb_api_client

tvdb_api_client: an unofficial API for the TVDB

build lint tests license pypi downloads code style: black build automation: yam Lint: ruff

tvdb_api_client is an unofficial API for the TVDB.

In a nutshell

Installation

The easiest way is to use poetry to manage your dependencies and add tvdb_api_client to them.

[tool.poetry.dependencies]
tvdb_api_client = "*"

Usage

Initialise the client (example using the django cache):

from django.core.cache import cache
from tvdb_api_client import TVDBClient

client = TVDBClient("username", "user_key", "api_key", cache)

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

  • get TV series by TVDB id
  • get TV series by IMDb id
  • find identifying info for a TV series by its name
  • get episodes by TV series using its TVDB id

Links