Domain DNSBL
Check if a domain or IP address is listed in DNS-based blacklists (DNSBL), with detailed provider-level detection and category information.
Credit cost: 1 credit per call
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
A domain name or IP address to check against DNS-based blacklists (DNSBL).
Examples:
185.122.10.10The API checks the input against hundreds of DNSBL providers and returns whether it has been blacklisted, along with the list of detecting providers and their categories.
Note: Both IPv4 addresses and domain names are accepted.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/domain/dnsbl?query=string"{
"address": "185.122.xx.xx",
"detected": {
"count": 5,
"providers": [
"dbl.spamhaus.org",
"spambot.bls.digibase.ca",
"abuse-contacts.abusix.org",
"origin.asn.cymru.com",
"peer.asn.cymru.com"
],
"categories": {
"dbl.spamhaus.org": [
"unknown"
],
"peer.asn.cymru.com": [
"unknown"
],
"origin.asn.cymru.com": [
"unknown"
],
"spambot.bls.digibase.ca": [
"unknown"
],
"abuse-contacts.abusix.org": [
"unknown"
]
}
},
"providers": {
"failed": [
"list.bbfh.org",
"dnsbl.darklist.de",
"dnsbl.isx.fr"
],
"domains": [
"dbl.spamhaus.org",
"spambot.bls.digibase.ca",
"zen.spamhaus.org"
],
"failed_count": 23,
"domains_count": 271
},
"blacklisted": true
}{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}