Torrent API

Introduction

UNIT3D is offering a new {JSON:API}. If you haven't already head over to your profile. Hover Settings nav and click API Key. From there you can generate or reset your API Key.

Ecosystem

Torrent auto uploaders

• L4G's Upload Assistant — a simple tool to take the work out of uploading
• GG Bot Upload Assistant — a torrent auto uploader to take the manual work out of uploading

API authentication

There are several ways of passing the API token to UNIT3D. We'll discuss each of these approaches while using the Guzzle HTTP library to demonstrate their usage. You may choose any of these approaches based on your needs to communicate with our API.

• Query string

  UNIT3D's API consumers may specify their token as an api_token query string value:

  $response = $client->request('GET', '/api/torrents?api_token=YOUR_TOKEN_HERE);
  

• Request payload

  UNIT3D's API consumers may include their API token in the request's form parameters as an api_token:

  $response = $client->request('POST', '/api/torrents', [
      'headers' => [
          'Accept' => 'application/json',
      ],
      'form_params' => [
          'api_token' => 'YOUR_TOKEN_HERE',
      ],
  ]);
  

• Bearer token

  UNIT3D's API consumers may provide their API token as a Bearer token in the Authorization header of the request:

  $response = $client->request('POST', '/api/torrents', [
      'headers' => [
          'Authorization' => 'Bearer YOUR_TOKEN_HERE',
          'Accept' => 'application/json',
      ],
  ]);
  

API endpoints

Upload a torrent

Endpoint: POST /api/torrents/upload

Parameters:

*Only available to staff and internal users.

Fetch a torrent

Endpoint: GET /api/torrents/:id

Example:

https://unit3d.site/api/torrents/39765?api_token=YOURTOKENHERE

Fetch torrents index (latest 25 torrents)

Endpoint: GET /api/torrents

Example:

https://unit3d.site/api/torrents?api_token=YOURTOKENHERE

Filter torrents

Endpoint: GET /api/torrents/filter

Optional Parameters:

Example:

https://unit3d.site/api/torrents/filter?tmdbId=475557&categories[]=1&api_token=YOURTOKENHERE

Personal account info

Endpoint: GET /api/user

Response:

{"username":"UNIT3D","group":"Owner","uploaded":"50 GiB","downloaded":"1 GiB","ratio":"50","buffer":"124 GiB","seeding":0,"leeching":0,"seedbonus":"0.00","hit_and_runs":0}

Example:

https://unit3d.site/api/user?api_token=YOURTOKENHERE