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:

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, up to 10 at a time)
So, a valid "check" api url would look like:

http://www.fspamlist.com/api.php?key=###########&spammer=email@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>email@mail.ru</spammer>
		<isspammer>true</isspammer>
		<lastseen>2011-02-26 10:52:34</lastseen>
		<timesreported>11</timesreported>
		<threat>30.5</threat>
		<notes>Email wildcard match *@mail.ru 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>68.132.56.126</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":"email@mail.ru",
      "isspammer":"true",
      "lastseen":"2011-02-26 10:52:34",
      "timesreported":"11",
      "threat":"30.5",
      "notes":"Email wildcard match *@mail.ru Time taken: 0.009087085723877"
   },
   {
      "spammer":"spammername",
      "isspammer":"false",
      "lastseen":"-",
      "timesreported":"-",
      "threat":"-",
      "notes":"Time taken: 0.008774995803833"
   },
   {
      "spammer":"68.132.56.126",
      "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:"email@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:60:"Email wildcard match *@mail.ru 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:13:"68.132.56.126";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:

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

Spammer
n.
Any person/machine who is involved in the transmission of unsolicited messages in any sector of the Internet.


RSS:
 Latest
 Most Reported
 Most Reported 30d