The section is designed for working with the API to obtain the information on the visitor or the domain. This section can be ideal for systems that cannot implement JavaScript tools and have to work with historical data that have passed through the WhiteDiagnostic system. Create blacklists based on WD IP reports or Source level reporting, or import your own blacklists.


Black List API provides a solution for the traffic and its sources testing when there is no option of using active testing tools such as Sites, TrackingTag, AdManager, and Redirector. The effectiveness of this tool is based on historical visitors’ data and the domains that have been tested earlier by the WhiteDiagnostic system. We strongly recommend using it in tandem with the active traffic inspection tools – so that you get the maximum impact when using our system.


Black List API is quite simple to use, the response speed on your requests is sufficiently high and this tool is suitable for heavily loaded systems (for example, ad networks, RTB-platforms). To use the Black List API, the following items are required:

URL, which your system will be requested to test;

Two Black List API access keys, which are transmitted to the URL. These keys are generated during registration in our system and can be changed anytime. After generating the new keys, the old ones will stop working within 5 minutes.

To get more information on IP or Domain, you need to transmit them to the Black List API via the URL request as GET-parameters: &ipor &domain. You can transmit only one parameter for testing, either the IP or the Domain. If there are both parameters in the request, the priority will be given to the IP testing.

In response to your request, there will be information on whether the IP or the Domain is registered in our database. If the data on the requested object exists, you will get a quality assessment of the IP or Domain according to our evaluation (scoring) scale between 0 (perfect) and 999 (very bad). In the case of the Domain related request, you will be provided with the additional information on whether the site subject refers to the categories that include harmful content which can have an affect an advertised brand.

Get in touch

Icon 15821 Ventura Blvd, Suite
435, Encino, CA 91436
Icon 1-323-522-48-25

© 2021 White Diagnostic All rights reserved