API v4 Released: Faster, Smarter, Unified
New unified analysis endpoint, SSE streaming, batch processing, and 3x faster response times. Migration guide included.
NSAI Team
API v4 Released: Faster, Smarter, Unified
We're excited to announce NSAI API v4 β the biggest platform update since launch. A single endpoint for all threat types, real-time streaming, and dramatically faster responses.
What's New
Unified /api/v4/analyze Endpoint
No more juggling between /api/v3/sms/check, /api/v3/crypto/analyze, and /api/v3/domain/check. API v4 introduces a single unified endpoint that auto-detects the content type:
curl -X POST https://api.noscamai.com/api/v4/analyze \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Send 0.5 ETH to 0x742d35Cc..."}'
The system automatically identifies this as a crypto-related message & runs the appropriate pipeline β text analysis, crypto wallet check, and URL extraction β all in one request.
SSE Streaming
For long-running analyses, v4 supports Server-Sent Events. Get results as they happen instead of waiting for the full pipeline:
curl -N https://api.noscamai.com/api/v4/analyze/stream \
-H "Authorization: Bearer YOUR_KEY" \
-d '{"content": "...", "stream": true}'
Events arrive in order: text_analysis β entity_extraction β crypto_check β final_verdict.
Batch Processing
Analyze up to 100 messages in a single request. Perfect for scanning message logs, email archives, or chat exports:
{
"batch": [
{"content": "Message 1...", "id": "msg-001"},
{"content": "Message 2...", "id": "msg-002"}
],
"webhook": "https://your-server.com/callback"
}
Results are delivered via webhook when the batch completes.
Performance Improvements
| Metric | v3 | v4 | Improvement |
|---|---|---|---|
| Average latency | 540ms | 180ms | 3x faster |
| P99 latency | 2.1s | 680ms | 3x faster |
| Throughput | 50 req/s | 200 req/s | 4x higher |
| Batch support | β | 100 msgs | New |
Migration Guide
Breaking Changes
- Base URL:
api.noscamai.com/api/v3/*βapi.noscamai.com/api/v4/* - Response format:
threat_levelfield renamed torisk_levelfor consistency - Auth header: now requires
Bearerprefix (v3 accepted raw keys)
Compatibility
v3 endpoints will remain available until June 2026. We recommend migrating before then.
Quick Migration
- POST /api/v3/sms/check
+ POST /api/v4/analyze
- {"message": "suspicious text"}
+ {"content": "suspicious text"}
- response.threat_level
+ response.risk_level
Try It Now
API v4 is available on all plans. Update your integration today:
Want to check a suspicious message?