ΞTorrentSpam.comΞ - API Service

API

Welcome to the new TorrentSpam API System.

How Do I Use the API System?

Using your favorite web language, you can call on the following URLs to grab your data to validate your torrents against the spam list. We currently support two type of files: single file, or group list. We can also output in two types: plain text or XML.

Reporting Bad Torrents to Us

Example: <a href="http://www.torrentspam.com/index.php?op=createItem&Torrent=[Eclipse] Claymore - 17 (XviD) [40AFE84B].avi&Category=Anime
&Hash=40fc37113954486db58449f00ccfa1ae40739e93
&Creator=Anonymous&Submit=1">Report Torrent as Spam</a>

Where Can I find the Spam Listing?

Retrieving Spam List

Plain Text Output
Format: Torrent Name --- Hash Value --- Count

where <myDomain> is your domain name: ie mininova, sumotorrent, btscene, etc.

Xml Output

Lists all torrents with a count above 10.

List ALL Items

This list all reported torrents (5000 at a time). At the bottom xml file is a 'nextPage' element that has the URL to the next grouping of torrents.

Output By Date Range
You can use the Epoch Time (The PHP time() function) to get a range of reported items based on date they were inserted to the DB. Or in C# it would be:
TimeSpan t = (DateTime.UtcNow - new DateTime(1970, 1, 1));
int timestamp = (int) t.TotalSeconds;
Then put the timestamp in place of the times needed.

Check Indiviual Files

Plain Text Output - Based on Torrent Name
Format: Torrent Name --- Hash Value --- Count

XML Output - Based on Torrent Name

Plain Text Output - Based on Hash Value
Format: Torrent Name --- Hash Value --- Count

XML Output - Based on Hash Value

How Can I Help People Before they download the Torrent?

You can help the cause by alerting others of invalid torrents by adding a info icon next to the torrent download. There are three types: small, medium, and large.