Developer · Bot API

ScamRadar Bot API

Plug scam screening into any chat workflow. One POST, back a score, reasons, and advice. Ship safer bots in under 10 minutes.

Back to app

Bearer

Authorization header

Text

Message or URL input

REST

Simple JSON in, JSON out

Request

POST /api/bot/analyze

curl -X POST https://scamradar.app/api/bot/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "Hi! I'll send a courier tomorrow. Please pay $45 shipping first via this link: https://fb-marketp1ace-delivery.co/confirm"
  }'

text - message or URL to screen

Response

200 OK

{
  "score": 94,
  "level": "High",
  "reasons": [
    "Courier fee requested before any in-person meeting",
    "Lookalike domain using digit '1' instead of 'l' in 'marketplace'",
    "Off-platform payment before exchange of goods"
  ],
  "advice": "Do not pay. Report the listing on the platform and block the buyer.",
  "source": "ai"
}

score - integer 0-100

level - Low / Medium / High

reasons - top risk signals, ranked

advice - action for the end user

Quick integrations

Telegram bot

Intercept messages with suspicious URLs, call the API, reply with risk and advice.

Telegram docs

WhatsApp Business

Hook into webhook events, screen inbound messages, and auto-warn buyers before they pay.

WhatsApp docs

Discord / Slack

Protect communities from scam DMs and drop phishing links into quarantine automatically.

Slash-command template

Private beta access

The Bot API is available for owner-managed integrations through one server-side token. Public API key dashboards, per-user quotas, and paid API plans are intentionally not advertised until they are implemented.

Auth

Bearer token

Configured in env

Endpoint

/api/bot/analyze

POST only

Billing

Contact support

No self-serve API plans yet