Spam scoring API
riffraff scores every contact-form submission your site takes. one POST in, a verdict and a score out, with the reasons spelled out. lower number, better letter.
What you get
01
POST JSON to /api/evaluate. you get a verdict and a score back. that’s the whole API.
02
every flag ships with a plain-english explanation. no opaque ML. reply to legitimate messages with confidence.
03
install the addon, paste a token, done. submissions get scored automatically and spam is stored with its reasons.
How it works
send the contents of the form. we send back a verdict. what you do with it — deliver, drop, queue for review — is up to you.
Request
01POST /api/evaluate
Authorization: Bearer <your-token>
{
"email": "[email protected]",
"subject": "quick question",
"content": "Hi — do you offer…"
}Response
spam: 270 / 100{
"is_spam": true,
"score": 270,
"threshold": 100,
"reasons": [
"Spam phrases detected: \"business proposal\"",
"Non-professional email domain",
"Bot-generated name pattern"
]
}Pricing
every plan includes the full API, plain-english reasons, and the statamic addon. pick a monthly allowance that matches your traffic.
free
1,000 evaluations / month
£19.00/mo
25,000 evaluations / month
£99.00/mo
250,000 evaluations / month
Need more than the pro allowance? Get in touch and we’ll size something up.
one API call. no configuration. free tier, no card.