API
FSpamlist offers API programs (to any registered members) who wish to use it. The XML APIs can be used in other web applications to identify spammers as well as add spammers to our database.
The "check" API url is:
http://www.fspamlist.com/api.php
To check to see if a username, ip address, or e-mail is a spammer, you need to pass the url these parameters:
- Your API Key
- And the names, ips, and emails to check (separated by a comma)
http://www.fspamlist.com/api.php?key=[###########]&spammer=[email@mail.ru,spammername,68.132.56.126]
Replace the brackets with the actual data you're using.
The return from this "check" API would look like:
<spammers>
<spammercheck>
<spammer>email@mail.ru</spammer>
<isspammer>yes</isspammer>
<lastseen>2008-08-06 12:44:43</lastseen>
<timesreported>10</timesreported>
</spammercheck>
<spammercheck>
<spammer>spammername</spammer>
<isspammer>no</isspammer>
<lastseen>-</lastseen>
<timesreported>-</timesreported>
</spammercheck>
<spammercheck>
<spammer>68.132.56.126</spammer>
<isspammer>yes</isspammer>
<lastseen>2008-10-06 12:44:43</lastseen>
<timesreported>2</timesreported>
</spammercheck>
</spammers>
<spammercheck>
<spammer>email@mail.ru</spammer>
<isspammer>yes</isspammer>
<lastseen>2008-08-06 12:44:43</lastseen>
<timesreported>10</timesreported>
</spammercheck>
<spammercheck>
<spammer>spammername</spammer>
<isspammer>no</isspammer>
<lastseen>-</lastseen>
<timesreported>-</timesreported>
</spammercheck>
<spammercheck>
<spammer>68.132.56.126</spammer>
<isspammer>yes</isspammer>
<lastseen>2008-10-06 12:44:43</lastseen>
<timesreported>2</timesreported>
</spammercheck>
</spammers>
Alternatively, you can add &serial or &json to the end of the query string to change the output format.
We also offer an "add" API program to those who wish to contribute to the FSpamlist database automatically.
The url for the "add" API program is:
http://www.fspamlist.com/apiadd.php
The most common use for this API is the SpamBotSearchTool (SBST) click here and here
Currently, the SBST is the only supported use for this API. If you would like to use this API in your program(s), please contact us first.
