Blacklist Check and Blacklist Monitoring REST API v1 documentation

You can find API v0 documentation here.

Authentication: You can authorize  using API key.

Response header HTTP status:

  • 200, 201: OK
  • 204: IP address or domain name is not monitored
  • 400: Bad request, see error description
  • 401: Not authorized
  • 402: No API calls left, please renew your subscription
  • 406: Bad IP address or domain name
  • 429: Too many requests
  • 500: Internal server error

Response body: On success "status" = "OK", "response" =  "OK". On error "status" = "ERROR" and "response" contains error description.

API methods and request limits:

Method API key
access level
Calls per second Calls per minute Calls per hour
Get blacklist monitor (IP, domain) Any 5 120 2,000
List blacklist monitors (IP, domain) Any 5 20 200
Get blacklist monitor and blacklists (IP, Domain) Any 5 120 1,000
List blacklist monitors and blacklists (IP, Domain) Any 5 20 200
Create blacklist monitor (IP, Domain) Unrestricted 5 200 Not limited
Delete blacklist monitor (IP, Domain) Unrestricted 5 200 Not limited
Blacklist Check Any 5+ 60+ Not limited

API calls per month

Blacklist monitors ISP plan
Get + List
Basic plan
Get + List
Professional plan
Get + List
Standard plan
Get + List
Plus plan
Get + List
Premium plan
Get + List
Create Delete Blacklist Check
2 1,000 200
3 2,000 5,000 300
5, 7 2,000 8,000 300
10 1,000 4,000 8,000 15,000 200 200 300
20 2,000 8,000 15,000 30,000 200 200 300
30 1,000 3,000 12,000 25,000 45,000 200 200 300
50 1,000 5,000 20,000 40,000 75,000 300 300 500
100 10,000 40,000 75,000 150,000 500 500 700
200 3,000 75,000 150,000 1,000 1,000 800
300 20,000 115,000 230,000 1,500 1,500 1,000
400 150,000 300,000 2,000 2,000 1,000
600 10,000 30,000 230,000 450,000 3,000 3,000 1,500
1,024 20,000 40,000 240,000 450,000 4,000 4,000 2,000
2,048 20,000 40,000 75,000 250,000 500,000 6,000 6,000 2,000
4,096 40,000 80,000 150,000 300,000 600,000 10,000 10,000 3,000
8,192 80,000 150,000 300,000 15,000 15,000 3,000
16,384 150,000 300,000 600,000 25,000 25,000 5,000
32,768 300,000 40,000 40,000 7,000
65,536 600,000 70,000 70,000 10,000

For annual billing plans, monthly API usage counters are reset on the first day of each month at 0:00 UTC. For monthly payment plans, monthly API usage counters are reset at the time the next monthly payment is received.

If the rate limit is exceeded, API responds with a HTTP 429 Too Many Requests response code:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json  
{
        "status": "ERROR",
        "response": "Too Many Requests"
}


IP address blacklist monitors

List IP address blacklist monitors https://www.blacklistmaster.com/restapi/v1/ip?apikey=<APIKey>

Get IP address blacklist monitor https://www.blacklistmaster.com/restapi/v1/ip/<IPAddress>?apikey=<APIKey>


HTTP method: GET

Example request: Get all IP addresses, API key "12345"

curl https://www.blacklistmaster.com/restapi/v1/ip?apikey=12345

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 19996,
  "response": "OK",
  "IPs":
 [
  {
   "ip": "1.1.1.1",
   "group_name": "",
   "ip_description": "Web server",
   "last_test_date_UTC": "2013-03-26 11:28:15",
   "blacklist_cnt": "3",
   "new_blacklist_cnt": "3",
   "reputationscore": "99"
  },
  {
   "ip": "2.2.2.2",
   "group_name": "",
   "ip_description": "Mail server",
   "last_test_date_UTC": "2013-03-26 11:28:15",
   "blacklist_cnt": "3",
   "new_blacklist_cnt": "3",
   "reputationscore": ""
  }
 ]
}

Get IP address 1.2.3.4, API key "12345"

curl https://www.blacklistmaster.com/restapi/v1/ip/1.2.3.4?apikey=12345

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 19990,
  "response": "OK",
  "IPs": [
    {
      "ip": "1.2.3.4",
      "group_name": "Test",
      "ip_description": "Web server",
      "last_test_date_UTC": "2013-10-21 14:02:17",
      "blacklist_cnt": "2",
      "new_blacklist_cnt": "1",
      "reputationscore": "99"     
    }
  ],
  "blacklists": [
    {
      "blacklist": "dnsbl.example.com",
      "blacklist_name": "Example RBL",
      "blacklist_url": "http://www.example.com",
      "is_new": "0"
    },
    {
      "blacklist": "some.rbl.org",
      "blacklist_name": "Some RBL",
      "blacklist_url": "http://www.rbl.org",
      "is_new": "1"
    }
  ]
}

