Seedpeer API Documentation

Draft number 0.0.5 Revised Stable

Terms of Service

This documentation will explain what the API is and what can be accomplished with it. This service can only be used by developers who want to integrate our search results into their meta search engine/website/blog or software. It is not allowed to use this API to offer direct downloads without our written consent.

Basic concept (?apitype=) + API key (&apikey=)

Api requests require several variables, in this section we are going to discuss the most basic and most primitive of them.

Basic API requests

All request are done with the GET method and must be fired at http://api.seedpeer.com/ , the &apikey= must be the url of your website or application thats making use of this API. bellow you will find a list of request types:

Providing a false url in the &apikey= variable will result in a server wide ban

Search Torrents 
?apitype=search&query=search term&apikey=http://www.yoursite.com

Use this variable if you want to search inside a specific category:
Optional: &maincat=anime|games|movies|music|software|tv shows|others
Todays Torrents 
?apitype=latest&apikey=http://www.yoursite.com
Torrents by member 
?apitype=user&username=axxo&apikey=http://www.yoursite.com
Torrents by category 
?apitype=category&maincat=anime|games|movies|music|software|tv shows|others + &apikey=http://www.yoursite.com
Torrents by sub category 
?apitype=subcategory&maincat=anime|games|movies|music|software|tv shows|others &subcat=subcatname + &apikey=http://www.yoursite.com
Verified Torrents 
?apitype=verified&apikey=http://www.yoursite.com

Sorting the results (&sort=) (enum)

The API allows sorting torrents in many ways. However, this variable is optional, if not specified the output is going to be sorted by date in a descending fashion (ORDER BY * DESC for the mysql guys). 

&sort    =	filename_asc
		filename_desc
		date_desc
		date_asc
		size_desc
		size_asc
		seeds_desc
		seeds_asc
		peers_desc
		peers_asc
		health_desc
		health_asc
		verified_desc
		verified_asc
		comments_desc
		comments_asc
		reportreal_asc
		reportreal_asc
		reportwarn_asc
		reportwarn_asc

Limiting the number of results (&limit=) (int)

By default only 50 torrents are displayed, you can choose any number starting from 1 up to 250 torrents. This variable is also optional. In case a maximum of 250 is not enough, the &page= variable will come in very handy.

Paging through results (&page=) (int)

This optional variable allows you to browse torrents beyond the max. value of the limit variable above.

Output format/type (&output=) (enum)

In total we have 3 output formats:

php
The php format is basically an array that has been serialized with serialize() , to convert it back to an array use the unserialize() function inside php.

json
This format is commonly used in combination with javascript/ajax, but can also be converted into an array with the php json_decode() function (php 5.2.0)

xml (default)
The xml format is easy to parse by any language out there. Die hard php developers should check out the simplexml() function.

Returned data elements

id		-> Torrent id
url		-> Url to the details page
hash		-> Hash of the torrent
filename	-> Filename
added		-> Date torrent was added in unix epoch 
category	-> The main category
subcategory	-> The subcategory
filesize	-> Size of the file in bytes
seeds		-> Number of seeds
peers		-> Number of peers
comments	-> Number of comments
warnings	-> Number of times the file has been reported as bad
reportedreal	-> Number of times the file has been reported as real
verified	-> 0 or 1 , 1 means that the file has been verified by our admins


Seedpeer Torrents | Verified Torrents