IP Intelligence API Usage, Risk Detection & Geo Insights

Analyze IP addresses for proxy, TOR, blacklist status, geo-location, and risk scoring using Voyant APIs. Supports single and batch lookups with secure authentication.

Try IP Intelligence Demo →

Base URL: https://api.voyantnetworks.com
Endpoints:
• /v1/intel/ip (single)
• /v1/intel/ip/batch (max 50 IPs)

Authentication

All requests must be signed using your apiSecret . Send the generated signature in request body.

• accountId
• projectId
• apiKey
• nonce (10 char random)
• timestamp
• signature
• ip / ips

⚠️ Include ip/ips in signature generation.

Official SDKs & Libraries

Use official SDKs for faster integration across platforms.

Node.js

Backend / Server-side

npm →

JavaScript (Browser)

Frontend / Web

js script →

Flutter

Mobile / Web Apps

pub.dev →

Python

Backend / ML / Scripts

coming soon

Request Flow (Pseudo)

payload = { accountId, apiKey, projectId, nonce, timestamp, ip OR ips }

stable = JSON.stringify(sorted(payload))

signature = HMAC_SHA256(stable, apiSecret)

POST → /v1/intel/ip

body:
apiKey, projectId, nonce, timestamp, signature
ip=1.1.1.1 OR ips=...

SDK Usage (Recommended)

const creds = {
  apiKey: "YOUR_API_KEY",
  accountId: "YOUR_ACCOUNT_ID",
  apiSecret: "YOUR_API_SECRET"
};

const intel = new VoyantClient.IpIntelApiClient({
  credentials: creds,
  projectId: "YOUR_PROJECT_ID"
});

// single
await intel.lookup("8.8.8.8");

// batch
await intel.lookupBatch(["8.8.8.8","1.1.1.1"]);

Single IP

POST /v1/intel/ip

ip=8.8.8.8&
accountId=...&
projectId=...&
apiKey=...&
nonce=...&
timestamp=...&
signature=...

Batch (Max 50 IPs)

POST /v1/intel/ip/batch

ips=8.8.8.8&
ips=1.1.1.1&
...
signature=...

Response Format

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "locationData": { "country": "US", "city": "Mountain View" },
    "network": { "asn": 15169, "organization": "Google" },
    "countryMeta": { "currencyName": "USD" },
    "risk": {
      "isTor": false,
      "isProxy": false,
      "blacklisted": false,
      "riskScore": 12
    }
  }
}

• Max 50 IPs in batch
• Invalid IP → request fails
• Signature required
• Rate limits apply

Next Steps

🌐 Create IP API → 📊 Manage IP API → ⚠️ View Error Codes →