IP Blocklist Download

GET {{baseUrl}}/ip-blocklist-download?format=csv&cidr=false&ip6=false&category=all&output-encoding=<string>&checksum=false

This API is a direct feed to our IP blocklist data

Request Params

KeyDatatypeRequiredDescription
formatstringThe data format. Can be either CSV or TXT
cidrbooleanOutput IPs using CIDR notation. This option should be preferred but is off by default for backwards compatibility
ip6booleanOutput the IPv6 version of the blocklist, the default is to output IPv4 only. Note that this option enables CIDR notation too as this is the only notation currently supported for IPv6
categorystringThe category of IP addresses to include in the download file, possible values are: <br> <ul> <li>all - all IPs available on your current plan (excludes VPN providers for any plans lower than Tier 3)</li> <li>bot - all IPs hosting a malicious bot or part of a botnet. This is a broad category which includes brute-force crackers</li> <li>exploit-bot - all IPs hosting an exploit finding bot or running exploit scanning software</li> <li>hijacked - all IPs that are part of a hijacked netblock or a netblock controlled by a criminal organization</li> <li>malware - all IPs involved in distributing or running malware or spyware</li> <li>proxy - all IPs detected as an anonymous web proxy or anonymous HTTP proxy</li> <li>spam-bot - all IPs hosting a spam bot, comment spamming or any other spamming type software</li> <li>spider - all IPs running a hostile web spider / web crawler</li> <li>tor - all IPs that are Tor nodes or running a Tor related service</li> <li>vpn - all IPs belonging to public VPN providers (only available for Tier 3 or higher accounts)</li> </ul>
output-encodingstringSet this option to 'gzip' to have the output file compressed using gzip
checksumbooleanDo not download the file but just return the current files MurmurHash3 checksum. You can use this feature to check if the file has changed since a previous check

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

&quot;\u003cstring\u003e&quot;