RapidAPI logo

OOPSpam Spam Filter

FREEMIUM
By oopspam
Updated a month ago
7.2/10
Popularity Score
2207ms
Latency
95%
Success Rate

OOPSpam Spam Filter API Overview

OOPSpam API helps you better identify and score spam content by combining the output of various tools such as machine learning algorithm, blacklisted IPs, the number of spam words within the content, etc.

Contact API Provider
star-blueRate

How spam identified

(Scroll down for docs)

OOPSpam API allows developers to make an accurate decision based on 4 different inputs:

  • A trained machine learning algorithm check whatever the content is spam or not.
  • In case of the content sender's IP passed to the API, it will be a check against powerful, daily updated multiple blacklisted IPs that detected sending spams.
  • If you expect your content in a certain language, pass it to the API and the language detection will determine whatever it matches with your content.
  • In addition, the API scans your content for a pattern of spam words.

The more information you provide to the API, the more accurate detection will be.

Use cases

  • Filter your form submissions
  • Filter forum, blog comments
  • Develop robust plugins for third-party software.

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 me [email protected]

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
{
      "sender_ip": "38.125.233.253",
      "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.",
      "content_lang" : ["en"]
}
Fields
  • sender_ip : is the IP of the original content sender. This field value will be looked up in multiple blacklisted IPs lists that previously detected sending spam.
  • content : is a content you would like to be analyzed.
  • content_lang : In what language(s) you expect the content to be?
    Pass two-letter language(s) code to the parameter as an array.

For example: If you know that you may receive content in a few languages, say English, Vietnamese, Turkish then your content_lang parameter should have JSON array with multi-languages ["en","vi", "tr"]:

{
      "sender_ip": "38.125.233.253",
      "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.",
      "content_lang" : ["en","vi", "tr"]
}

Following languages are supported:

  • af Afrikaans
  • an Aragonese
  • ar Arabic
  • ast Asturian
  • be Belarusian
  • br Breton
  • ca Catalan
  • bg Bulgarian
  • bn Bengali
  • cs Czech
  • cy Welsh
  • da Danish
  • de German
  • el Greek
  • en English
  • es Spanish
  • et Estonian
  • eu Basque
  • fa Persian
  • fi Finnish
  • fr French
  • ga Irish
  • gl Galician
  • gu Gujarati
  • he Hebrew
  • hi Hindi
  • hr Croatian
  • ht Haitian
  • hu Hungarian
  • id Indonesian
  • is Icelandic
  • it Italian
  • ja Japanese
  • km Khmer
  • kn Kannada
  • ko Korean
  • lt Lithuanian
  • lv Latvian
  • mk Macedonian
  • ml Malayalam
  • mr Marathi
  • ms Malay
  • mt Maltese
  • ne Nepali
  • nl Dutch
  • no Norwegian
  • oc Occitan
  • pa Punjabi
  • pl Polish
  • pt Portuguese
  • ro Romanian
  • ru Russian
  • sk Slovak
  • sl Slovene
  • so Somali
  • sq Albanian
  • sr Serbian
  • sv Swedish
  • sw Swahili
  • ta Tamil
  • te Telugu
  • th Thai
  • tl Tagalog
  • tr Turkish
  • uk Ukrainian
  • ur Urdu
  • vi Vietnamese
  • wa Walloon
  • yi Yiddish
  • zh cn Simplified Chinese
  • zh tw Traditional Chinese
Response
{
    "Score": 4,
    "Details": {
        "isIPBlocked": true,
        "langMatch": true,
        "isContentSpam": "spam",
        "numberOfSpamWords": 1
    }
}
Fields

In case of successful request, following structured JSON will be responded:

  • Score: An number between 0-6 representing an overall spam score based on passed parameters. The higher this value, the more likely to be spam.
  • Details: A dictionary containing the result of different analyses. The dictionary contains keys: "isIPBlocked", "langMatch", "isContentSpam" and "numberOfSpamWords".
    • isIPBlocked : A boolean value representing whether the value of parameter sender_ip IP is blacklisted.
      Tip: In case this value is true which means the IP is blacklisted, then it is safe to assume that you are dealing with a spammer.
    • langMatch : A boolean value representing whether the value of parameter content_lang matches with the detected language by Language Detection algorithm.
    • isContentSpam : A string containing the result of a Machine Learning algorithm on whether the content is a spam or notspam.
    • numberOfSpamWords : A number representing a number of spam words within the content.

Limitations

  • Currently, only English language supported for Machine Learning content spam analyses.

Tips

  • Responded Score parameter value ranges from 0 to 6. A value 3 or above can be considered spam.
  • In the case of the responded isIPBlocked parameter value is true, It is safe to assume the sender is a spammer.
  • Make async HTTP request instead of sync since the system check sender_ip against multiple blacklisted IPs lists until it finds it.

Contact

Questions? Please do not hesitate to contact me via [email protected]. I'll be happy to help you.

Log inSign up

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.post("https://oopspam.p.rapidapi.com/v1/spamdetection")
.header("X-RapidAPI-Host", "oopspam.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("Content-Type", "application/json")
.send({"sender_ip":"31.184.238.111","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.","content_lang":["en"]})
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication