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

Autorização

ApiKeyAuth
x-api-key<token>

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

In: header

Parâmetros de consulta

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.

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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"}