Ping0 SDK - Detect proxies, VPNs & Suspicious behaviour

The official Node.js SDK for Ping0.xyz IP intelligence. Easily integrate fraud prevention, VPN detection, and geolocation restrictions into your application.

Installation

npm install ping0sdk

Quick Start

const Ping0 = require('ping0sdk');

// 1. Initialize with your RapidAPI Key (Get one at https://rapidapi.com/smstrek1/api/ping0-api)
const ping0 = new Ping0('YOUR_API_KEY', {
    rules: {
        block_vpn: true,      // Block known VPNs
        block_proxy: true,    // Block proxies
        max_risk_score: 85,   // Block IPs with risk score > 85
    }
});

// 2. Check an IP address
async function example() {
    const ip = '1.1.1.1'; // The visitor's IP
    const decision = await ping0.check(ip);

    if (decision.action === 'block') {
        console.log('Blocked:', decision.reason);
    } else {
        console.log('Allowed!');
        console.log('Location:', decision.data.location.country);
    }
}

example();

Required

| Option | Type | Description | |--------|--------|-------------| | api_key | String | Your RapidAPI key |

Rules

| Option | Type | Default | Description | |------------------------|---------|---------|-------------| | max_risk_score | Number | — | Block IPs with a risk score higher than this value (0–100) | | block_vpn | Boolean | false | Block detected VPNs | | block_proxy | Boolean | false | Block detected proxies | | block_tor | Boolean | false | Block Tor exit nodes | | allowed_countries | Array | — | Whitelist of country codes | | blocked_countries | Array | — | Blacklist of country codes |

Response Object

The check(ip) method returns a Promise that resolves to:

{
  "action": "allow" | "block",
  "reason": null | "Reason for block",
  "data": { ... } // The full JSON response from Ping0 API
}