Technical Feature Reference

Everything SpamJammer does, documented with code examples and specs. Every feature is accessible via REST API with full SDK support.

Core Engine

Adaptive ML Detection

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.

  • Transformer-based architecture (custom 125M parameter model)
  • Hourly retraining on global spam corpus
  • Multi-language support: 42 languages
  • Context-aware: analyzes headers, metadata, and content together
  • Custom model fine-tuning via POST /v1/models/train
  • Model versioning with rollback support
ml-config.json
{
  "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
  }
}
Customization

Custom Rules DSL

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.

  • JSON-based rule definitions with AND/OR/NOT operators
  • Regex pattern matching on content and headers
  • Keyword blocklist/allowlist management
  • Geo-fencing: block by country, region, or ASN
  • Rate limiting per sender, domain, or IP
  • Rule versioning with A/B testing support
  • Dry-run mode for testing rules before activation
rule-example.json
{
  "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"
}
Real-time

Webhooks & Event Streaming

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.

  • Events: spam.detected, spam.blocked, report.generated
  • HMAC-SHA256 payload signing
  • Automatic retry with exponential backoff
  • Event replay API for disaster recovery
  • Webhook test endpoint for development
  • Delivery logs with response status tracking
webhook-payload.json
{
  "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
  }
}
Scale

Batch Processing & Async Jobs

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.

  • Up to 1,000 messages per batch request
  • Async processing with POST /v1/batch
  • Progress tracking via GET /v1/batch/:id
  • Callback URL support for completion notification
  • Priority queuing for paid tiers
  • CSV/JSON export of batch results
batch-request.sh
# 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
}
Observability

Real-Time Analytics & Reporting

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.

  • Real-time metrics: volume, block rate, latency percentiles
  • Time-series data with 1-minute granularity
  • Geographic heatmap of spam origins
  • Category breakdown and trend analysis
  • Grafana plugin and Datadog integration
  • Scheduled PDF reports via email
  • CSV/JSON export via GET /v1/analytics/export
analytics-query.sh
# 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
  }
}

Endpoint Overview

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

Transparent, Developer-Friendly Pricing

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.

Starter
$29/mo
For side projects and small apps getting started with spam protection.
  • 10,000 messages/month
  • Email channel
  • Basic dashboard
  • Community support
  • 1 domain
  • 99.5% SLA uptime
  • Custom rules
  • API webhooks
  • SSO / RBAC
  • Dedicated account manager
Get Started
Enterprise
$199/mo
For teams that need unlimited scale, custom ML models, and premium SLAs.
  • Unlimited messages
  • All channels (email, form, comment, chat, SMS)
  • Real-time analytics + Grafana/Datadog
  • 24/7 support (1h response SLA)
  • Unlimited domains
  • 99.99% SLA uptime
  • Custom rules + ML model fine-tuning
  • SSO (SAML/OIDC) + RBAC
  • Custom SLA agreement
  • Dedicated account manager
Contact Sales
Feature Starter Professional Enterprise
Monthly messages 10,000 100,000 Unlimited
Channels Email 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

Start Blocking Spam in 5 Minutes

Free tier available. No credit card required. 10,000 checks/month included.

Start Building Read the Docs