Skip to main content
POST
https://api.chainguardai.dev
/
v1
/
scan
/
url
curl --request POST \
  --url https://api.chainguardai.dev/v1/scan/url \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "url": "https://app.uniswap.org",
    "chain": "ethereum",
    "options": {
      "includeContent": true,
      "includeWhois": true
    }
  }'

{
  "success": true,
  "data": {
    "url": "https://app.uniswap.org",
    "riskScore": 5,
    "riskLevel": "safe",
    "threats": [],
    "details": {
      "domainAge": 1847,
      "sslStatus": "valid",
      "redirectCount": 0,
      "finalUrl": "https://app.uniswap.org",
      "ipAddress": "104.18.24.35"
    },
    "recommendation": "PROCEED"
  },
  "meta": {
    "requestId": "req_7xk9m2n4p5q8r1s3",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 234
  }
}
Analyze any URL for potential security threats including phishing, malware, and suspicious content.

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer cg_live_xxxxxxxx

​
Body Parameters

​
url
string
required
The URL to scan. Must be a valid HTTP/HTTPS URL.Example: https://suspicious-site.com/login
​
chain
string
default:"ethereum"
Blockchain context for dApp analysis.Options: ethereum, bsc, polygon
​
options
object
Scan configuration options.

​
Response

​
url
string
The scanned URL (may differ from input due to redirects)
​
riskScore
integer
Overall risk score from 0-100. Higher = more risky.
​
riskLevel
string
Risk classification: safe, low, medium, high, critical
​
threats
array
List of detected threat types.Possible values: phishing, malware, scam, suspicious, new_domain, typosquat, invalid_ssl
​
details
object
Detailed scan results.
​
recommendation
string
Action recommendation: PROCEED, CAUTION, AVOID, BLOCK
curl --request POST \
  --url https://api.chainguardai.dev/v1/scan/url \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "url": "https://app.uniswap.org",
    "chain": "ethereum",
    "options": {
      "includeContent": true,
      "includeWhois": true
    }
  }'

{
  "success": true,
  "data": {
    "url": "https://app.uniswap.org",
    "riskScore": 5,
    "riskLevel": "safe",
    "threats": [],
    "details": {
      "domainAge": 1847,
      "sslStatus": "valid",
      "redirectCount": 0,
      "finalUrl": "https://app.uniswap.org",
      "ipAddress": "104.18.24.35"
    },
    "recommendation": "PROCEED"
  },
  "meta": {
    "requestId": "req_7xk9m2n4p5q8r1s3",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 234
  }
}