Metadata-Version: 2.0
Name: tmdbv3api
Version: 0.4
Summary: A simple wrapper for the TMDb API.
Home-page: https://github.com/AnthonyBloomer/tmdbv3api
Author: Anthony Bloomer
Author-email: ant0@protonmail.ch
License: MIT
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: requests

tmdbv3api
=========

Python wrapper for The Movie Database (TMDb) API.

To use this wrapper you will need to get an API key from TMDb.

| Register an account:
| https://www.themoviedb.org/account/signup

| Check out the API documentation:
| https://docs.themoviedb.apiary.io

Install
~~~~~~~

::

    pip install tmdbv3api

Examples
~~~~~~~~

Get the list of popular movies on The Movie Database. This list
refreshes every day.

.. code:: python


    from tmdbv3api import TMDb
    tmdb = TMDb(api_key="your_api_key", debug=False, lang="en")

    popular = tmdb.popular()

    for movie in popular:
        print movie.id
        print movie.title
        print movie.overview
        print movie.poster_path


Get the primary information about a movie.

.. code:: python

    movie = tmdb.get_movie(343611)
    print movie.title
    print movie.overview
    print movie.popularity

Search for movies by title.

.. code:: python

    search = tmdb.search('Mad Max')

    for movie in search:
        print movie.id
        print movie.title
        print movie.overview
        print movie.poster_path
        print movie.vote_average

Get the similar movies for a specific movie id.

.. code:: python

    similar = tmdb.similar(777)

    for result in similar:
        print result.title
        print result.overview

Search for TV shows by title.

.. code:: python

    show = tmdb.search_tv('Breaking Bad')

    for result in show:
        print result.name
        print result.overview

Get the similar TV shows for a specific tv id.

.. code:: python

    similar = tmdb.similar_shows(1396)

    for show in similar:
        print show.name
        print show.overview

Get the general person information for a specific id.

.. code:: python

    person = tmdb.get_person(12)

    print person.name
    print person.biography

Discover movies by different types of data like average rating, number
of votes, genres and certifications.

.. code:: python


    # What movies are in theatres?

    movie = tmdb.discover_movies({
        'primary_release_date.gte': '2017-01-20',
        'primary_release_date.lte': '2017-01-25'
    })

    # What are the most popular movies?

    movie = tmdb.discover_movies({
        'sort_by': 'popularity.desc'
    })

    # What are the most popular kids movies?

    movie = tmdb.discover_movies({
        'certification_country': 'US',
        'certification.lte': 'G',
        'sort_by': 'popularity.desc'
    })

Discover TV shows by different types of data like average rating, number
of votes, genres, the network they aired on and air dates.

.. code:: python

    # What are the most popular TV shows?

    show = tmdb.discover_tv_shows({
        'sort_by': 'popularity.desc'
    })

    # What are the best dramas?

    show = tmdb.discover_tv_shows({
        'with_genres': 18,
        'sort_by': 'vote_average.desc',
        'vote_count.gte': 10
    })

Supported Methods
~~~~~~~~~~~~~~~~~

Movies
^^^^^^

-  **/movie/latest**
-  **/movie/now\_playing**
-  **/movie/top\_rated**
-  **/movie/upcoming**
-  **/movie/id**
-  **/movie/id/similar**
-  **/movie/id/recommendations**
-  **/movie/id/videos**
-  **/movie/id/reviews**
-  **/movie/id/lists**

TV
^^

-  **/tv/id**
-  **/tv/latest**
-  **/tv/id/similar**
-  **/tv/top\_rated**
-  **/tv/popular**


