|
🎬
List Movies
Search, sort & filter all movies
|
📋
Movie Details
Full info for a specific movie
|
💡
Movie Suggestions
4 related movie suggestions
|
🛡️
Parental Guides
Content ratings per movie
|
🎬 List Movies
https://yts.bz/api/v2/list_movies.jsonhttps://yts.bz/api/v2/list_movies.jsonphttps://yts.bz/api/v2/list_movies.xmlUsed to list and search through all available movies. Can sort, filter, search and order the results.
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
limit |
optional | Integer 1–50 | 20 |
The limit of results per page |
page |
optional | Integer (Unsigned) | 1 |
Paginate results — e.g. limit=15&page=2 shows movies 15–30 |
quality |
optional |
480p720p1080p1080p.x2652160p3D
|
All | Filter by a given quality |
minimum_rating |
optional | Integer 0–9 | 0 |
Filter by a given minimum IMDb rating |
query_term |
optional | String | 0 |
Movie search — matches on: Movie Title / IMDb Code, Actor Name / IMDb Code, Director Name / IMDb Code |
genre |
optional | String | All | Filter by a given genre — see imdb.com/genre for full list |
sort_by |
optional |
titleyearratingpeersseedsdownload_countlike_countdate_added
|
date_added |
Sort results by chosen value |
order_by |
optional |
descasc
|
desc |
Order results ascending or descending |
with_rt_ratings |
optional | Boolean | false |
Include Rotten Tomatoes rating in results |
| Key Name | Description | Example |
|---|---|---|
movie_count |
Total movie count results for your query | 2131 |
limit |
The limit of results per page that has been set | 20 |
page_number |
The current page number you are viewing | 1 |
movies |
An array holding multiple movies and their relative information | ARRAY |
magnet:?xt=urn:btih:TORRENT_HASH&dn=Url+Encoded+Movie+Name&tr=https://tracker.one:1234/announce&tr=udp://tracker.two:80
udp://tracker.opentrackr.org:1337/announce |
udp://tracker.torrent.eu.org:451/announce |
udp://tracker.dler.org:6969/announce |
udp://open.stealth.si:80/announce |
udp://open.demonii.com:1337/announce |
https://tracker.moeblog.cn:443/announce |
udp://open.dstud.io:6969/announce |
udp://tracker.srv00.com:6969/announce |
https://tracker.zhuqiy.com:443/announce |
https://tracker.pmman.tech:443/announce |
📋 Movie Details
https://yts.bz/api/v2/movie_details.jsonhttps://yts.bz/api/v2/movie_details.jsonphttps://yts.bz/api/v2/movie_details.xmlReturns the information about a specific movie.
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
movie_id or imdb_id |
optional | Integer (Unsigned) | null |
The YTS ID of the movie or the IMDB ID |
with_images |
optional | Boolean | false |
When set, the data returned will include added image URLs |
with_cast |
optional | Boolean | false |
When set, the data returned will include information about the cast |
magnet:?xt=urn:btih:TORRENT_HASH&dn=Url+Encoded+Movie+Name&tr=http://track.one:1234/announce&tr=udp://track.two:80
udp://glotorrents.pw:6969/announce |
udp://tracker.opentrackr.org:1337/announce |
udp://torrent.gresille.org:80/announce |
udp://tracker.openbittorrent.com:80 |
udp://tracker.coppersurfer.tk:6969 |
udp://tracker.leechers-paradise.org:6969 |
udp://p4p.arenabg.ch:1337 |
udp://tracker.internetwarriors.net:1337 |
💡 Movie Suggestions
https://yts.bz/api/v2/movie_suggestions.jsonhttps://yts.bz/api/v2/movie_suggestions.jsonphttps://yts.bz/api/v2/movie_suggestions.xmlReturns 4 related movies as suggestions for the user.
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
movie_id |
optional | Integer (Unsigned) | null |
The ID of the movie |
https://yts.bz/api/v2/movie_suggestions.json?movie_id=10
Returns 4 related movies to the movie with ID of 10
🛡️ Movie Parental Guides
https://yts.bz/api/v2/movie_parental_guides.jsonhttps://yts.bz/api/v2/movie_parental_guides.jsonphttps://yts.bz/api/v2/movie_parental_guides.xmlReturns all the parental guide ratings for the specified movie.
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
movie_id |
optional | Integer (Unsigned) | null |
The ID of the movie |
https://yts.bz/api/v2/movie_parental_guides.json?movie_id=10
Returns the parental guides for the movie with the ID of 10


