DEV – WSC

YTS API Documentation, Complete Guide

Written by

Felipe Ramirez | WSC – We Simplify Complexity

in

YTS — YIFY HD Movies

YTS API Documentation

A lightweight REST service providing programmatic access to YTS movies data. Free to use in your apps and websites — no API key required. Please cache responses where possible and keep request rates reasonable.

🔓 No API Key Required
💾 Free to Use
⚡ REST API v2
🎬 JSON / JSONP / XML

Base URL (v2)

https://yts.bz/api/v2/

⚠️ Source Reference

This documentation is based on the official YTS API available at yts.bz/api. If you are using an older base URL, please update your integration to https://yts.bz/api/v2/ — older endpoints may be retired in the future.

All Endpoints

Universal Response Structure

All API endpoints return the same base data structure.

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

HTTP GET

🎬 List Movies

Endpoints
https://yts.bz/api/v2/list_movies.json
https://yts.bz/api/v2/list_movies.jsonp
https://yts.bz/api/v2/list_movies.xml

Used to list and search through all available movies. Can sort, filter, search and order the results.

Endpoint Parameters
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
480p
720p
1080p
1080p.x265
2160p
3D
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
title
year
rating
peers
seeds
download_count
like_count
date_added
date_added Sort results by chosen value
order_by optional desc
asc 		desc Order results ascending or descending
with_rt_ratings optional Boolean false Include Rotten Tomatoes rating in results

Examples
https://yts.bz/api/v2/list_movies.json?quality=3D

Returns the latest 20 3D movies using JSON format

https://yts.bz/api/v2/list_movies.xml?sort=seeds&limit=15

Returns maximum 15 movies sorted by seeds in XML format

Response Data
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

🧲 Constructing Magnet URLs

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

Recommended Trackers
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

HTTP GET

📋 Movie Details

https://yts.bz/api/v2/movie_details.json
https://yts.bz/api/v2/movie_details.jsonp
https://yts.bz/api/v2/movie_details.xml

Returns the information about a specific movie.

Endpoint Parameters
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
Examples
https://yts.bz/api/v2/movie_details.json?movie_id=10

Returns basic information about the movie with ID of 10

https://yts.bz/api/v2/movie_details.json?movie_id=15&with_images=true&with_cast=true

Returns full information (with image URLs and cast information) about the movie with ID of 15

🧲 Constructing Magnet URLs

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

Recommended Trackers
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

HTTP GET

💡 Movie Suggestions

https://yts.bz/api/v2/movie_suggestions.json
https://yts.bz/api/v2/movie_suggestions.jsonp
https://yts.bz/api/v2/movie_suggestions.xml

Returns 4 related movies as suggestions for the user.

Endpoint Parameters
Parameter Required Type Default Description
movie_id optional Integer (Unsigned) null The ID of the movie
Example
https://yts.bz/api/v2/movie_suggestions.json?movie_id=10

Returns 4 related movies to the movie with ID of 10

HTTP GET

🛡️ Movie Parental Guides

https://yts.bz/api/v2/movie_parental_guides.json
https://yts.bz/api/v2/movie_parental_guides.jsonp
https://yts.bz/api/v2/movie_parental_guides.xml

Returns all the parental guide ratings for the specified movie.

Endpoint Parameters
Parameter Required Type Default Description
movie_id optional Integer (Unsigned) null The ID of the movie
Example
https://yts.bz/api/v2/movie_parental_guides.json?movie_id=10

Returns the parental guides for the movie with the ID of 10

📚 Official Source

This documentation is based on the official YTS API reference.

yts.bz/api ↗

🔗 Supported Formats
JSON
JSONP
XML

All endpoints support JSON, JSONP and XML response formats.
💬 Support & Feedback

Found a bug or have questions? Get in touch with the YTS team directly.

Contact YTS ↗

Quick Reference — All Endpoints
v2/list_movies.json List, search, sort and filter all available movies
v2/movie_details.json Full details for a specific movie by YTS ID or IMDB ID
v2/movie_suggestions.json Returns 4 related movie suggestions for a given movie ID
v2/movie_parental_guides.json All parental guide ratings for a specified movie

YTS
·
API Docs
·
Blog
·
DMCA
·
RSS
·
Contact

YTS © 2011–2026. By using this site you agree to and accept the User Agreement.

More posts