Email Spam Checker API.

Create a spam test over REST, send your email to the address it returns, and read back a 0 to 100 score with every check behind it as JSON.

curl -X POST https://api.unspam.email/ext/v2/spam-check \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# returns the test id and the address to send to
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# send your email to that address, then read the result
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "status": "completed",
  "score": 85,
  "sender": "you@yourdomain.com",
  "sender_ip": "192.0.2.1",
  "results": [
    { "id": "spf", "value": [ ... ] },
    { "id": "dkim", "value": [ ... ] },
    { "id": "ip_blacklist", "value": [ ... ] }
  ],
  "report_url": "https://unspam.email/results/2Bl8rzTFN6VV"
}
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV/heatmap \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "focus": { "desktop": { "url": "https://…/focus.png", "status": "completed" } },
  "attention": { "desktop": { "url": null, "status": "pending" } }
}
Endpoints
6
Check types on every test
17
Authentication
Bearer token
Rate limit
100 a minute

Why teams ship Unspam as their spam-check API.

Async create-then-read flow.

POST creates a test and hands back a unique inbox address. Send your real email there from your existing infrastructure, then GET the result, so what gets scored is the message your platform really sends.

0 to 100 score plus sender + auth detail.

Every completed test returns the score, the sender host, sender IP and message ID, and a results[] array covering 17 check types, from SPF, DKIM and DMARC to blocklists, SpamAssassin and broken links. One read covers the whole verdict.

Screenshots, client previews, and AI heatmaps in-line.

/screenshots returns desktop, tablet and mobile renders of the test, and /heatmap returns AI focus and attention maps for desktop. Pass the same test id to POST /client-previews to render the email in 60+ real clients and devices.

Every API test, listed and paginated.

GET /spam-check?page=N&per_page=15 returns the running and completed tests you created through the API, with id, status, score, timestamps and the hosted report_url. Show past results in your own dashboard without running the test again.

What every spam-check returns.

A 0 to 100 deliverability score, the per-check breakdown that drives it, and visual + AI extras for QA pipelines.

A single 0 to 100 score for the deliverability hop.

The score field is an integer from 0 to 100 that rolls every signal (authentication, content, blocklists, headers) into one number a CI step can branch on. Unspam reports read 90 to 100 as excellent, 70 to 89 as solid, 50 to 69 as at risk and 0 to 49 as high risk, and they count a failed SPF, DKIM or DMARC check as high risk whatever the number says, so branch on results[] too.

Pair with report_url if your humans need the full visual breakdown; both fields land in the same response.

Inbox
85/100
0: spam 100: clean

A per-check breakdown in the same payload.

The results[] array lists every check the engine ran: spf, dkim, dmarc, bimi, ip_blacklist, domain_blacklist, spamassassin, subject_line, html_best_practice, broken_links and more. Each entry has a stable id and the signals behind it, each with its own status.

No separate endpoint to pull check-by-check verdicts. One GET, the whole story.

  • SPF Check spf
  • DKIM Check dkim
  • DMARC Check dmarc
  • Subject line subject_line
  • Broken links broken_links
  • HTML best practice html_best_practice

Screenshots and AI heatmaps on the same test.

GET /spam-check/{id}/screenshots returns image URLs for desktop, tablet and mobile renders of your email, with null for any device still in progress. Drop them into your CI artifacts or your sender dashboard with no further processing.

GET /spam-check/{id}/heatmap returns AI-generated focus and attention heatmaps for desktop, each with a url and a status, so you can see where readers will look before you ship the next send.

Desktop
Tablet
Mobile

How the API works in four steps.

The spam-check API is asynchronous: you create a test, send your email to the inbox address we return, then read the verdict.

  1. 01

    Create a spam-check

    POST /ext/v2/spam-check with your bearer token. The 201 response hands back a test id and a unique inbox_address.

  2. 02

    Send your email to the inbox address

    From your transactional pipeline, marketing platform, or a CI step. The message routes through our spam-check engine, which holds it for analysis.

  3. 03

    Read the verdict

    GET /ext/v2/spam-check/{id} moves from pending_inbox_message through spam_check_running to completed, with the score, sender details and results[]. Poll on a back-off or wire it to a job worker, and stop on error or outdated as well.

  4. 04

    Pull screenshots, previews, and heatmaps (optional)

    /spam-check/{id}/screenshots for the three device renders, /spam-check/{id}/heatmap for AI focus and attention maps on desktop, and POST /client-previews with the same test id for the email in 60+ real clients (see the email preview API). Each draws on its own allowance: screenshots and the heatmap spend one unit the first time you request them, and a preview request spends one device preview for each device it renders. Requesting the heatmap before the screenshots also spends a screenshot unit, because the heatmap is drawn on the desktop screenshot.

The endpoints behind it.

6 endpoints, on the same token as the rest of the API. The OpenAPI document has every parameter and response code.

OpenAPI document
Spam Check 5 calls
  • GET /spam-check
  • POST /spam-check
  • GET /spam-check/{id}
  • GET /spam-check/{id}/heatmap
  • GET /spam-check/{id}/screenshots
Account 1 call
  • GET /status

Frequently asked questions about the API.

Integration, billing, rate limits, and what the spam-check endpoint returns.

How do I get API access?
API access is included with the Custom plan, which you buy online: pick the monthly volume of each test on the pricing page, from a $5 minimum, and the rates drop as you grow. You can build it into your own product and resell it under your own brand. For anything else, open a support ticket.
What are the rate limits?
The public limit is 100 requests per minute per IP or per authenticated account. That covers most production traffic. If you need a higher limit, open a support ticket with your expected throughput.
How does the create-then-read flow work?
It is two calls. POST /ext/v2/spam-check returns an inbox_address; your sending platform delivers the real email to that address; then GET /ext/v2/spam-check/{id} returns the verdict once status is completed. Back off with exponential delay or use a job worker, and stop on error or outdated as well.
Can I check my remaining quota from the API?
GET /ext/v2/status returns your email and your subscription: plan name, price, next payment date and the remaining limits (spam_checks, inbox_placements, screenshots, heatmaps, client_previews), plus the has_history, has_ai_assistant, has_api and has_mcp flags. Useful for showing usage in your own admin UI.
How accurate is the spam score?
The score reflects how our checks rate the message. Real-world delivery still depends on sending reputation, list hygiene, and recipient engagement. The API gives you the content and authentication signal, not a guarantee of inbox placement.
Can I call the API from any language?
Yes. The API is REST + JSON over HTTPS. Any HTTP client works (curl, Node, Python, Go, Ruby, PHP, …). No mandatory SDK; auth is a single Authorization: Bearer YOUR_API_TOKEN header.
Is there a sandbox or free trial?
There is no API sandbox. The Free plan runs the same tests in the dashboard, so you can judge the results before you pay, and the Custom plan starts at $5 a month with a 14-day refund, so a real API pilot is cheap to try.
Can I build this into my own product and resell it?
Yes, on the Custom plan. Every spam test comes back as JSON with its score and per-check results, so you can show it in your own interface and resell it to your clients under your own brand.

Ready to wire Unspam into your stack?

API access is included with the Custom plan, bought online from a $5 monthly minimum. Build it into your own product and resell it under your own brand.