Get Torrent Data
Overview
Searches for torrents based off of ID type and ID. This returns data such as title data which can contain information about the torrent in detail such as season, episode, encoder, quality and more. Data comes with seeders, peers, as well as a magnet link, which can be used to actually download the torrent.
This endpoint's data is cached after the first request for 7 days.
Checking For Cached
This endpoint allows you to pass
check_cache
, which allows you to check whether searched items are on TorBox's cache or not (instant download). If this parameter is passed, it will show the
cached
key in the results as a boolean.
The above is also the same for the
check_owned
parameter, which allows you to check whether searched items are on a user's account already. If this parameter is passed, it will show the
owned
key in the results as a boolean.
Authentication
This endpoint requires Bearer token authentication using your TorBox account API Key. This also requires a paid plan to use.
Request Params
| Key | Datatype | Required | Description |
| metadata | string | | If you want to show metadata with the request. Optional. Defaults to false. |
| season | string | | The season you want to search for, if any. Optional. |
| episode | string | | The episode you want to search for, if any. Optional. |
| check_cache | string | | Allows you to check whether the results are cached on TorBox or not. Optional. Defaults to false. |
| check_owned | string | | Allows you to check whether the results are available on TorBox account or not. Optional. Defaults to false. |
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status: OK
{"success":true,"message":"Successfully found metadata and torrents.","data":{"metadata":null,"torrents":[{"hash":"8b66277c4a5fb01792eae8907f7be4a4318ae6bf","raw_title":"Star Wars - Episode V - The Empire Strikes Back","title":"Star Wars - Episode V - The Empire Strikes Back","title_parsed_data":{"resolution":"1080p","quality":"Blu-ray","year":1980,"codec":"H.265","audio":"AAC 7.1","bitDepth":10,"title":"Star Wars - Episode V - The Empire Strikes Back","excess":"XXXXXX","encoder":"XXXXXX"},"magnet":"XXXXXXXXXXXXXXXX","last_known_seeders":0,"last_known_peers":0,"size":0,"tracker":"Some Tracker","categories":[2000],"files":null}],"time_taken":0.46,"cached":true,"total_torrents":33}}