IPQualityScore Integration
Proxy & VPN Detection
Overview
Proactively prevent fraud via a simple API that provides over 25 data points for risk analysis, geo location, and IP intelligence.
Appended Fields
IPQualityScore will append the following data to your lead.
| Appended Field | Description |
|---|---|
Outcome | Integration outcome (success, failure, or error) |
Reason | If outcome is error, the error reason |
Proxy | True if the IP address is suspected to be a proxy |
Host | Hostname of the IP address |
Isp | ISP if one is known, otherwise "N/A" |
Organization | Organization if one is known. Can be parent company or sub company of the listed ISP. |
Asn | Autonomous System Number |
Country Code | Two character country code |
City | City |
Region | State or region |
Timezone | Timezone |
Latitude | Latitude |
Longitude | Longitude |
Is Crawler | True if the IP address is associated with a confirmed crawler from a mainstream search engine |
Connection Type | Classification of the IP address connection type as "Residential", "Corporate", "Education", "Mobile", or "Data Center" |
Recent Abuse | True if there has been any recently verified abuse for this IP address. Abuse could be a confirmed chargeback, compromised device, fake app install, or similar malicious behavior within the past few days. |
Abuse Velocity | How frequently the IP address is engaging in abuse across the IPQS threat network. Values can be "high", "medium", "low", or "none". |
Bot Status | True if bots or non-human traffic have recently used this IP address to engage in automated fraudulent behavior |
Vpn | True if the IP address is suspected of being a VPN connection |
Tor | True if the IP address is suspected of being a TOR connection |
Active Vpn | True if the IP address is an active connection of a popular VPN service |
Active Tor | True if the IP address is an active TOR exit |
Mobile | True if the user agent is a mobile browser. (will always be false if user agent is not provided) |
Fraud Score | The overall fraud score of the user based on the IP, user agent, language, and any other optionally passed variables |
Request Id | Unique request identifier |
Operating System | Operating system name and version or "N/A" |
Browser | Browser name and version or "N/A" |
Device Brand | Brand name of the device or "N/A" |
Device Model | Model name of the device or "N/A" |
Fields
The following fields are used by this integration and automatically added to your flow when missing.
| Field | Description |
|---|---|
Ip Address | IP Address |
Custom Input Variables
The following are configuration options (typically not collected with lead data).
| Variable | Description |
|---|---|
| Proxy Detection Strictness | Numeric value 0-3 for how in depth (strict) the query will be. Higher values take longer to process and may provide a higher false-positive rate. |
| Proxy Detection User Language | Optional user language header |
| Proxy Detection Fast | Set to true if to perform a faster lookup with slightly reduced accuracy |
| Proxy Detection Mobile | Set to true if the lead is from a mobile device |
| Proxy Detection Allow Public Access Points | Set to true if to skip certain checks for IP addresses from education and research institutions, schools, and some corporate connections. |
| Proxy Detection Lighter Penalties | Set to true if to use lower detection rates and Fraud Scores for mixed quality IP addresses |
| Timeout Seconds | Produce an "error" outcome if the server fails to respond within this number of seconds (default: 360) |