Skip to main content
POST

Overview

The Spam Checker API scans email subject lines and content for spam trigger phrases. It returns a 0–100 spam score, a risk level classification, a full list of detected trigger words with their category and risk weight, and actionable recommendations for improving deliverability. This endpoint supports both GET and POST requests.

Request Parameters

string
required
Your ProWebLook API key. See Authentication.
string
The email subject line to analyze. At least one of subject or content is required.
string
The email body (plain text or HTML) to analyze. At least one of subject or content is required.

Response

boolean
true if the analysis completed successfully, false if an error occurred.
object
The full spam analysis result.
integer
Your remaining spam checker credits after this request.

Spam Score Calculation

The score is derived from three factors:
  • Trigger density — weighted sum of risk_level × count across all triggers, normalized by word count
  • Category diversity — more unique trigger categories raise the score (e.g., mixing Urgency + Financial + Phishing is worse than one category alone)
  • Occurrence density — ratio of total trigger instances to total word count

Trigger Categories

Credit Cost

1 spam checker credit is deducted from your spamchecker_balance per successful request.