Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!


Project Description

Simple wrapper for API v2.


ytspy is available on PyPI.

$ pip install ytspy


import ytspy

# Data Format: json, xml or jsonp
yts = ytspy.YTS('json')

# list movies
# Used to list and search through out all the available movies.
# Can sort, filter, search and order the results
list =, limit=None, quality=None,
                minimum_rating=None, genre=None, sort_by=None,
                order_by=None, query_term=None, with_rt_ratings=Non)

# movie details
# Returns the information about a specific movie
movie =, with_images=False, with_cast=False)

# movie suggestions
# Returns 4 related movies as suggestions for the user
suggestions =

# movie comments
# Returns all the comments for the movie with ID of 10
comments =

# movie reviews
# Returns all the IMDb movie reviews for the specified movie
reviews =

# movie parental guides
# Returns all the parental guide ratings for the specified movie
parental_guides =

# list upcoming
# Returns the 4 latest upcoming movies
list_upcoming =

YTS Endpoint Parameters

QUALITY = ['ALL', '720p', '1080p', '3D']


SORT = [
    'title', 'year', 'rating', 'peers', 'seeds',
    'download_count', 'like_count', 'date_added'

    'json', 'xml', 'jsonp'

URI = [
    'movie_details', 'list_movies', 'movie_suggestions',
    'movie_comments', 'movie_reviews', 'movie_parental_guides',

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(1.8 kB) Copy SHA256 Hash SHA256
Source Sep 9, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting