Skip to main content
Network status
Log in
Piloterr
Back to library

Domain DNSBL API

Check if a domain or IP address is listed in DNS-based blacklists (DNSBL), with detailed provider-level detection and category information.

Active1 credit = 1 requestGET/v2/domain/dnsbl
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

Try now for freePiloterr

OverviewLink to Overview

The Domain DNSBL endpoint checks any domain or IP address against hundreds of DNS-based blacklists (DNSBL). It reveals whether the target is blacklisted, which providers detected it, and in which abuse categories.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/domain/dnsbl?query=185.122.10.10

ParametersLink to Parameters

Parameter Type Required Description
query string yes Domain name or IPv4 address to check

Response fieldsLink to Response fields

Field Type Description
address string The checked domain or IP
blacklisted boolean Whether listed in any DNSBL
detected.count number Number of detecting providers
detected.providers array Providers that flagged the address
detected.categories object Per-provider category labels
providers.failed_count number Count of unavailable providers
providers.domains_count number Total DNSBL domains checked

NotesLink to Notes

  • Categories: unknown, spam, exploits, phish, malware, cnc, abused, legit.
  • blacklisted: false does not guarantee legitimacy.

Main use casesLink to Main use cases

  • Screen sender IPs before configuring email delivery infrastructure
  • Automate spam prevention by blocking blacklisted IPs
  • Monitor your mail server IP reputation for unexpected blacklisting
  • Enrich security threat intelligence with real-time DNSBL data

Related APIs

Expand your data capabilities with these complementary tools.

View All
Domain Malicious/v2/domain/malicious

Check if a domain or IP address has been flagged as malicious across multiple threat intelligence feeds, with source attribution.

GET1 credit = 1 requestActive
Domain Whois/v2/domain/whois

Retrieve WHOIS registration data for any domain, including registration dates, registrar details, name servers, and contact information.

GET1 credit = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert