What can I use this API for?

You can use this API to do tasks on BTN through easy to use commands, in your application.

What are the usage limits?

Everyone has a limit of 150 calls per hour, per API key which is unique to your user account.

Usage

It is recommended that you use a library for JSON-RPC to connect to our API. Once you have one, you must send the method along with your parameters.

For PHP, we use this library: JSONRPC-PHP

The API URL is http://api.broadcasthe.net/

Possible Exception Error return codes

  • 400 Bad Request: invalid parameters
  • 401 Unauthorized: invalid api key
  • 404 Not Found: the method was not found
  • 503 Service Unavailable: invalid API Key, or you have hit the API too much


API Documentation

Because i'm too lazy to write proper descriptve documentation for the API calls and parameters, I'll just run Apigen on the code, which documents each call and the required vars.

If you're not a good enough programmer to understand the apigen documentation, then you shouldn't be messing with our API!

Documentation



Examples

getTorrentsSearch
				include('jsonRPCClient.php');
				$a = new jsonRPCClient('http://api.broadcasthe.net/');
				$apikey = '1234';
				$results = $a->getTorrentsSearch($apikey, array("series" => "House", "name" => "S08E01"), 2);
				print_r($results);
			
Results
				Array
				(
					[133155] => Array
						(
							[GroupName] => S08E01
							[GroupID] => 68477
							[TorrentID] => 133155
							[SeriesID] => 53
							[Series] => House
							[SeriesBanner] => https://cdn2.broadcasthe.net/tvdb/banners/graphical/73255-g22.jpg
							[Category] => Episode
							[Snatched] => 32
							[Seeders] => 24
							[Leechers] => 0
							[Source] => HDTV
							[Container] => MPEG
							[Codec] => MPEG2
							[Resolution] => 720p
							[Origin] => P2P
							[ReleaseName] => House.S08E01.720p.HDTV.DD5.1.MPEG2
							[Time] => 2012-02-21 23:35:27
						)

					[97063] => Array
						(
							[GroupName] => S08E01
							[GroupID] => 68477
							[TorrentID] => 97063
							[SeriesID] => 53
							[Series] => House
							[SeriesBanner] => https://cdn2.broadcasthe.net/tvdb/banners/graphical/73255-g22.jpg
							[Category] => Episode
							[Snatched] => 930
							[Seeders] => 96
							[Leechers] => 0
							[Source] => Unknown
							[Container] => AVI
							[Codec] => XViD
							[Resolution] => SD
							[Origin] => 0
							[ReleaseName] => House.MD.S08E01.Media.Screener
							[Time] => 2012-02-21 23:35:27
						)
				)