IP address blacklist monitors and blacklists

List IP address blacklist monitors and blacklists https://www.blacklistmaster.com/restapi/v1/ipbl?apikey=<APIKey>

Get IP address blacklist monitor and blacklists https://www.blacklistmaster.com/restapi/v1/ipbl/<IPAddress>?apikey=<APIKey>

List IP address blacklist monitors, blacklisting severity and blacklists IPs listed in. Blacklisting severity is maximum severity level of RBLs the IP is listed in. It's possible to set Medium or High severity level to every blacklist.


HTTP method: GET

Example request: Get all IP addresses, API key "12345"

curl https://www.blacklistmaster.com/restapi/v1/ipbl?apikey=12345

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 19996,
  "response": "OK",
  "IPs":
 [
    {
        "ip": "1.2.3.4",
        "group_name": "Mail servers",
        "ip_description": "Mail server",
        "last_test_date_UTC": "2017-09-02 13:01:02",
        "blacklist_cnt": "3",
        "new_blacklist_cnt": "0"
        "reputationscore": "",
        "severity": "High",
        "blacklists":
        [
            {
                "blacklist": "rbl.somerbl.org",
                "blacklist_name": "Some RBL",
                "blacklist_url": "http://somerbl.org",
                "is_new": "0",
                "severity": "Medium"
            },
            {
                "blacklist": "dnsbl.powerrbl.net",
                "blacklist_name": "Power RBL",
                "blacklist_url": "http://www.powerrbl.net",
                "is_new": "0",
                "severity": "High"
            },
        ]
    },
    {
        "ip": "4.3.2.1",
        "group_name": "Web servers",
        "ip_description": "Company.com website",
        "last_test_date_UTC": "2017-09-02 13:41:25",
        "blacklist_cnt": "0",
        "new_blacklist_cnt": "0"
        "reputationscore": "99",
        "severity": "",
        "blacklists":
        [
        ]
    },
 ]
}

Create IP address monitor

https://www.blacklistmaster.com/restapi/v1/ip?apikey=<APIKey>


HTTP method: POST

POST variables: id - IP address, ip_description - IP address description, group_id - Group ID, contactlist - Contact List ID.

To find Contact List ID and Group ID please visit your Contact Lists and Groups page.

Example requests: Add IP address "1.1.1.1", IP address description: "Mail server 01",  Group ID "2", contact list ID 1, API key "12345"

curl -X POST -d "id=1.1.1.1&ip_description=Mail server 01&group_id=2&contactlist=1" https://www.blacklistmaster.com/restapi/v1/ip?apikey=12345

Add IP address 1.1.1.1, empty description, empty group, contact list 2, API key "12345"

curl -X POST -d "id=1.1.1.1&contactlist=2" https://www.blacklistmaster.com/restapi/v1/ip?apikey=12345

Example Response:

HTTP/1.1 201 Created
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 199,
  "response": "OK"
}

Delete IP address monitor

https://www.blacklistmaster.com/restapi/v1/ip/<IPAddress>?apikey=<APIKey>


HTTP method: DELETE

Example request: Delete IP address 1.1.1.1, API key "12345"

curl -X DELETE  https://www.blacklistmaster.com/restapi/v1/ip/1.1.1.1?apikey=12345

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 199,
  "response": "OK"
}


Domain name blacklist monitors

List domain name blacklist monitors https://www.blacklistmaster.com/restapi/v1/domain?apikey=<APIKey>

Get domain name blacklist monitor https://www.blacklistmaster.com/restapi/v1/domain/<domain>?apikey=<APIKey>


HTTP method: GET

Example requests: Get all domain names, API key "12345"

curl https://www.blacklistmaster.com/restapi/v1/domain?apikey=12345

Get example.com, API key "12345"

curl https://www.blacklistmaster.com/restapi/v1/domain/example.com?apikey=12345

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 19996,
  "response": "OK",
 "domains":
 [
  {
   "domain": "example.com",
   "last_test_date_UTC": "2013-03-26 11:28:15",
   "group_name": "Webservers",
   "blacklist_cnt": "3",
   "new_blacklist_cnt": "3"
  },
  {
   "domain": "domain.com",
   "group_name": "",
   "last_test_date_UTC": "2013-03-26 11:28:15",
   "blacklist_cnt": "5",
   "new_blacklist_cnt": "3"
  }
  ]
}

Domain name blacklist monitors and blacklists

List domain name blacklist monitors and blacklists https://www.blacklistmaster.com/restapi/v1/domainbl?apikey=<APIKey>

