API Documentation ez24
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 s 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
Us
API Endpoints 6i1b5n
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 20cx
HTTP GET 35y70
Endpoint | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/list_movies.json https://yts-mx.freeanime.info/api/v2/list_movies.jsonp https://yts-mx.freeanime.info/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 133k4v
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 | |
quality |
String (480p, 720p, 1080p, 1080p.x265, 2160p, 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/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 (title, year, rating, peers, seeds, _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 | |
with_rt_ratings |
Boolean | false | Returns the list with the Rotten Tomatoes rating included |
Examples 3t471z
URL | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/list_movies.json?quality=3D |
Returns the latest 20 3D movies using JSON format |
https://yts-mx.freeanime.info/api/v2/list_movies.xml?sort=seeds&limit=15 |
Returns maximum 15 movies which are sorted by seeds |
Response Data 5yn17
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:
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
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 2n6859
HTTP GET 35y70
Endpoint | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/movie_details.json https://yts-mx.freeanime.info/api/v2/movie_details.jsonp https://yts-mx.freeanime.info/api/v2/movie_details.xml |
Returns the information about a specific movie |
Endpoint Parameters 133k4v
Parameter | Required | Type | Default | Description |
---|---|---|---|---|
movie_id or imdb_id |
Integer (Unsigned) | null | The YTS ID of the movie or the IMDB ID | |
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 3t471z
URL | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/movie_details.json?movie_id=10 |
Returns basic information about the movie with ID of 10 |
https://yts-mx.freeanime.info/api/v2/movie_details.json?movie_id=15&with_images=true&with_cast=true |
Returns the full information (with image urls and cast information) about the movie with ID of 15 |
To get Magnet URLs you need to construct this yourself like so:
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
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 Suggestions 6f5zj
HTTP GET 35y70
Endpoint | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/movie_suggestions.json https://yts-mx.freeanime.info/api/v2/movie_suggestions.jsonp https://yts-mx.freeanime.info/api/v2/movie_suggestions.xml |
Returns 4 related movies as suggestions for the |
Endpoint Parameters 133k4v
Parameter | Required | Type | Default | Description |
---|---|---|---|---|
movie_id |
Integer (Unsigned) | null | The ID of the movie |
Examples 3t471z
URL | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/movie_suggestions.json?movie_id=10 |
Returns related movies to the movie with ID of 10 |
Movie Parental Guides 1t5s4h
HTTP GET 35y70
Endpoint | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/movie_parental_guides.json https://yts-mx.freeanime.info/api/v2/movie_parental_guides.jsonp https://yts-mx.freeanime.info/api/v2/movie_parental_guides.xml |
Returns all the parental guide ratings for the specified movie |
Endpoint Parameters 133k4v
Parameter | Required | Type | Default | Description |
---|---|---|---|---|
movie_id |
Integer (Unsigned) | null | The ID of the movie |
Examples 3t471z
URL | Description |
---|---|
https://yts-mx.freeanime.info/api/v2/movie_parental_guides.json?movie_id=10 |
Returns the parental guides for the movie with the ID of 10 |