- About the IPQS APIs
- Proxy & VPN Detection API
- Email Verification API
- Phone Number Validation API
- Malicious URL Scanner API
- Device Fingerprint API
- Mobile Device Fingerprinting SDK
- Gaming Fraud Detection SDK
- Dark Web Leak API
- Malware File Scanner API
- Request List API
- Fraud Reporting API
- Account Management APIs
- Bulk Validation CSV
- Allowlist Blocklist APIs
- Plugins Platforms Integrations
- IP Reputation Database
- IP Address Abuse Feed
- Email Verification Database
-
Custom Integrations
- Getting Started
- Authentication
- Refresh Secret
- IP & Proxy Checks
- Email Verification Checks
- Phone Number Validity Checks
- Device Tracker
- List Device Trackers
- Device Tracker Statistics
- Login Tokens
- Overview Statistics
- Recent Proxy Statistics
- Recent Email Statistics
- Fraud Reporting
- Retrieve Requests by ID
- Country List API Documentation
- Release Notes
Device Tracker Statistics
Rate this article:
Select all that apply:
Email:
Fetching Device Fingerprint Statistics in Custom Integrations
This API endpoint allows you to request a list of a user's device trackers by domain, based on the Device Fingerprint service. The results include comprehensive statistics for each device tracker.
Request URL
You can use the following URL to request a list of all device trackers and statistics for each:
https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/device_tracker_statistics
Request Parameters
| Parameter | Description | Example Value / Format |
|---|---|---|
| key | Required. Your site's domain or the domain that requested this integration. | google.com |
| secret | Required. Your user's current secret created during the authentication process. | char(128) |
| domain | The domain you wish to fetch trackers for. If none is supplied all device trackers on your account will be returned. If you have a large number of device trackers it's advisable that you supply a domain to reduce query time. | yahoo.com |
| start | The start date you wish to retrieve statistics from. Must be in Year-Month-Day format. | 2025-01-01 |
| stop | The stop date you wish to retrieve statistics from. Must be in Year-Month-Day format. Can not be more than 90 days from start date. | 2025-02-01 |
| tracker_name | The tracker name you wish to fetch trackers for. Search will be done case-insensitively, but must be an exact match. If none is supplied all device trackers on your account will be returned. If you have a large number of device trackers it's advisable that you supply a tracker name to reduce query time. | Login Tracker |
Response Parameters
| Parameter | Description | Format |
|---|---|---|
| message | Description of the status of this call. May contain errors if errors exist. | text |
| success | Boolean result of if the request was successful or not. | boolean |
| device_trackers | A list of this user's device trackers based on the domain requested. | Array of objects |
device_trackers fields
| Parameter | Description | Format |
|---|---|---|
| name | A description of the device tracker in question (usually the domain, but can be changed by the user). | text |
| domain | The domain this tracker was created for. | text, domain |
| tracker | The API key for this device tracker. | text |
| usage | A list of statistics for this device tracker. total_requests Total number of device fingerprint requests. (int) high_fraud_risk_requests Total number of device fingerprint requests that were determined to be high risk. (int) recent_abuse_requests Total number of device fingerprint requests that were associated with devices that had recently been involved in abusive or malicious operations. (int) suspicious_requests Total number of device fingerprint requests that were determined to be suspicious. (int) | Array of objects |
Example Response
{
"message": "Success.",
"success": true,
"device_trackers": [
{
"name": "Octopus",
"domain": "ipqualityscore.com",
"tracker": "ft55fastrty232yefhgba",
"usage": {
"total_requests": 274094,
"high_fraud_risk_requests": 224094,
"recent_abuse_requests": 3094,
"suspicious_requests": 1102
}
}
]
}
// URL for this request.
$URL = 'https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/device_tracker_statistics';
// Configuration items for this request. NOTE: $secret will be user specific not application specific.
$key = 'example.com';
$secret = 'YOUR_API_KEY_HERE';
// Prepare POST fields.
$fields = array(
'secret' => $secret,
'key' => $key
);
// Create CURL.
$curl = curl_init();
// Configure CURL
curl_setopt($curl, CURLOPT_URL, $URL);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_POST, 1);
// Set POST Parameters
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($fields));
// Fetch URL
$result = curl_exec($curl);
// GET response code.
$response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
// Close CURL
curl_close($curl);
// Handle result.
if((int) $response_code === 200){
// JSON Decode
$output = json_decode($result, true);
// Do something with the response.
} else {
echo "There appears to be an unforeseen error. Please contact IPQualityScore support if this persists.";
}