IPInfo.io Setup Guide

IPInfo.io is a foundational component of the Preads Platform's network intelligence suite. While other providers specialize in aggressive fraud detection, IPInfo.io is the industry leader in high-volume geolocation and ISP classification, offering the most generous free tier in the ecosystem.

🚀 Activation & Token Management

The platform supports both anonymous and token-authenticated IPInfo lookups.

1. Register for API Access

  1. Visit IPInfo.io to create a free account.
  2. Obtain your Access Token from the dashboard.
  3. The free tier provides 50,000 queries per month, making it the primary choice for geolocation-heavy traffic.

2. Configure in Admin Panel

Navigate to Admin → Security → Anti-Cheat → API Keys → IPInfo.io.

  • API Token: Paste your token. (Optional: Leave empty for 1,000/day IP-based limit).
  • Enabled: Toggle the switch to ON.
  • Test API: Click the Test API button to verify your token and check current quota availability.

🛡️ Detection Intelligence

The Preads Platform employs an intelligent inference engine to extract fraud signals even from IPInfo's standard geolocation response.

Intelligent Infrastructure Inference

Because standard IPInfo plans may not include the dedicated "Privacy" dataset, the IpIntelligenceService performs real-time keyword analysis on the org (Organization) field:

  • Keyword Audit: If the organization contains terms like hosting, datacenter, cloud, or vps, the platform automatically flags is_hosting and is_datacenter.
  • Risk Weighting: IPs identified via this inference engine are assigned a Risk Score of 50, triggering secondary auditing layers.

Standard Geolocation Flags

IPInfo provides the high-fidelity source for the following platform data:

  • Country Code: Surgical identification of user country for regional offer targeting.
  • Carrier/ISP Identification: Precise mapping of the user's internet service provider.
  • ASN Mapping: Identification of the Autonomous System Number associated with the connection infrastructure.

⚡ Performance Optimization

The Geolocation Primary

In the platform's Smart Priority Chain, IPInfo is positioned as the Geolocation Specialist. It is often used as the final fallback or the primary source for non-fraud metadata because:

  1. It handles extreme volume without depleting high-cost fraud credits.
  2. It provide the fastest response times for simple geographic lookups.

High-Volume Caching

By default, the platform caches IPInfo results for 24 hours. For networks primarily using IPInfo for geographic targeting (where data is very stable), administrators may choose to increase the Cache TTL via the Admin Panel to further extend the 50,000 monthly query limit.

💰 Operational Scale

Feature Details
Free Tier 50,000 checks/month (The best free value in the industry).
Best For Geolocation, ISP identification, and high-volume background auditing.
Paid Upgrade Unlock the privacy object for direct VPN/Proxy identification flags.

Return to Anti-Cheat Overview →