Get domain name blacklist monitor and blacklists https://www.blacklistmaster.com/restapi/v1/domainbl/<domain>?apikey=<APIKey>

List domain name blacklist monitors, blacklisting severity and blacklists domain names listed in. Blacklisting severity is maximum severity level of RBLs domain name is listed in. It's possible to set Medium or High severity level to every blacklist.


HTTP method: GET

Example requests: Get all domain names, API key "12345"

curl https://www.blacklistmaster.com/restapi/v1/domainbl?apikey=12345

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json
{
    "status": "SUCCESS",
    "API_calls_remaining": 19956,
    "response": "OK",
    "domains":
    [
        {
            "domain": "domain.com",
            "last_test_date_UTC": "2017-09-02 15:01:41",
            "blacklist_cnt": "0",
            "new_blacklist_cnt": "0",
            "severity": "",
            "blacklists":
            [
            ]
        },
        {
            "domain": "example.com",
            "last_test_date_UTC": "2017-09-02 15:16:53",
            "blacklist_cnt": "3",
            "new_blacklist_cnt": "1",
            "severity": "Medium",
            "blacklists":
            [
                {
                    "blacklist": "bl.rbl1.org",
                    "blacklist_name": "rbl1.org blacklist",
                    "blacklist_url": "http://www.rbl1.org",
                    "is_new": "1",
                    "severity": "Medium"
                },
                {
                    "blacklist": "bl.rbl2.org",
                    "blacklist_name": "rbl2.org blacklist",
                    "blacklist_url": "http://rbl2.org",
                    "is_new": "0",
                    "severity": "Medium"
                },
                {
                    "blacklist": "bl.rbl3.org",
                    "blacklist_name": "rbl3.org blacklist",
                    "blacklist_url": "http://rbl3.org",
                    "is_new": "0",
                    "severity": "Medium"
                }
            ]
        }
    ]
}


Create domain name monitor

https://www.blacklistmaster.com/restapi/v1/domain?apikey=<APIKey>


HTTP method: POST

POST variables: id - domain name, group_id - Group ID, contactlist - Contact List ID.

To find Contact List ID and Group ID please visit your Contact Lists and Groups page.

Example request: Add domain name example.com, contact list 1, API key "12345"

curl -X POST -d "id=example.com&contactlist=1" https://www.blacklistmaster.com/restapi/v1/domain?apikey=12345

Example Response:

HTTP/1.1 201 Created
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 199,
  "response": "OK"
}

Delete domain name monitor

https://www.blacklistmaster.com/restapi/v1/domain/<domain>?apikey=<APIKey>


HTTP method: DELETE

Example request: Delete domain name example.com, API key "12345"

curl -X DELETE https://www.blacklistmaster.com/restapi/v1/domain/example.com?apikey=12345

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "SUCCESS",
  "API_calls_remaining": 199,
  "response": "OK"
}


Blacklist check

Blacklist check synchronous API call tests any IPv4, IPv6 address or domain name against blacklist database.

https://www.blacklistmaster.com/restapi/v1/blacklistcheck/ip/<IP_Address>?apikey=<APIKey>

https://www.blacklistmaster.com/restapi/v1/blacklistcheck/domain/<DomainName>?apikey=<APIKey>


  • Hotmail (Outlook) blacklist is not available for online check.
  • Blacklists you ignored in your account settings are ignored
  • Online blacklist lookup can not provide as accurate result as blacklist monitoring
  • To test API response time, you can perform IP or domain blacklist check.
  • Pricing and request rate limits

HTTP method: GET

Response header

Response body: On success "response" is "OK". On error "response" contains error description. If blacklisted, "status" is "Blacklisted", "blacklist_cnt" contains number of blacklists, "blacklist_severity" contains maximum severity level of RBLs the IP or domain is listed in ("High" or "Medium"). If not, "status" is "Not blacklisted", "blacklist_cnt" is 0, "blacklist_severity" is empty string.

Example request: Check IP address "1.2.3.4", API key "12345"

curl https://www.blacklistmaster.com/restapi/v1/blacklistcheck/ip/1.2.3.4?apikey=12345

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json
     {
        "status": "Blacklisted",
        "blacklist_cnt": 2,
        "blacklist_severity": "High",
        "API_calls_remaining": 1241,
        "response": "OK",
        "blacklists":
        [
            {
                "blacklist": "rbl.somerbl.org",
                "blacklist_name": "Some RBL",
                "blacklist_url": "http://www.somerbl.org"
                "blacklist_severity": "Medium"
            },
            {
                "blacklist": "dnsbl.powerrbl.net",
                "blacklist_name": "Power RBL",
                "blacklist_url": "http://www.powerrbl.net"
                "blacklist_severity": "High"
            }
        ]
    }


Understood
This website is using cookies. More details