« Back to the developer index

The Spam API

The spam API allows you to make your own decisions as to whether a number is spammy or not. Our results include our spam score, total number of complaints, complaints within the last 6 and 12 months, and a time-stamp of the last complaint we have found or received.

Spam Score

We are actively collecting complaints we find about phone numbers from all around in internet. Every time we find a complaint we dupe check it against our database and note down the time of the complaint. We then use a simple algorithm based on the frequency of complaints over time to calculate our spam score. The higher a spam score, the more complaints we have found recently. The algorithm we use is as follows: (min(10, total_complaints)/20*100) + (min(10, complaints_last_12_months)/40*100) + (min(10, complaints_last_6_months)/40*100). This gives a score from 0 to 100, with any 10 complaints always resulting in a score of at least 50, and requiring at least 10 complaints in the last six months to score a 100.

The request to our API is a standard HTTP GET request as follows:

Parameters

format (required)

valid options are json, xml, text

key (required)

32 characters long, provided when you join the developer program

q (required)

valid Africa phone number

Example Query Results

Text

JSON

XML