DetectThat API Documentation

// Node.js/Express example
app.post('/register', async (req, res) => {
  const userIP = req.ip;
  
  // Check IP risk before allowing registration
  const ipData = await detectThat.ip.lookup(userIP);
  
  if (ipData.risk_score > 70 || ipData.is_vpn) {
    return res.status(403).json({
      error: 'Registration blocked due to high risk IP'
    });
  }
  
  // Continue with normal registration
  const user = await createUser(req.body);
  res.json({ user });
});

// Python/Django example
async def process_payment(request):
    user_ip = get_client_ip(request)
    card_bin = request.data['card_number'][:6]
    
    # Parallel IP and BIN lookups
    ip_task = detectthat.ip.lookup(user_ip)
    bin_task = detectthat.bin.lookup(card_bin)
    
    ip_data, bin_data = await asyncio.gather(ip_task, bin_task)
    
    # Calculate combined risk score
    risk_factors = []
    if ip_data.is_vpn or ip_data.is_proxy:
        risk_factors.append('anonymizer')
    if ip_data.risk_score > 50:
        risk_factors.append('high_risk_ip')
    if bin_data.is_prepaid:
        risk_factors.append('prepaid_card')
    
    # Require additional verification for risky transactions
    if len(risk_factors) >= 2:
        return require_3ds_verification()
    
    return process_payment_normally()

// PHP/Laravel example
class DynamicRateLimit
{
    public function handle($request, Closure $next)
    {
        $ip = $request->ip();
        
        // Check IP reputation
        $ipData = DetectThat::ip()->lookup($ip);
        
        // Adjust rate limit based on risk
        $rateLimit = match (true) {
            $ipData->risk_score > 80 => 10,  // Very restrictive
            $ipData->risk_score > 50 => 30,  // Moderate
            $ipData->is_vpn => 20,           // VPN users get lower limits
            default => 100                   // Normal limit
        };
        
        // Apply the dynamic rate limit
        if ($this->exceedsRateLimit($ip, $rateLimit)) {
            return response('Rate limit exceeded', 429);
        }
        
        return $next($request);
    }
}

// JavaScript/React example
const ContentGate = ({ children }) => {
  const [accessAllowed, setAccessAllowed] = useState(null);
  
  useEffect(() => {
    const checkAccess = async () => {
      try {
        const response = await fetch('/api/check-access', {
          headers: {
            'Authorization': `Bearer ${apiKey}`
          }
        });
        
        const ipData = await response.json();
        
        // Block access for VPN/proxy users in restricted regions
        const isBlocked = (
          ipData.is_vpn || 
          ipData.is_proxy || 
          ['CN', 'RU', 'IR'].includes(ipData.country_code)
        );
        
        setAccessAllowed(!isBlocked);
      } catch (error) {
        setAccessAllowed(false);
      }
    };
    
    checkAccess();
  }, []);
  
  if (accessAllowed === null) {
    return ;
  }
  
  if (!accessAllowed) {
    return ;
  }
  
  return children;
};