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

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
http://yify.is/api/v2/list_movies.json
http://yify.is/api/v2/list_movies.xml
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 Integer (Unsigned) 1 Used to see the next page of movies, eg limit=15 and page=2 will show you movies 15-30
query_term String 0 Used for movie search, matching on: Movie Title/IMDb Code, Actor Name/IMDb Code, Director Name/IMDb Code
genre String All Used to filter by a given genre (See http://www.imdb.com/genre/ for full list)
sort_by String (trending, popularity, date_added, year, rating, download_count, like_count) date_added Sorts the results by choosen value
order_by String (desc, asc) desc Orders the results by either Ascending or Descending order
with_rt_ratings Boolean false Returns the list with the Rotten Tomatoes rating included

Examples

URL Description
http://yify.is/api/v2/list_movies.json?genre=Action Returns the latest 20 action movies using JSON format
http://yify.is/api/v2/list_movies.xml?sort_by=rating&limit=15 Returns maximum 15 movies which are sorted by rating
http://yify.is/api/v2/list_movies.xml?query_term=Leonardo DiCaprio Returns movies whith Leonardo DiCaprio

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
- udp://tracker.istole.it:80
- http://tracker.yify-torrents.com/announce
- udp://tracker.publicbt.com:80
- udp://tracker.openbittorrent.com:80
- udp://tracker.coppersurfer.tk:6969
- udp://exodus.desync.com:6969
- http://exodus.desync.com:6969/announce

Movie Details

HTTP GET

Endpoint Description
http://yify.is/api/v2/movie_details.json
http://yify.is/api/v2/movie_details.xml
Returns the information about a specific movie

Endpoint Parameters

Parameter Required Type Default Description
movie_id Integer (Unsigned) null The ID of the movie
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
http://yify.is/api/v2/movie_details.json?movie_id=85206 Returns basic information about the movie with ID of 85206
http://yify.is/api/v2/movie_details.json?movie_id=85206&with_images=true&with_cast=true Returns the full information (with image urls and cast information) about the movie with ID of 85206
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
- udp://tracker.istole.it:80
- http://tracker.yify-torrents.com/announce
- udp://tracker.publicbt.com:80
- udp://tracker.openbittorrent.com:80
- udp://tracker.coppersurfer.tk:6969
- udp://exodus.desync.com:6969
- http://exodus.desync.com:6969/announce