Notron API | Developer Portal

POST/v1/check

Analyze content (URL, SMS, email or phone number) and return a verdict with risk score.

Request

curl -X POST https://api.notron.eu/v1/check \
  -H "X-API-Key: ntron_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "https://bnp-secure.xyz/login",
    "type": "url"
  }'

Request Body

JSON object with the following fields:

contentstringrequired

The content to analyze. Can be a URL, SMS, email, or phone number.

typestring

Content type. If omitted, the API auto-detects.

"url""sms""email""phone"

metadataobject

Additional metadata to enrich analysis (optional).

Content Types

url

URLs and links. Analyzes domain, SSL, site age, etc.

Ex: https://suspicious.xyz

sms

SMS messages. Detects phishing patterns.

Ex: Your package is waiting...

email

Email content. Analyzes text, links, patterns.

Ex: Urgent: Verify your account...

phone

Phone numbers. Checks community reports.

Ex: +33612345678

Response

{
  "id": "chk_abc123def456",
  "verdict": "dangerous",
  "risk_score": 92,
  "confidence": 0.95,
  "scam_type": "phishing",
  "threats": ["fake_domain", "brand_impersonation", "recently_created"],
  "analysis": {
    "content_type": "url",
    "domain": "bnp-secure.xyz",
    "domain_age_days": 3,
    "ssl_valid": false,
    "brand_targeted": "BNP Paribas",
    "community_reports": 47
  },
  "recommendation": "Do not click. Fraudulent site impersonating BNP Paribas.",
  "analysis_time_ms": 234,
  "cached": false
}

Verdicts

0-30

safe

Safe content. No threats detected.

31-70

suspicious

Suspicious content. Caution recommended.

71-100

dangerous

Confirmed scam. Do not interact.

Try it

API Key

Request Body

Caching

Results are cached for 24 hours. Analyzing the same content again returns cached: true and doesn't count against your quota.

Questions? api@notron.eu