Search Torrents By Query
Overview
Searches for torrents based off query. 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 is a fast and full text search, so you can use this anywhere, with typos, with issues, and it will still be able to know exactly what you are searching for.
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. |
| 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: ``