Other pages

Bitblast API Documentation v1.0

The Bitblast API is available for Pro members. It lets you add/remove torrents from your library, lets you see see metadata related to torrents, lets you probe the contents, and provides http access to download or stream torrents directly from a web browser or app. This site is built on top of the API.

Contents

Getting started

To get started using the API go to your settings page and click on “Manage your API keys”. If you don't already have a key click the “Create a new key” button, and it will be generated. The key is made up of two parts: a key and a secret.

Never share your secret key with anyone.

There are two types of API requests. The Bitblast application and the Bitblast cloud.

Making Requests

Bitblast application

Making a request to the application API is fairly simple. To authenticate all you have to do is send a header Bitblast-Key containing your secret key. It looks like this:

Bitblast-Key: YOUR_SECRET_KEY

Because the data is stored encrypted, some endpoints may require also passing a decryption token.

The application API allows you to add/remove torrents and get a list of your torrents stored in your account.

Full documentation of the available endpoints can be found at bitblast.io/docs/api/endpoints#app.

Bitblast cloud

Making a request to the Bitblast cloud API involves using your key and secret key to generate a signed URL. This is because there will be clients/browsers requesting the data which would expose your secret publicly if it was in a request header.

To see how to generate a signed URL go to bitblast.io/docs/api/signing-requests.

To see a list of the available cloud endpoints go to bitblast.io/docs/api/endpoints#cloud.