A full wrapper for the YTS API.

v2.0.1 2021-05-10 09:53 UTC

This package is auto-updated.

Last update: 2024-05-13 17:32:18 UTC


Latest Version on Packagist Software License Build Status Style CI Total Downloads Buy us a tree

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 owenvoke/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 for details.


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



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


You're free to use this package, but if it makes it to your production environment you are required to buy the world a tree.

It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to plant trees. If you support this package and contribute to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

You can buy trees here.

Read more about Treeware at treeware.earth.