Spam Master offers a professional API solution for integration with software, hardware, forums, blogs, applications, and more.

• Scan registrations, logins, comments, page visits, and more using firewall integration.
• Single API checks can scan multiple variables:
  • IP (IPv4/IPv6)
  • Email
  • Domain
  • Browser agent or bot name
  • Text or keywords
• Built for speed and reliability: get real-time results in milliseconds.

Implement the API securely using JSON over SSL. Every request must include your API key (mandatory). You can also add optional fields to scan: remote IP, email, browser agent, bot name, or text.

Spam Master automatically performs sub-scans, such as checking IPs against known ranges, scanning email domains, and analyzing text for spam heuristics.

Basic License Key Check (no threat scan)

https://www.spammaster.org/api/?key=MY_MANDATORY_API_KEY

• Returns your license key status or error:
• {"key":"KEY_CURRENT_STATUS"}
• {"error":"CHECK_ERRORS_BELOW"}

Threat Scan Examples

• Scan IP: https://www.spammaster.org/api/?key=MY_MANDATORY_API_KEY&ip=REMOTE_IP
• Scan Email: https://www.spammaster.org/api/?key=MY_MANDATORY_API_KEY&email=EMAIL@EXAMPLE.COM
• Scan Bot: https://www.spammaster.org/api/?key=MY_MANDATORY_API_KEY&bot=BROWSER_AGENT
• Scan Text: https://www.spammaster.org/api/?key=MY_MANDATORY_API_KEY&text=TEXT_TO_SCAN
• Full Scan: https://www.spammaster.org/api/?key=MY_MANDATORY_API_KEY&ip=REMOTE_IP&email=EMAIL@EXAMPLE.COM&bot=BROWSER_AGENT&text=TEXT_TO_SCAN

Spam Master API Test

// Setup the URL
$url = 'https://www.spammaster.org/api/';

// Use your software agent or API key as the agent
$agent = 'MY_API_KEY';

// Prepare data to scan (API key mandatory, others optional)
$data = array(
    'key'   => 'My_API_key',
    'ip'    => '23.244.123.144',
    'email' => 'spammer@this.nastyemail.com',
    'bot'   => 'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:62.0) Gecko/20100101 Firefox/62.0',
    'text'  => 'Have you ever wanted to work from home or just top up your earnings?...'
);
$data = http_build_query($data);

// Initialize cURL
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERAGENT, $agent);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

// Returns result of scan
return $result;

API Response Examples

• {"threat":{"ip":"REMOTE_IP"}}
• {"threat":{"email":"EMAIL@EXAMPLE.COM"}}
• {"threat":{"bot":"BOT"}}
• {"threat":{"heuristics":"TEXT"}}
• Multiple threats: {"threat":{"ip":"REMOTE_IP","email":"EMAIL@EXAMPLE.COM","bot":"BOT","heuristics":"TEXT"}}

Error Response Examples

• {"error":{"key":"key missing"}}
• {"error":{"key":"key invalid"}}
• {"error":{"key":"key expired"}}
• {"error":{"key":"key inactive"}}
• {"error":{"key":"key malfunction_*"}}
• {"error":{"key":"key exhausted"}}
• {"error":{"agent":"agent missing"}}
• {"error":{"agent":"agent invalid"}}
• {"error":{"ip":"ip invalid"}}
• {"error":{"email":"email invalid"}}
• {"error":{"bot":"bot invalid"}}
• {"error":{"heuristics":"text invalid"}}

// Decode the JSON result
$data = json_decode($result, true);

// Check for threats
if (!empty($data['threat'])) {
    // $data['threat'] may contain one or more detected threats (ip, email, bot, heuristics, etc.)
}

Check if your platform is already integrated—existing integrations have affordable yearly licenses. For new integrations, you can build your own and get support and sponsorship from Spam Master.