Email Blacklist API Documentation

How To Use Blacklist API


Blacklist API use case

Every day, billions of emails are sent. Not thousands. Not millions. Billions! It’s hard for any software or system to automatically or programmatically detect if a message is spam or a genuine important email message from one person to another. So there are a lot of false positives, and there are companies that get blacklisted just because of a bad neighborhood.

You know what we are talking about, email blacklists are a real issue, and our Blacklist API helps you detect that issue, whether it’s an IP address or a domain name. So if you are a hosting company with hundreds of IP addresses, or an email marketing company with thousands of them, our email blacklist API can tell you when an IP or a domain name gets blacklisted by one of the major RBL blacklists.

For detailed code examples that will help you use Blacklist API, see our code examples page.

Blacklist API pricing

For pricing packages, please check our Blacklist API pricing page. New users get a one-time bonus of 10,000 free API requests. If you want to learn more about our Email Blacklist API or IP Blacklist API, then check the Email Blackist API page. With our IP Blacklist API you can check IP address or domain name if it is blacklisted for email spamming. That’s why some people call it Email Blacklist API and some call it IP Blacklist API, some are checking IP addresses, while others are checking emails and domain names.

Blacklist API

Blacklist API how to

Let’s make an example Whois lookup API request:

http://api.whoapi.com/?domain=whoapi.com&r=blacklist&apikey=demokey

Output in JSON format:

{
  "status": "0",
  "ip": "104.130.21.170",
  "blacklisted": "0",
  "blacklists": [ {
    "tracker": "surbl.org",
    "blacklisted": "0"
 },
  {
    "tracker": "barracudacentral.org",
    "blacklisted": "0"
 },
  {
    "tracker": "sorbs.net",
    "blacklisted": "0"
 },
  {
    "tracker": "spamhaus.org",
    "blacklisted": "0"
 } ],
  "requests_available": 100
}

http://api.whoapi.com/?domain=whoapi.com&r=blacklist&apikey=demokey&asxml

Output in XML format:

<?xml version="1.0"?>
<response>
  <status>0</status>
  <ip>52.32.117.162</ip>
  <blacklisted>0</blacklisted>
  <blacklists>
    <item0>
      <tracker>surbl.org</tracker>
      <blacklisted>0</blacklisted>
    </item0>
    <item1>
      <tracker>barracudacentral.org</tracker>
      <blacklisted>0</blacklisted>
    </item1>
    <item2>
      <tracker>sorbs.net</tracker>
      <blacklisted>0</blacklisted>
    </item2>
    <item3>
      <tracker>spamhaus.org</tracker>
      <blacklisted>0</blacklisted>
    </item3>
  </blacklists>
  <requests_available>100</requests_available>
</response>