API Documentation

This is a lightweight web service, (REST interface), which provides an easy way to access the YTS website.
An API (Application programming interface) is a protocol intended to be used as an interface by software components to communicate with each other.
Our API supports many methods, so there should not be a problem coding some nice applications.

If you find any bug, or have any questions, or any suggestions please get in touch with us
Contact Us

Our API is beta at the moment, we stil work on it to add more options.

API Endpoints

All the API endpoints return the same data structure as below

Returned Key Description Example
status The returned status for the API call, can be either 'ok' or 'error' ok
status_message Either the error message or the successful message Query was successful
data If 'status' is returned as 'ok' the API query results will be inside 'data' data

List Movies

HTTP GET

Endpoint Description
https://yts.ac/api/v2/list_movies.json
https://yts.ac/api/v2/list_movies.jsonp
Used to list and search through out all the available movies. Can sort, filter, search and order the results

Endpoint Parameters

Parameter Required Type Default Description
limit Integer between 1 - 50 (inclusive) 20 The limit of results per page that has been set
page_num Integer (Unsigned) 1 Used to see the next page of movies, eg limit=15 and page_num=2 will show you movies 15-30
quality String (720p, 1080p, 3d) All Used to filter by a given quality
minimum_rating Integer between 0 - 9 (inclusive) 0 Used to filter movie by a given minimum IMDb rating
query_term String 0 Used for movie search, matching on: Movie Title
genre String All Used to filter by a given genre (See http://www.imdb.com/genre/ for full list)
sort_by String (title, year, rating, download_count, like_count, date_added) date_added Sorts the results by choosen value
order_by String (DESC, ASC) DESC Orders the results by either Ascending or Descending order

Examples

URL Description
https://yts.ac/api/v2/list_movies.json?quality=3d Returns the latest 20 3D movies using JSON format
https://yts.ac/api/v2/list_movies.xml?sort_by=download_count&limit=15 Returns maximum 15 movies which are sorted by download count

Response Data

Key Name Description Example
movie_count The 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 which will hold multiple movies and their relative information ARRAY
To get Magnet URLs you need to construct this yourself like so:

magnet:?xt=urn:btih:TORRENT_HASH&dn=Url+Encoded+Movie+Name&tr=http://track.one:1234/announce&tr=udp://track.two:80

You can add as many trackers as you want, we recommend the following:

- udp://open.demonii.com:1337/announce
- udp://tracker.openbittorrent.com:80
- udp://tracker.coppersurfer.tk:6969
- udp://glotorrents.pw:6969/announce
- udp://tracker.opentrackr.org:1337/announce
- udp://torrent.gresille.org:80/announce
- udp://p4p.arenabg.com:1337
- udp://tracker.leechers-paradise.org:6969

Movie Details

HTTP GET

Endpoint Description
https://yts.ac/api/v2/movie_details.json
https://yts.ac/api/v2/movie_details.jsonp
Returns the information about a specific movie

Endpoint Parameters

Parameter Required Type Default Description
movie_id Integer (Unsigned) null The id of the movie(It is necessary if the imdb_code is not setted)
imdb_code String null The imdb id of the movie(It is necessary if the movie_id is not setted)
with_images Boolean false When set the data returned will include the added image URLs
with_cast Boolean false When set the data returned will include the added information about the cast

Examples

URL Description
https://yts.ac/api/v2/movie_details.json?movie_id=68232 Returns basic information about the movie with ID of 68232
https://yts.ac/api/v2/movie_details.json?movie_id=68232&with_images=true&with_cast=true Returns the full information (with image urls and cast information) about the movie with ID of 68232
To get Magnet URLs you need to construct this yourself like so:

magnet:?xt=urn:btih:TORRENT_HASH&dn=Url+Encoded+Movie+Name&tr=http://track.one:1234/announce&tr=udp://track.two:80

You can add as many trackers as you want, we recommend the following:

- 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 Reviews

HTTP GET

Endpoint Description
https://yts.ac/api/v2/movie_reviews.json
https://yts.ac/api/v2/movie_reviews.jsonp
Returns all the IMDb movie reviews for the specified movie

Endpoint Parameters

Parameter Required Type Default Description
movie_id Integer (Unsigned) null The ID of the movie

Examples

URL Description
https://yts.ac/api/v2/movie_reviews.json?movie_id=68232 Returns IMDb movie reviews for the movie with ID of 68232
Close