Feature

Spam Detection API Service

In the digital age, where content is king, the influx of spam hinders genuine user experience and interferes with business growth. Recognizing the need for a robust and integrated solution, Backendless implemented an API service dedicated to detecting spam in supplied content. Tailored for Backendless developers, this service is a blend of technical prowess and business acumen, ensuring applications remain spam-free while aligning with business goals. The service provider is OOPSpam, an expert in spam detection technologies.

Technical Capabilities

Advanced Algorithms:
At its core, the spam detection service employs state-of-the-art algorithms trained on vast datasets, ensuring high accuracy in spam recognition.
Dynamic Learning:
With a commitment to continuous improvement, the service is built to evolve. By harnessing user feedback through the reportSpamDetection method, it refines its detection techniques, reducing false positives and negatives.
Seamless Integration:
Designed for Backendless developers, the API easily integrates with existing apps, offering a smooth transition and requiring minimal setup.

Usage Examples and Use-Cases

Content Platforms:
For blogging sites or content-rich platforms, the API ensures that comments, reviews, or user-generated articles are free from spam, maintaining platform integrity.
E-Commerce:
On e-commerce platforms, product reviews are vital for trust. The API can sift through thousands of reviews, flagging any suspicious content.
Forums and Social Networks:
Create a spam-free community where genuine discussions thrive without the noise of unwanted spam messages.

Backendless spam detection API service is not just a technical tool but a business asset. It safeguards user trust, enhances platform credibility, and ensures that genuine content gets the spotlight it deserves. Developers and businesses can now confidently move forward, knowing that they have a vigilant guard against spam, tailored just for them.

Installation Instructions

Login to Backendless Console and select your app. Open the Marketplace screen, select the API Services section, and install the Spam Detection Service.
During the installation, you are prompted to enter your OOPSpam API Key. (you need to create an account and log in to the OOPSpam dashboard to get your key). Enter the required details and click the Save button:
To verify the installation, click the Cloud Code icon in the Backendless Console and confirm that the OOPSpamDetector API service appears in the list of services:
If you need to change any of the configuration settings (API key, OpenAI audio model, or the default folder for the audio files), click the gear icon to access the Service Configuration popup.

Service Methods

getSpamDetectionScore

The method analyses given parameters and returns an overall spam score. The returned score is a value between 0 and 6 representing. The higher this value, the more likely the content is spam. While it depends on the use case, the returned score of 3 or higher can be considered spam.

Method:

GET

Endpoint URL:

https://xxxx.backendless.app/api/services/OOPSpamDetector/getSpamDetectionScore

The xxxx.backendless.app is a subdomain assigned to your application. For more information, see the Client-side Setup section of the Backendless documentation.

Request Headers:

Content-Type:application/json

Request URL Parameters:

Parameter name	Required/Optional	Default value	Description
`content`	Required		A content you would like to be analyzed.
`senderIP`	Optional		The IP address of the original content/message sender (NOT your IP address). This field value will be looked up in multiple IP denylists that previously detected sending spam. Although `senderIP` is an optional field, it is recommended to send it.
`email`	Optional		The email address of the original content/message sender (NOT your email address). This field value will be looked up in multiple email denylists that previously detected sending spam. Although `email` is an optional field, it is recommended to send it.
`checkForLength`	Optional	`true`	If the content is shorter than 20 characters, it will be considered spam (`Score: 5`) and returns `isContentTooShort: true`.
`urlFriendly`	Optional	`false`	Treat the `content` parameter as more link-friendly and reduce the impact of links on the spam score.
`allowedLanguages`	Optional		Must be a JSON array of string values. Allows blocking content based on content language. Specify in what language(s) you expect the content to be by passing a string of a two-letter language(s) code to the parameter as an array.
`allowedCountries`	Optional		Must be a JSON array of string values. Allows content only from a certain country or countries. Specify the allowed countries as the two-letter country codes in the array.
`blockedCountries`	Optional		Must be a JSON array of string values. Blocks content from a certain country or countries. Specify the countries to block as the two-letter country code in the array.

Request Body:

N/A – since this is a GET request, the request body is empty.

Response Body:

Returns an object with a spam-detection summary of the content. The primary property is Score which contains a number between 0 and 6. The higher this value, the more likely the content is spam. While it depends on the use case, the returned score of 3 or higher can be considered spam.

Example:

curl -X "GET" "https://www.backendless.us/api/services/OOPSpamDetector/SpamDetectionScore?content=Dear%20Agent%2C%20We%20are%20a%20manufacturing%20company%20which%20specializes%20in%20supplying%20Aluminum%20Rod%20with%20Zinc%20Alloy%20Rod%20to%20customers%20worldwide%2C%20based%20in%20Japan%2C%20Asia.%20We%20have%20been%20unable%20to%20follow%20up%20payments%20effectively%20for%20transactions%20with%20debtor%20customers%20in%20your%20country%20due%20to%20our%20distant%20locations%2C%20thus%20our%20reason%20for%20requesting%20for%20your%20services%20representation.&senderIP=185.234.219.246&email=testing%40example.com&checkForLength=false&urlFriendly=false&allowedCountries=%5B%20%20%20%20%20%20%20%20%20%22it%22%2C%20%20%20%20%20%20%20%20%20%22us%22%20%20%20%20%20%5D&blockedCountries=%5B%20%22ru%22%20%5D" \
	-H 'Content-Type: application/json' \
	-H 'Accept: application/json'

Response:

For a complete list of supported response body parameters, see the OOPSpam API documentation.

{
  "Score": 3,
  "Details": {
    "isEmailBlocked": false,
    "isContentSpam": "spam",
      "spamWords": [
        "dear",
        "winner",
        "winner",
        "$",
        "million",
        "$",
        "million",
        "watch",
        "here",
        "watch"
      ],
    "numberOfSpamWords": 19
  }
}

Codeless Reference

reportFalseSpamDetection

You can use this method to report any false positives and false negatives to OOPSpam. All the submissions will be available on OOPSpam Dashboard under the Reported page. The status of each report will be either Solved or Pending. OOPSpam analyzes them and improves detection for your use case. Every processed submission will be marked as Solved.

Method:

POST

Endpoint URL:

https://xxxx.backendless.app/api/services/OOPSpamDetector/reportFalseSpamDetection