PHPackages                             owenvoke/yts - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. owenvoke/yts

ActiveLibrary[API Development](/categories/api)

owenvoke/yts
============

A full wrapper for the YTS API.

v2.0.1(5y ago)273[2 issues](https://github.com/owenvoke/yts/issues)MITPHPPHP ^7.3|^8.0

Since May 10Pushed 5y ago1 watchersCompare

[ Source](https://github.com/owenvoke/yts)[ Packagist](https://packagist.org/packages/owenvoke/yts)[ Fund](https://ecologi.com/owenvoke?gift-trees)[ GitHub Sponsors](https://github.com/owenvoke)[ RSS](/packages/owenvoke-yts/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (5)Versions (3)Used By (0)

YTS
===

[](#yts)

[![Latest Version on Packagist](https://camo.githubusercontent.com/387f55ed50ebba166b063c21f394c34982506ca951eb6096cb233e27e2ae1506/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f77656e766f6b652f7974732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/owenvoke/yts)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/b2b72bad826f1a9756dd70d7e8f48cdeac3c52200331e83143e69c6b6ae01097/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6f77656e766f6b652f7974732f54657374732e7376673f7374796c653d666c61742d737175617265)](https://github.com/owenvoke/yts/actions)[![Style CI](https://camo.githubusercontent.com/be90d218e91ce9421637bb47be6b519e79478c662af2993066b8d103c4d1728d/68747470733a2f2f7374796c6563692e696f2f7265706f732f3131303637303133352f736869656c64)](https://styleci.io/repos/110670135)[![Total Downloads](https://camo.githubusercontent.com/9c5263e58d9121a37cdd9e7312e05c7464efef96ecf776d6c5f5b89bc77ea074/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f77656e766f6b652f7974732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/owenvoke/yts)[![Buy us a tree](https://camo.githubusercontent.com/910e097fe46a40add8f3484705ecbc26dc047df84b2fef027405f47408023d76/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54726565776172652d2546302539462538432542332d6c69676874677265656e3f7374796c653d666c61742d737175617265)](https://ecologi.com/owenvoke?gift-trees)

A full wrapper for the YTS API.

About YTS
---------

[](#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.

Install
-------

[](#install)

Via Composer

```
$ composer require owenvoke/yts
```

Usage
-----

[](#usage)

#### List Movies

[](#list-movies)

Returns a Collection instance containing Movie instances.

```
Movies::list([
    '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

[](#movie-details)

Returns a Movie instance.

```
Movies::details([
    '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

[](#movie-suggestions)

Returns a Collection instance containing 0 to 4 Movie instances.

```
Movies::suggestions([
    'movie_id' => null, // The ID of the movie to retrieve suggestions for
]);
```

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security
--------

[](#security)

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

Credits
-------

[](#credits)

- [Owen Voke](https://github.com/owenvoke)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Treeware
--------

[](#treeware)

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](https://ecologi.com/owenvoke?gift-trees).

Read more about Treeware at [treeware.earth](https://treeware.earth).

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

1925d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1899334?v=4)[Owen Voke](/maintainers/owenvoke)[@owenvoke](https://github.com/owenvoke)

---

Top Contributors

[![owenvoke](https://avatars.githubusercontent.com/u/1899334?v=4)](https://github.com/owenvoke "owenvoke (97 commits)")[![thevoidmain](https://avatars.githubusercontent.com/u/20501002?v=4)](https://github.com/thevoidmain "thevoidmain (1 commits)")

---

Tags

phptorrentsyify-torrentsytsyts-api

###  Code Quality

TestsPest

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/owenvoke-yts/health.svg)

```
[![Health](https://phpackages.com/badges/owenvoke-yts/health.svg)](https://phpackages.com/packages/owenvoke-yts)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.7M3.4k](/packages/craftcms-cms)[illuminate/http

The Illuminate Http package.

11938.5M8.2k](/packages/illuminate-http)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[files.com/files-php-sdk

Files.com PHP SDK

2482.9k](/packages/filescom-files-php-sdk)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

265.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
