(Scroll down for docs)

If you are looking for a direct way to consume OOPSpam API, try OOPSpam Dashboard.
API Reference: https://oopspam.com/docs

OOPSpam Anti-Spam API provides high accuracy based on different inputs:

• Spam score
• Machine Learning models
• Multiple blocklisted IPs lists
• Language outlier detection algorithm
• Advanced content analysis
• Spam word pattern detection
• Country Restrictions

…and many custom rules.

The value we bring:

• High accuracy
• Privacy-friendly (GDPR compliant)
• Based on the latest academic research
• Use one API key with unlimited websites

We also have a WordPress plugin: https://wordpress.org/plugins/oopspam-anti-spam/.

Visit our website for more information: https://www.oopspam.com

API docs

The easiest way to get started is via OOPSpam’s RapidAPI page where you can get familiar with the endpoint as well as send requests without any configuration before you start integrating the API.
If you have a question or something is unclear, please do not hesitate to reach out to via contact@oopspam.com or the live chat on the OOSpam Anti-Spam API website. We’d be happy to help you.

How to use OOPSpam Spam Score

Flag a content spam solely based on Score (aka Spam Score). OOPSpam provides a spam score from 0 to 6. We recommend assuming Spam Score 3 or higher to be spam. While we recommend finding the most suitable score to fit your case, from our studies we learned that the ideal threshold is 3. Here is the rough scheme:

0 - not spam
1 - not spam
2 - could be spam. Most cases, not spam
3 - spam
4 - spam
5 - spam
6 - spam

API Reference

/v1/spamdetection (POST)

Overview

The /v1/spamdetection endpoint analyses given parameters and returns overall spam score including detailed detection results in structured JSON.

Request

{
    "senderIP": "91.203.67.110",
    "email": "testing@example.com",
    "content": "Dear Agent, We are a manufacturing company which specializes in supplying Aluminum Rod with Zinc Alloy Rod to customers worldwide, based in Japan, Asia. We have been unable to follow up payments effectively for transactions with debtor customers in your country due to our distant locations, thus our reason for requesting for your services representation.",
    "blockTempEmail": false,
    "logIt": false,
    "checkForLength": true,
    "urlFriendly": false,
    "allowedLanguages" : ["en"],
    "allowedCountries" : ["it","us"],
    "blockedCountries" : ["ru","cn"]
}

Request Body Parameters

Response Body Parameters

Following languages are supported:

You can learn more about allowedLanguages paramater in this blog post.

Error handling

A successful request will return HTTP status code 200. In case you didn’t include necessary headers in your requests such as an API key which you will get status code 401 (Unauthorized) with an explanatory message as the part of response’s body. Other possible errors can be :

• An invalid JSON format
• Generic error message

With all (error) cases, you will get a JSON object with an error code and message which looks like this:

{
    "code":"5740538",
    "message":"Invalid JSON format. Please verify and resubmit."
}

🧪 Testing

After integrating the API, you may want to test different use cases. To help you get started, here’s a table of blocked IP addresses, email addresses, and content.

💡 Tips

• Responded Score parameter value ranges from 0 to 6. Any value of 3 or higher can be regarded as spam.
• Make an async HTTP request instead of a sync one, as the system will check the sender IP against multiple IP denial lists until it finds it.

FAQ

Please check FAQ section https://www.oopspam.com/#faq.

Contact

Questions? Please do not hesitate to contact me via contact@oopspam.com or the live chat on the OOSpam Anti-Spam API website.