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=kubuntu
| 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)
<answer>
<hasResults>1</hasResults>
<results>
<hitsTotal>603</hitsTotal>
<pageNumber>2</pageNumber>
<hitsForThisPage>10</hitsForThisPage>
<hits id="11">
<name>kubuntu 13 04 alpha1 desktop amd64</name>
<extension>iso</extension>
<size>954 MB</size>
<description>No description saved</description>
<link>
http://www.filestube.com/bXkQVzNru5Pbr6MUVWFccn
</link>
<tags>kubuntu|alpha|desktop</tags>
<rate>0.00</rate>
<added>2007-09-17 00:44:16</added>
<related>14f84a6dab7f39c603e9</related>
<password/>
</hits>
<hits id="12">
...
</hits>
...
<hits id="20">
...
</hits>
</results>
2. No results were found (or wrong 'phrase' given with a 'related' token):
<answer>
<hasResults>0</hasResults>
3. Error response message (if something went wrong or invalid data were used):
<error>
<message>No phrase specified</message>
