API Basics
Data Tools
Browser Bot
HTML Clean
URL Info
Security and Networking
Legacy APIs

Host Reputation

Check the reputation of an IP address, domain name or URL against a comprehensive list of blacklists and blocklists.

The majority of the lists we check are geared towards filtering hosts involved in the sending or operation of spam however some of the lists are more specialized and will list hosts involved in other forms of cybercrime too. These lists are most commonly known as DNSBLs (Domain Name System Blackhole Lists) or RBLs (Real-time Blackhole Lists) and work using DNS based lookups. All DNSBLs have different listing and removal criteria, if you are trying to delist a host you'll need to do this directly with the DNSBL operator. You can usually find more details about an active listing in the 'txt-record' response field. If you want to only check some specific DNSBLs you can supply those using the 'zones' option or you can use the 'list-rating' option to check a range of different lists using our built-in rating system.

This API currently checks more than 150 different DNSBLs.

If you are looking to filter IP addresses specifically used by Tor, VPNs, proxies, bots and other malicious activities check out the IP blocklist and IP Probe APIs. This API performs realtime lookups against external servers and may take up to 30 seconds to execute depending on the current status of the DNSBLs. However, on average this API will complete in under 7 seconds. Our DNS record caching policy is fixed at a 6 hour TTL.

End Point

Test API
API Request
hostyesstringAn IP address, domain name, FQDN or URL.
If you supply a domain/URL it will be checked against the URI DNSBL lists
list-ratingnointeger3Only check lists with this rating or better
zonesnostringOnly check these DNSBL zones/hosts. Multiple zones can be supplied as comma-separated values
API Response
hoststringThe IP address or host name
is-listedbooleanIs this host blacklisted
list-countintegerThe number of DNSBLs the host is listed on
listsarrayArray of objects for each DNSBL checked:
is-listedbooleanTrue if the host is currently black-listed
list-namestringThe name of the DNSBL
list-hoststringThe hostname of the DNSBL
list-ratingintegerThe list rating [1-3] with 1 being the best rating and 3 the lowest rating
txt-recordstringThe TXT record returned for this listing (only set if listed)
return-codestringThe specific return code for this listing (only set if listed)
response-timeintegerThe DNSBL server response time in milliseconds
API Performance
Avg Latency5-20s (variable)This API has a non-deterministic latency based on outside factors
Max Rate1/secondMaximum inbound request rate. Exceeding this will result in request throttling
Max Concurrency25Maximum concurrent/simultaneous requests. Exceeding this will result in error code 06 [TOO MANY CONNECTIONS]

API Example
curl https://neutrinoapi.net/host-reputation \ --header "User-ID: <your-user-id>" \ --header "API-Key: <your-api-key>" \ --data-urlencode "host=neutrinoapi.com" \ --data-urlencode "list-rating=3" \ --data-urlencode "zones="