Developer API Integration

TrafficDam provides an ultra-low latency REST API for developers and platforms to query IP threat intelligence, VPN/proxy status, and fraud risk scores programmatically.

Authentication

All API requests must include your API Key passed as a Bearer Token in the Authorization header:

Authorization: Bearer YOUR_API_KEY_HERE

You can generate and revoke API keys anytime from your Developer Console.

IP Threat Intelligence Endpoint

Example Request (cURL)

curl -X GET "https://www.trafficdam.com/api/v1/ip/185.220.101.5" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Example Request (Node.js Fetch)

const response = await fetch("https://www.trafficdam.com/api/v1/ip/185.220.101.5", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY_HERE",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data.security.is_vpn); // true / false

Example Request (Python requests)

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY_HERE",
    "Accept": "application/json"
}
res = requests.get("https://www.trafficdam.com/api/v1/ip/185.220.101.5", headers=headers)
print(res.json())

Response Schema

A successful request returns HTTP 200 with complete geographic, network, and security data:

{
  "status": "success",
  "ip": "185.220.101.5",
  "ip_version": 4,
  "country": "DE",
  "city": "Frankfurt",
  "region": "Hesse",
  "asn": "AS206238",
  "organization": "Freedom Technologies",
  "network_type": "datacenter",
  "security": {
    "is_vpn": true,
    "is_proxy": false,
    "is_tor": true,
    "is_datacenter": true,
    "is_threat": true,
    "bot_risk": "high",
    "threat_score": 95,
    "trust_score": 10
  },
  "meta": {
    "engine": "TrafficDam Threat Network v1",
    "latency_ms": 4.12,
    "remaining_api_credits": 4999
  }
}

Credits & Metering

• 1 API Query = 1 API Credit. Only successfully analyzed queries deduct from your balance.
• Credits never expire. Top up additional credits anytime on your Credit Wallet.