This package is abandoned and no longer maintained. The author suggests using the owenvoke/yts package instead.

A full wrapper for the YTS API.

v1.2.0 2019-03-08 12:28 UTC

This package is auto-updated.

Last update: 2021-05-07 08:54:41 UTC


Latest Version on Packagist Software License Build Status Style CI Code Coverage Total Downloads

This project has been renamed, see owenvoke/yts.

A full wrapper for the YTS API.

About YTS

YIFY Torrents or YTS is a peer-to-peer release group known for distributing large numbers of movies as free downloads through BitTorrent. YIFY releases were characterised through their HD video quality in a small file size, which attracted many downloaders.


Via Composer

$ composer require pxgamer/yts


List Movies

Returns a Collection instance containing Movie instances.

    'quality'         => Movies::QUALITY_ALL, // A quality constant
    'query_term'      => 0,                   // A query string, or 0 to ignore
    'page'            => 1,                   // An integer page number
    'minimum_rating'  => 0,                   // The minimum movie rating
    'genre'           => '',                  // A string containing the genre
    'sort_by'         => 'date-added',        // The sort-by order
    'order_by'        => 'desc',              // The direction to order by
    'with_rt_ratings' => false,               // Returns the list with Rotten Tomatoes ratings

Movie Details

Returns a Movie instance.

    'movie_id'    => null,  // The ID of the movie to retrieve
    'with_images' => false, // Return with image URLs
    'with_cast'   => false, // Return with information about the cast

Movie Suggestions

Returns a Collection instance containing 0 to 4 Movie instances.

    'movie_id' => null, // The ID of the movie to retrieve suggestions for

Change log

Please see CHANGELOG for more information on what has changed recently.


$ composer test


Please see CONTRIBUTING and CODE_OF_CONDUCT for details.


If you discover any security related issues, please email security@pxgamer.xyz instead of using the issue tracker.



The MIT License (MIT). Please see License File for more information.