Get Torrent Cached Availability
GET {{api_base}}/{{api_version}}/api/torrents/checkcached?hash={{torrent_hash}}&format=object&list_files=boolean
Overview
Takes in a list of comma separated torrent hashes and checks if the torrent is cached. This endpoint only gets a max of around 100 at a time, due to http limits in queries. If you want to do more, you can simply do more hash queries. Such as:
?hash=XXXX&hash=XXXX&hash=XXXX
or ?hash=XXXX,XXXX&hash=XXXX&hash=XXXX,XXXX
and this will work too. Performance is very fast. Less than 1 second per 100. Time is approximately O(log n) time for those interested in taking it to its max. That is without caching as well. This endpoint stores a cache for an hour.
You may also pass a format parameter with the format you want the data in. Options are either object or list. You can view examples of both below.
Authorization
Requires an API key using the Authorization Bearer Header.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
hash | string | The list of torrent hashes you want to check. Comma seperated. | |
format | string | Format you want the data in. Acceptable is either "object" or "list". List is the most performant option as it doesn't require modification of the list. | |
list_files | string | Allows you to list the files found inside the cached data. |
RESPONSES
status: OK
{"success":true,"error":null,"detail":"Torrent cache status retrieved successfully.","data":null}