Everything SpamJammer does, documented with code examples and specs. Every feature is accessible via REST API with full SDK support.
SpamJammer's core detection engine uses a fine-tuned transformer model
(sj-v3-turbo) trained on 2.4B+ labeled messages. The model
is retrained hourly on live spam data from the global network. Enterprise
customers can fine-tune the model on their own data via the Training API.
POST /v1/models/train{
"model": "sj-v3-turbo",
"confidence_threshold": 0.85,
"categories": [
"promotional",
"phishing",
"malware",
"scam",
"harassment"
],
"languages": "auto",
"context": {
"analyze_headers": true,
"analyze_metadata": true,
"analyze_links": true
}
}
Define blocking rules using a JSON-based domain-specific language. Rules are evaluated before and after ML scoring, giving you full control over the detection pipeline. Supports regex patterns, keyword blocklists, geographic restrictions, sender reputation checks, and header inspection.
{
"name": "block-crypto-scams",
"priority": 1,
"conditions": {
"operator": "AND",
"rules": [
{
"field": "content",
"match": "regex",
"pattern": "(crypto|bitcoin|nft).*free"
},
{
"field": "sender.reputation",
"match": "lt",
"value": 0.3
}
]
},
"action": "block"
}
Receive real-time notifications for every spam event. All webhook payloads are HMAC-SHA256 signed for verification. Failed deliveries are retried with exponential backoff (up to 72 hours). Full event replay available via API.
spam.detected, spam.blocked, report.generated{
"id": "evt_1a2b3c4d5e6f",
"type": "spam.detected",
"created_at": "2026-02-17T14:32:00Z",
"data": {
"message_id": "msg_xyz789",
"score": 0.98,
"category": "phishing",
"action_taken": "block",
"latency_ms": 23
}
}
Submit up to 1,000 messages in a single API call. Ideal for backfill operations, migration scanning, and periodic audits. Batch jobs run asynchronously with progress tracking and callback support.
POST /v1/batchGET /v1/batch/:id# Submit a batch of messages curl -X POST https://api.spamjammer.com/v1/batch \ -H "Authorization: Bearer sj_live_..." \ -d '{ "messages": [ {"id": "m1", "content": "...", "type": "email"}, {"id": "m2", "content": "...", "type": "comment"}, ... ], "callback_url": "https://yourapp.com/webhook", "priority": "high" }' # Response { "batch_id": "batch_abc123", "status": "processing", "total": 847, "eta_seconds": 12 }
Full observability into your spam pipeline. Real-time dashboards, trend analysis, geographic heatmaps, and category breakdowns. Export raw data via API or connect directly to Grafana and Datadog.
GET /v1/analytics/export# Query analytics for the last 24 hours curl -G https://api.spamjammer.com/v1/analytics \ -H "Authorization: Bearer sj_live_..." \ -d "period=24h" \ -d "granularity=1h" \ -d "metrics=volume,block_rate,p99_latency" # Response (truncated) { "period": "24h", "summary": { "total_checked": 142857, "total_blocked": 14271, "block_rate": 0.0999, "avg_latency_ms": 31, "p99_latency_ms": 87 } }
Core endpoints for the SpamJammer REST API v3. Full reference with request/response schemas available in the API docs.
| Method | Endpoint | Description | Auth | Rate Limit |
|---|---|---|---|---|
| POST | /v1/check |
Check a single message for spam | Bearer token | 1,000/min |
| POST | /v1/batch |
Submit batch of up to 1,000 messages | Bearer token | 10/min |
| GET | /v1/batch/:id |
Get batch job status and results | Bearer token | 100/min |
| GET | /v1/analytics |
Query analytics and metrics | Bearer token | 60/min |
| POST | /v1/rules |
Create a custom detection rule | Bearer token | 30/min |
| PUT | /v1/rules/:id |
Update an existing rule | Bearer token | 30/min |
| POST | /v1/webhooks |
Register a webhook endpoint | Bearer token | 10/min |
| POST | /v1/report |
Report a false positive/negative | Bearer token | 100/min |
No hidden fees. No per-seat charges. Pay for API calls and scale as you grow. All plans include full API access and official SDKs.
| Feature | Starter | Professional | Enterprise |
|---|---|---|---|
| Monthly messages | 10,000 | 100,000 | Unlimited |
| Channels | Email, Form, Comment | All (+ Chat, SMS) | |
| Detection accuracy | 99.5% | 99.9% | 99.99% |
| Custom rules | — | DSL rules engine | DSL + ML fine-tuning |
| Webhooks | — | Included | Included |
| API rate limit | 100/min | 1,000/min | Custom |
| Support | Community | Priority (24h) | 24/7 (1h SLA) |
| SSO / RBAC | — | — | SAML + OIDC |
| SLA | 99.5% | 99.9% | 99.99% + custom |
| Overage rate | $0.005/msg | $0.002/msg | Custom |
Free tier available. No credit card required. 10,000 checks/month included.