Skip to main content
GET
/
api
/
v1
/
blacklistchecker
curl "https://lookup.proweblook.com/api/v1/blacklistchecker?target=192.0.2.1&target_type=ip&api_key=YOUR_API_KEY"

{
  "status": true,
  "listed": false,
  "target": "192.0.2.1",
  "target_type": "ip",
  "listed_count": 0,
  "checked_count": 42,
  "blacklists": [
    { "source": "spamhaus.org", "listed": false, "details": "" },
    { "source": "barracudacentral.org", "listed": false, "details": "" }
  ],
  "balance": 99
}

​
Overview

The Blacklist Checker API verifies whether an IP address, domain, or URL appears in major public blacklists and spam databases (DNSBL, SURBL, spam feeds, etc.). Useful for email deliverability, fraud detection, and network security workflows. This endpoint supports both GET and POST requests.

​
Request Parameters

​
api_key
string
required
Your ProWebLook API key. See Authentication.
​
target
string
required
The IP address, domain, or URL to check against blacklists.Examples: 192.168.1.1, example.com, https://example.com/path
​
target_type
string
required
The type of the target. Must be one of:
ValueDescription
ipChecks the target as an IPv4/IPv6 address
domainChecks the target as a domain name
urlChecks the target as a full URL (domain is extracted internally)
autoAuto-detects the type based on the target format
​
sources
string
Optional. Comma-separated list of blacklist sources to check against. If omitted, all available sources are checked.

​
Response

​
status
boolean
true if the check completed successfully, false if an error occurred.
​
listed
boolean
true if the target was found on one or more blacklists.
​
target
string
The checked target (normalized form).
​
target_type
string
The resolved target type (ip, domain, or url).
​
blacklists
array
Array of blacklist check results. Each entry contains:
​
listed_count
integer
Number of blacklists on which the target is listed.
​
checked_count
integer
Total number of blacklists checked.
​
balance
integer
Your remaining blacklist credits after this request.

​
Credit Cost

1 blacklist credit is deducted from your blacklist_balance per successful check. 
curl "https://lookup.proweblook.com/api/v1/blacklistchecker?target=192.0.2.1&target_type=ip&api_key=YOUR_API_KEY"

{
  "status": true,
  "listed": false,
  "target": "192.0.2.1",
  "target_type": "ip",
  "listed_count": 0,
  "checked_count": 42,
  "blacklists": [
    { "source": "spamhaus.org", "listed": false, "details": "" },
    { "source": "barracudacentral.org", "listed": false, "details": "" }
  ],
  "balance": 99
}