FilsTube XML Search API Documentation

Before using the API you must get a unique key.

Take a look at the examples below to get some idea on how to use the api.

1. Example request (get)

http://api.filestube.com/?key=2c17a6258659780e0bc6d2ca41ab731e&phrase=britney

Parameter	Value	Description
key	string (required)	Unique key (you can generate one here after logging in).
phrase	string (required)	Phrase to search for.
related	string	After setting this to one of the related tokens received in previous response you can search for related results. It is important to use the same phrase as in previous request, otherwise you will get 0 results.
sort	string: 'sa', 'sd', 'da', 'dd'	Sorting type: sa - size ascending, sd - size descending, da - date ascending, dd - date descending.
page	integer	The page number of results you want to get, i.e.: 1, 2, 3 ...
extension	string, one of: 'rar', 'wmv', 'avi', 'mpg', 'mpeg', 'mp3', 'wma', 'zip'	Search for files with a given extension. Extensions other than listed are ignored.

2. Example response (XML)

1. Successful response for the example request (above):

<answer>

<name>I_am_a_good_daughter_-_Britney.part1.rar</name>

<description>No description saved</description>

http://www.filestube.com/91539aa90c9c531d03e9/go.html

</address>

http://www.filestube.com/91539aa90c9c531d03e9/details.html

</details>

<tags>good|daughter|britney</tags>

</hits>

...

</hits>

...

...

</hits>

</results>

</answer>

2. No results were found (or wrong 'phrase' given with a 'related' token):

<answer>

</answer>

3. Error response message (if something went wrong or invalid data were used):

<error>

<message>No phrase specified</message>

</error>

3. Example usage of our XML API in PHP:

$url="http://api.filestube.com/?key=2c17a6258659780e0bc6d2ca41ab731e&phrase=britney&page=2"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL,$url); curl_setopt($ch, CURLOPT_FAILONERROR, 1); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt($ch, CURLOPT_TIMEOUT, 30); $result = curl_exec($ch); print curl_error($ch); curl_close($ch); $document = new DOMDocument('1.0', 'UTF-8'); $document->loadXML($result); $answer = $document->getElementsByTagName('answer')->item(0); if($answer!=null) { $hasResults = $answer->getElementsByTagName('hasResults')->item(0); if($hasResults->nodeValue == 1) { $hits = $answer->getElementsByTagName('hits'); foreach($hits as $hit) { $name = $hit->getElementsByTagName('name')->item(0)->nodeValue; $extension = $hit->getElementsByTagName('extension')->item(0)->nodeValue; $desc = $hit->getElementsByTagName('description')->item(0)->nodeValue; $size = $hit->getElementsByTagName('size')->item(0)->nodeValue; $address = $hit->getElementsByTagName('address')->item(0)->nodeValue; $details = $hit->getElementsByTagName('details')->item(0)->nodeValue; $added = $hit->getElementsByTagName('added')->item(0)->nodeValue; $related = $hit->getElementsByTagName('related')->item(0)->nodeValue; $counter=$hit->getAttribute('id'); print '<div style="border:1px dotted #CCC;padding:10px;">'; print $counter."<br />"; print "Name : $name <br />"; print "Extension : $extension <br />"; print "Date added : $added <br />"; print "Description : $desc <br />"; print "Size : $size <br />"; print "Related : $related <br />"; print "<a href='$address' title='$name'>Download</a><br />"; print "<a href='$details' title='$name'>File's Details</a>"; print "</div>"; } } else { print '<div style="border:1px dotted #CCC;padding:10px;">'; print '0 results <br />'; print "</div>"; } } else { $error = $document->getElementsByTagName('error')->item(0); if($error!=null){ $message = $error->getElementsByTagName('message')->item(0)->nodeValue; print '<div style="border:1px dotted #CCC;padding:10px;">'; print 'Message: '.$message."<br />"; print "</div>"; } }

FilesTube.com is a search engine designed to search files
in various file sharing and uploading sites like rapidshare, megaupload and mediafire.