Piloterr

Domain DNSBL

GET
/v2/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
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

A domain name or IP address to check against DNS-based blacklists (DNSBL).

Examples:

185.122.10.10

The 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

Successful response

application/json
  1. response
address?string
detected?
providers?
blacklisted?boolean
Example Request
curl -X GET 'https://api.piloterr.com/v2/domain/dnsbl?query=string'
Example Response
{  "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}