Skip to content
phate89 edited this page Jan 16, 2017 · 9 revisions

tvdbsimple is a wrapper, written in Python, for TheTVDb.com API v2. By calling the functions available in tvdbsimple you can simplify your code and easily access a vast amount of tv and cast data. To find out more about TheTVDb API, check out the official api page

Features

  • Full API implementation. Supports Search, Series, Episode, Updated, User and Languages methods.
  • Updated with the latest JSON API.
  • Supports Python 2.7 (3.x python support will come).
  • Easy to access data using Python class attributes.
  • Easy to experiment with tvdbsimple functions inside the Python interpreter.

Installation

tvdbsimple is available on the Python Package Index.

You can install tvdbsimple using one of the following techniques:

  • Use pip: pip install tvdbsimple
  • Download the .zip or .tar.gz file from PyPI and install it yourself
  • Download the source from Github and install it yourself

If you install it yourself, also install requests.

API Key

You will need an API key to TheTVDb to access the API. To obtain a key, follow these steps:

  1. Register for and verify an account.
  2. Log into your account.
  3. Go to this page and fill your details to generate a new API key.

Examples

All the functions are fully documented here but you can find several use examples in the examples page.

License

The module is distributed with a GPLv3 license, see LICENSE for more details

copyright (c) 2017 by phate89.