Bitblast API Endpoints

The following is a list of currently available endopoints for the API. It is broken down into two sections app and cloud.

Contents

App Endpoints¶

All of these endpoints require sending the header

Bitblast-Key: YOUR_SECRET_KEY

Some will also require a header containing a decryption token

Bitblast-Decrypt: YOUR_DECRYPTION_TOKEN

• Get decryption token¶

  Returns a decryption token. This is a string that you need to pass to certain endpoints to return the data in a human readable form.

  POST https://bitblast.io/api/decryption-token
  

  Parameter	Description	Required
  password	The Bitblast password belonging to the account associated with the Bitblast-Key	Yes

  Sample response:

  {
      "token": "qFkZMbj2h9"
  }
  

  The returned token should be good for around an hour. It should be cached on the client and reused on subsequent requests until it returns a 401 - at that point you should request a new token

• Save a torrent¶

  Saves a torrent file to your account to allow access to it later on

  PUT https://bitblast.io/api/torrent
  

  Header	Required
  Bitblast-Decrypt	No

  Parameter	Description	Required
  src	URL or magnet URL of the torrent file you want to add	Yes
  name	Name to give this torrent	No

  Sample response:

  {
      "success": true
  }
  

• Remove a torrent¶

  Removes a torrent file stored with your account

  DELETE https://bitblast.io/api/torrent
  

  Header	Required
  Bitblast-Decrypt	No*

  Parameter	Description	Required
  src	URL or magnet URL of the torrent file you want to delete	Yes
  hash	Torrent hash	No
  id	ID retrieved from list call	No

  If you pass a hash or an id then the src is not required.

  *If you delete using an id then the header is not required. Otherwise it is.

  Sample response:

  {
      "success": true
  }
  

• List saved torrents¶

  Lists all torrent files saved to your account and relevant metadata

  GET https://bitblast.io/api/torrents
  

  Header	Required
  Bitblast-Decrypt	Yes

  No Parameters

  Sample response:

  {
      "count": 3,
      "torrents": [
          {
              "id": 789,
              "name": "SXSW 2015 Showcase",
              "src": "http://www.sxswtorrent.com/SXSW_2015_Showcasing_Artists_Part1.torrent",
              "added_on": "2015-06-20 13:25:32"
          },
          {
              "id": 456,
              "name": "Sita Sings the Blues",
              "src": "magnet:?xt=urn:btih:258ba33d4156ee910d34b005dc2c9f5200a8940d&dn=Sita+Sings+the+Blues+%282008%29+720p+%5Bincl.+subs%5D&tr=udp%3A%2F%2Ftracker.openbittorrent.com%3A80&tr=udp%3A%2F%2Fopen.demonii.com%3A1337&tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969&tr=udp%3A%2F%2Fexodus.desync.com%3A6969",
              "added_on": "2015-05-12 18:36:12"
          },
          {
              "id": 123,
              "name": "CentOS 7.0",
              "src": "http://linuxtracker.org/download.php?id=1354ac45bfb3e644a04d69cc519e83283bd3ac6a&f=CentOS-7.0-1406-x86_64-DVD.torrent&key=6c2d037a",
              "added_on": "2015-01-03 20:04:01"
          }
      ]
  }
  

Cloud Endpoints¶

These endpoints require generating a signed url

• Get Torrent Info¶

  Gets a list of all files associated with this torrent and their respective sizes.

  GET https://cloud.bitblast.io/info
  

  Parameter	Description	Required
  src	URL or magnet URL of the torrent file you want to get info about	Yes
  seeders	Include the number of seeders and leechers for this torrent in the response	No

  Sample response:

  {
      "name": "CentOS-7.0-1406-x86_64-DVD",
      "hash": "1354ac45bfb3e644a04d69cc519e83283bd3ac6a",
      "seeders": 579,
      "leechers": 20,
      "files": [
          {
              "name": "CentOS-7.0-1406-x86_64-DVD/CentOS-7.0-1406-x86_64-DVD.iso",
              "size":4148166656
          },
          {
              "name": "CentOS-7.0-1406-x86_64-DVD/sha256sum.txt",
              "size": 609
          },
          {
              "name":"CentOS-7.0-1406-x86_64-DVD/sha256sum.txt.asc",
              "size":1485
          }
      ]
  }
  

• Probe¶

  Probes a torrent to return media info related to a video file, audio file, or image

  GET https://cloud.bitblast.io/probe
  

  Parameter	Description	Required
  src	URL or magnet URL of the torrent file you want to get info about	Yes
  file	The numeric index of a single file from the files list returned from the info endpoint. If you don't specify a file index the probe analysis will run on the largest file in the torrent.	No

  Sample response:

  The response will be the JSON formatted results from ffprobe.

• Download¶

  Downloads the specified torrent or magnet url

  GET https://cloud.bitblast.io/download
  

  Parameter	Description	Required
  src	URL or magnet URL of the torrent file you want to download	Yes
  files	A comma separated list of file indexes based on the files list returned from the info endpoint. By default this endpoint will download all files.	No
  file	The numeric index of a single file from the files list returned from the info endpoint.	No

  Sample response:

  If you specify a single file that file will download directly from the browser. If you specify more than one file this endpoint will return a zip file with all the specified files included.

• Get¶

  Serves a file from the specified torrent directly in the browser

  GET https://cloud.bitblast.io/get
  

  Parameter	Description	Required
  src	URL or magnet URL of the torrent file you want to get	Yes
  file	The numeric index of a single file from the files list returned from the info endpoint. If you don't specify a file index the request will grab the largest file in the torrent.	No

  Sample response:

  This will return the specified file via http.