DEVELOPER

API DOCS

Integrate scam detection into your applications using the ScamGuard API.

AUTHENTICATION

All API requests require an authentication header with your API key:

Authorization: Bearer sg_live_your_api_key_here

API keys are available for Premium users. Upgrade to Premium →

RATE LIMITS

PLANREQUESTS/HOURREQUESTS/DAY
FREE1050
PREMIUM1001,000

ENDPOINTS

POST/api/v1/analyze

Analyze a text message for scam attempts

REQUEST BODY (JSON)

{
  "text": "string (required)",
  "scanType": "email | sms | call | marketing_email",
  "language": "en | ro (optional)"
}

RESPONSE (JSON)

{
  "riskScore": 0-100,
  "verdict": "safe | marketing | suspicious | dangerous",
  "summary": "string",
  "detectedPatterns": [...],
  "recommendations": [...],
  "confidence": 0-100,
  "cached": boolean
}
GET/api/v1/patterns

Returns the full list of scam patterns from the database

RESPONSE (JSON)

[
  {
    "id": 1,
    "name": "string",
    "category": "string",
    "severity": "low | medium | high | critical",
    "description": "string",
    "indicators": [...],
    "isRegional": boolean
  }
]

CURL EXAMPLE

curl -X POST https://scamguard.club/api/v1/analyze \
  -H "Authorization: Bearer sg_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "URGENT: Your account has been compromised...",
    "scanType": "email",
    "language": "en"
  }'

READY TO INTEGRATE?

Get a Premium API key and start protecting your users.

GET PREMIUMAPI KEYS