# Analyze email content
Test your email content for spam triggers before sending.
Get a deliverability score (0-100, higher is better) with specific issues and suggestions for improvement.
Use this to:
- Check emails before sending campaigns
- Improve inbox placement rates
- Identify problematic content patterns
Rate Limit: Subject to monthly quota (default: 1000 checks/month)
Endpoint: POST /api/content-score
Version: 1.0.0
Security: BearerAuth
## Request fields (application/json):
- `subject` (string, required)
Email subject line
Example: "Your Monthly Newsletter"
- `html` (string)
HTML email content
Example: "Hello!
Check out our latest updates...
"
- `text` (string)
Plain text email content
Example: "Hello! Check out our latest updates..."
## Response 200 fields (application/json):
- `status` (string)
Enum: "ok", "error"
- `score` (integer)
Content score (0-100, higher is better)
- `risk_level` (string)
Risk level assessment
Enum: "low", "medium", "high", "critical"
- `matches` (array)
- `matches.rule_code` (string)
- `matches.severity` (string)
Enum: "low", "medium", "high", "critical"
- `matches.category` (string)
- `matches.message` (string)
- `matches.location` (string)
Enum: "subject", "html", "text"
- `suggestions` (array)
Actionable suggestions to improve score
- `usage` (object)
- `usage.used` (integer)
- `usage.limit` (integer)
- `usage.period` (string)
## Response 400 fields (application/json):
- `status` (string)
Example: "error"
- `error` (string)
Example: "invalid_request"
- `message` (string)
Example: "Subject, HTML, or text is required."
## Response 401 fields (application/json):
- `status` (string)
Example: "error"
- `error` (string)
Example: "unauthorized"
- `message` (string)
Example: "Authentication required. Use \"Authorization: Bearer \" header."
## Response 403 fields (application/json):
- `status` (string)
Example: "error"
- `error` (string)
Example: "account_suspended"
- `message` (string)
## Response 429 fields (application/json):
- `status` (string)
Example: "error"
- `error` (string)
Example: "spam_check_quota_exceeded"
- `message` (string)
Example: "You have reached your monthly spam check limit."
- `usage` (object)
- `usage.used` (integer)
- `usage.limit` (integer)
- `usage.period` (string)
## Response 500 fields (application/json):
- `status` (string)
Example: "error"
- `error` (string)
Example: "internal_error"
- `message` (string)