Documentation

Getting Started

Free Analysis
Pricing
FAQ
Threat Level Guide
Result Codes
List Profile Report
Threat Intelligence Center
Best Practices
Data Export Specs
Country Disposition

API

API Overview
Verification/Threats API
Threats API
IVT/ Bots API ►
Bulk FTP Transfer
Bulk API List Submission

Bots API Overview (Coming soon...!)

Non-Human, Invalid Traffic API Overview

Protect against high-risk traffic sources (bad actors) and guard against ad-fraud in the form of Non-Human Invalid Traffic (IVT). Our sophisticated machine learning algorithms identify traffic originating from botnets, data center traffic, click farms, proxies, malicious script injectors and hijacked devices, , delivering the highest quality reach.

Our invalid traffic API can be seamlessly integrated into your signup or onboarding process with just a single request. This high-speed service is designed for real-time, verification of the IP address or traffic attempting to connect thru to your landing page.

Structure and Definition for Inbound Submissions

Our API requires you to authenticate each individual request. Below is an example of a basic URL structure request, just substitute with the provided account, associated password along with any optional parameters.

Structure: https://post.impressionwise.com/botcheck.aspx?CODE=000001&PWD=password1

Required Data Fields

Parameters need to be separated by "&"

&CODE= 6 Digit numeric, acccount code provided by Impressionwise = 000001
&PWD= Alpha-numeric, security code provided by Impressionwise = password1
&IP= Proper formatted IP address. An IP address is a set of numbers that identify your computer on a network. IPV4, the traditional numbering scheme, uses four integers ranging from zero to 255 and set apart by periods. For example, "204.120.0.15" is a valid IPV4 address.

Parameters and Usage

To verify an email address simply use the request shown in the sample below substituting the required parameters with provided credentials and email address you want to verify.

Sample = https://post.impressionwise.com/botcheck.aspx?code=000001&pwd=password1&IP=192.168.1.15

Upon successful posting of an email address, you can expect to receive the following response.

Response = IP=192.168.1.15&RESULT=SPAMBOT&TTP=0.41

Possible result parameter/values include:

&RESULT= "See below section Result Code section for additional detail"
&TTP= "Time it took to process value represented in seconds"

Error Handling

From time to time you may experience an API error. It is important to watch out for these and handle them appropriately. Specifically, if your submission contains an invalid account code or password the result response would be WRONG_PSW.

While it is uncommon some replies to take an excessive amount of time to respond (sometimes more than 5 seconds). Due to this possible condition, you will receive a result code of RETRY. Upon reception of this response, please continue your HTTP submissions thru to completion of the entire data set to be submitted.. Once complete, please retry any/all responses with "RETRY" or as shown below:

Response = IP=192.168.1.15&RESULT=RETRY&TTP=0.33

If you receive any other response other than those previously shown, please contact support.

Result Codes

The recommended guidelines presented below will ensure only quality traffic reach your landing page or final destination.

Description		Response	Guidance
	Certified Domestic. US-based email address with no known reason to expect a delivery failure or harm to email senders online reputation.	Confirmed	Send
	Data Mining Crawler. A specific purpose-built Internet bot which systematically browses the internet in search of data exploits.	Crawler	Suppress/ Do Not Pass Traffic
	Anonymizing Proxy/ TOR/ Click Farm. Anonymizing services create a tunnel between user and the internet. Users are hidden under the IP address of the VPN server.	TOR
	Fake Crawler/ Ghost Sites. IP addresses that do not belong to the robots of major search engines (Google, Bing, Yandex ..), but they send the user agent strings of these robots.	Ghost
	Malicious Spam Bot. E-mail spambots harvest e-mail addresses from material found on the Internet in order to build mailing lists for sending unsolicited e-mail (such as Cutwail, Rustock, Lethic, Kelihos, etc.), which have been abused to send spam, worms/viruses that do their own direct mail transmission, some times of trojan-horse or "stealth" spamware, dictionary mail harvesters, etc.	SpamBot
	Known Attack Source. IP addresses scan HTTP/HTTPS for vulnerable installations of known web applications (phpMyAdmin, Joomla ..), Brute-Force Logins (Joomla, Wordpress ..) and run attacks on the services MAIL, SMTP, IMAP, POP3, etc.	Attacker

Questions? Please feel free to contact us with any questions or specific customization requirements you may have regarding our automated, data cleansing feed services to ensure a successful evaluation or use of our services and let the results speak for themselves!