FSpamlist - Forum Spam List

API

Need a key? Register or Login

FSpamlist offers a dedicated API key (to any registered members) who wish to use it. Additionally, we offer a "public" API key, simply named "public", if you wish to test the FSpamList API before registering. The XML APIs can be used in other web applications to identify spammers and gain additional information.

The "check" API url is:

https://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, up to 10 at a time)

So, a valid "check" api url would look like:

https://fspamlist.com/api.php?key=###########&spammer=spammer12345@mail.ru,spammername,68.132.56.126

Replace the pound signs with your actual API key. If you just want to test the API without registering, you can use the public API key, "public".

The return from this "check" API would look like:

<spammers> 
	<spammercheck>
		<spammer>spammer12345@mail.ru</spammer>
		<isspammer>true</isspammer>
		<lastseen>2011-02-26 10:52:34</lastseen>
		<timesreported>11</timesreported>
		<threat>30.5</threat>
		<notes>Time taken: 0.01000189781189</notes> 
	</spammercheck>
	<spammercheck>
		<spammer>spammername</spammer>
		<isspammer>false</isspammer>
		<lastseen>-</lastseen>
		<timesreported>-</timesreported>
		<threat>-</threat>
		<notes>Time taken: 0.0087258815765381</notes> 
	</spammercheck>
	<spammercheck>
		<spammer>55.56.57.155</spammer>
		<isspammer>false</isspammer>
		<lastseen>-</lastseen>
		<timesreported>-</timesreported>
		<threat>-</threat>
		<notes>Time taken: 0.0087020397186279</notes> 
	</spammercheck>
</spammers>

Alertnative Formats

Alternatively, JSON and SERIAL output formats are available. You can add &serial or &json to the end of the query string to change the output format.

The same return with the &json parameter:

[
   {
      "spammer":"spammer12345@mail.ru",
      "isspammer":"true",
      "lastseen":"2011-02-26 10:52:34",
      "timesreported":"11",
      "threat":"30.5",
      "notes":"Time taken: 0.009087085723877"
   },
   {
      "spammer":"spammername",
      "isspammer":"false",
      "lastseen":"-",
      "timesreported":"-",
      "threat":"-",
      "notes":"Time taken: 0.008774995803833"
   },
   {
      "spammer":"55.56.57.155",
      "isspammer":"false",
      "lastseen":"-",
      "timesreported":"-",
      "threat":"-",
      "notes":"Time taken: 0.0084340572357178"
   }
]

The same return with the &serial parameter:

a:3:{i:0;a:5:{s:7:"spammer";s:13:"spammer12345@mail.ru";s:9:"isspammer";s:4:"true";s:8:"lastseen";s:19:"2011-02-26 10:52:34";s:13:"timesreported";s:2:"11";s:6:"threat";s:4:"30.5";s:5:"notes";s:29:"Time taken: 0.011636972427368";}i:1;a:5:{s:7:"spammer";s:11:"spammername";s:9:"isspammer";s:5:"false";s:8:"lastseen";s:1:"-";s:13:"timesreported";s:1:"-";s:6:"threat";s:1:"-";s:5:"notes";s:30:"Time taken: 0.0091550350189209";}i:2;a:5:{s:7:"spammer";s:12:"55.56.57.155";s:9:"isspammer";s:5:"false";s:8:"lastseen";s:1:"-";s:13:"timesreported";s:1:"-";s:6:"threat";s:1:"-";s:5:"notes";s:30:"Time taken: 0.0090310573577881";}}

Programs that use the API:

threatStop
IPVOID
Spambot Search Tool - by MysteryFCM
FSLC - Standalone windows program - by Gunner
FSL API - Addon for the xenForo "Stop Spam Here" anti-spam plugin
AnyAPI - Addon for the xenForo "AnyAPI" anti-spam plugin
SpamFilter - Addon for the Trac project
SpamBot detection handler - Addon for Contao CMS
SPAM Registration Stopper - Addon for Question2Answer

If you've created a program that uses the API and would like to share it with the world, please Contact us.