Search Usenet By Query
Overview
Searches for usenet based off of a query. This returns data such as title data which can contain information about the usenet download in detail such as season, episode, encoder, quality and more. Data is the same as the torrent endpoint for compatibility. 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. |
| 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 usenets.","data":{"metadata":null,"nzbs":[{"hash":"ec085344f5d14c3432f88c10615df513","raw_title":"The Empire Strikes Back (1980) DVD NoGroup","title":"The Empire Strikes Back","title_parsed_data":{"year":1980,"title":"The Empire Strikes Back","encoder":"DVD","site":"NoGroup"},"magnet":null,"last_known_seeders":-1,"last_known_peers":-1,"size":0,"tracker":"Some Indexer","categories":["Movies HD"],"files":[],"type":"usenet","nzb":"http://XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"}],"time_taken":0.61,"cached":true,"total_nzbs":181}}