API Documentation

Retrieves detailed information, proxy status, and risk analysis for a specific IP address.

Query Parameters

Parameter	Type	Required	Description
ip	string	Yes	The IPv4 or IPv6 address to verify.

Success Response (200 OK)

{
  "source": "database",  // "database" (cached) or "api" (fresh)
  "data": {
    "status": "ok",
    "8.8.8.8": {
      "asn": "AS15169",
      "range": "8.8.8.0/24",
      "hostname": "dns.google",
      "provider": "Google LLC",
      "country": "United States",
      "isocode": "US",
      "city": "Mountain View",
      "latitude": 37.422,
      "longitude": -122.085,
      "proxy": "no",
      "type": "Business",
      "risk": 0
    }
  }
}

Error Response (400 Bad Request)

{
  "status": "error",
  "message": "Missing IP parameter"
}

Integration Example (PHP)

Using the silent collector directly in your PHP scripts.

// Include this line at the top of your PHP script
include 'path/to/collect.php';

// The system will automatically detect the visitor's IP,
// check it against the database/API, and store the result.
// No output is produced.