← Back to Scanner

THREATBYT API Documentation

Integrate real-time URL threat scanning into your applications, security bots, and chat systems.

Endpoint: Analyze URL

POST /api/analyze

// Request Body
{
  "url": "https://example-suspicious-domain.com/login",
  "forceRescan": false
}

Response Structure

{
  "success": true,
  "verdict": "SAFE" | "SUSPICIOUS" | "PHISHING",
  "riskScore": 0-100,
  "confidence": 0-100,
  "reason": "Clear explanation of findings",
  "hosting": { "isTunnel": false, "isWhitelisted": true }
}

Rate Limits & Status Codes

  • Guests (No key): 10 scans / day
  • Registered Free: 100 scans / day
  • Pro API Key: 500 scans / day
  • HTTP 200: Successful scan
  • HTTP 400: Invalid or malformed URL
  • HTTP 429: Rate limit exceeded (Retry-After header included)