{"id":21846121,"url":"https://github.com/owenvoke/yts","last_synced_at":"2025-06-17T11:07:45.291Z","repository":{"id":51746826,"uuid":"110670135","full_name":"owenvoke/yts","owner":"owenvoke","description":"A full wrapper for the YTS API.","archived":false,"fork":false,"pushed_at":"2021-07-13T11:11:46.000Z","size":88,"stargazers_count":3,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-17T11:07:15.903Z","etag":null,"topics":["php","torrents","yify-torrents","yts","yts-api"],"latest_commit_sha":null,"homepage":"https://packagist.org/packages/owenvoke/yts","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/owenvoke.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"owenvoke","custom":"https://ecologi.com/owenvoke?gift-trees"}},"created_at":"2017-11-14T09:35:59.000Z","updated_at":"2023-10-04T21:51:22.000Z","dependencies_parsed_at":"2022-08-23T20:50:43.086Z","dependency_job_id":null,"html_url":"https://github.com/owenvoke/yts","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/owenvoke/yts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenvoke%2Fyts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenvoke%2Fyts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenvoke%2Fyts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenvoke%2Fyts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/owenvoke","download_url":"https://codeload.github.com/owenvoke/yts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenvoke%2Fyts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260346859,"owners_count":22995149,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["php","torrents","yify-torrents","yts","yts-api"],"created_at":"2024-11-27T23:12:56.647Z","updated_at":"2025-06-17T11:07:40.256Z","avatar_url":"https://github.com/owenvoke.png","language":"PHP","funding_links":["https://github.com/sponsors/owenvoke","https://ecologi.com/owenvoke?gift-trees"],"categories":[],"sub_categories":[],"readme":"# YTS\n\n[![Latest Version on Packagist][ico-version]][link-packagist]\n[![Software License][ico-license]](LICENSE.md)\n[![Build Status][ico-github-actions]][link-github-actions]\n[![Style CI][ico-styleci]][link-styleci]\n[![Total Downloads][ico-downloads]][link-downloads]\n[![Buy us a tree][ico-treeware-gifting]][link-treeware-gifting]\n\nA full wrapper for the YTS API.\n\n## About YTS\n\nYIFY 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.\n\n## Install\n\nVia Composer\n\n```shell\n$ composer require owenvoke/yts\n```\n\n## Usage\n\n#### List Movies\n\nReturns a Collection instance containing Movie instances.\n\n```php\nMovies::list([\n    'quality'         =\u003e Movies::QUALITY_ALL, // A quality constant\n    'query_term'      =\u003e 0,                   // A query string, or 0 to ignore\n    'page'            =\u003e 1,                   // An integer page number\n    'minimum_rating'  =\u003e 0,                   // The minimum movie rating\n    'genre'           =\u003e '',                  // A string containing the genre\n    'sort_by'         =\u003e 'date-added',        // The sort-by order\n    'order_by'        =\u003e 'desc',              // The direction to order by\n    'with_rt_ratings' =\u003e false,               // Returns the list with Rotten Tomatoes ratings\n]);\n```\n\n#### Movie Details\n\nReturns a Movie instance.\n\n```php\nMovies::details([\n    'movie_id'    =\u003e null,  // The ID of the movie to retrieve\n    'with_images' =\u003e false, // Return with image URLs\n    'with_cast'   =\u003e false, // Return with information about the cast\n]);\n```\n\n#### Movie Suggestions\n\nReturns a Collection instance containing 0 to 4 Movie instances.\n\n```php\nMovies::suggestions([\n    'movie_id' =\u003e null, // The ID of the movie to retrieve suggestions for\n]);\n```\n\n## Change log\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.\n\n## Testing\n\n```shell\n$ composer test\n```\n\n## Contributing\n\nPlease see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.\n\n## Security\n\nIf you discover any security related issues, please email security@voke.dev instead of using the issue tracker.\n\n## Credits\n\n- [Owen Voke][link-author]\n- [All Contributors][link-contributors]\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n\n## Treeware\n\nYou're free to use this package, but if it makes it to your production environment you are required to buy the world a tree.\n\nIt’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.\n\nYou can buy trees [here][link-treeware-gifting].\n\nRead more about Treeware at [treeware.earth][link-treeware].\n\n[ico-version]: https://img.shields.io/packagist/v/owenvoke/yts.svg?style=flat-square\n[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square\n[ico-github-actions]: https://img.shields.io/github/workflow/status/owenvoke/yts/Tests.svg?style=flat-square\n[ico-styleci]: https://styleci.io/repos/110670135/shield\n[ico-downloads]: https://img.shields.io/packagist/dt/owenvoke/yts.svg?style=flat-square\n[ico-treeware-gifting]: https://img.shields.io/badge/Treeware-%F0%9F%8C%B3-lightgreen?style=flat-square\n\n[link-packagist]: https://packagist.org/packages/owenvoke/yts\n[link-github-actions]: https://github.com/owenvoke/yts/actions\n[link-styleci]: https://styleci.io/repos/110670135\n[link-downloads]: https://packagist.org/packages/owenvoke/yts\n[link-treeware]: https://treeware.earth\n[link-treeware-gifting]: https://ecologi.com/owenvoke?gift-trees\n[link-author]: https://github.com/owenvoke\n[link-contributors]: ../../contributors\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowenvoke%2Fyts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fowenvoke%2Fyts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowenvoke%2Fyts/lists"}