Documentation/docs/index.md

The JSON API provides an easily parseable interface to BioTorrents.de. Please use the navigation menu to find lists of endpoints, their arguments, and example responses.

You must be logged in to use the API. This is done by sending a POST request to

https://biotorrents.de/login.php

with username and password and storing a cookie to be used to access the rest of the API.

Introduction

All request URLs are in the form

ajax.php?action=<action>

All the JSON returned is in the form

{
  "status": "success",
  "response": {
    # data
  }
}

If the request is invalid, or a problem occurs, the status will be failure. In this case the value of response is undefined.

Libraries

These are the current public projects listed on the What.CD Gazelle wiki. Questions about the API can be answered in #development on Slack.

Please get it touch if you’d like me to list your project below.

Language	GitHub
C#	frankston/WhatAPI
Go	kdvh/whatapi
JavaScript	deoxxa/whatcd
Java	Gwindow/WhatAPI
PHP	Jleagle/gazelle-api-client
Python	isaaczafuta/whatapi
Ruby	chasemgray/RubyGazelle

Caveats

Abusing or using this API for malicious purposes is a bannable offense and will not be taken lightly.

Rate limit

The API is rate-limited to one request every 12 seconds. This limit doesn’t apply to users in the Donor class. Please consider donating to support this scientific resource’s development.

Under construction

Some endpoints aren’t working correctly right now:

• artist
• preview

Oppaitime Gazelle also contains other undocumented endpoints:

• get_friends
• news_ajax
• send_recommendation

Not implemented

Similar artists

Request

ajax.php?action=similar_artists

&id= — id of artist (required)

&limit= — maximum number of results to return (fewer might be returned)

Response

Better

Fetch better.php (suggested torrent improvements).

Request

ajax.php?action=better

Response

Torrent info

Request

ajax.php?action=torrent_info

Response

Check private

Request

ajax.php?action=checkprivate

Response

Vote favorite

Request

ajax.php?action=votefavorite

Response