It's a simple HTTP GET request with three parameters:
1. Your unique (and secret) API key
2. The mode of te response you want. It must be 'json' or 'single'
(without quotes)
3. The emal to be verified
Examples:
For json response: https://bounceremove.gq/api/?apikey=YOURAPIKEY&mode=json&email=examplemail@exampleserver.com
The above request would yield the following response:
{
"address": "examplemail@exampleserver.com",
"account": "examplemail",
"domain": "exampleserver.com",
"status": "valid" (this should be 'valid','invalid','role','suspicious','spamtrap','catch-all','complaint'
or 'invalid')
}
* "status" can also return 'invalidkey' for invalid API key and 'nocredit' if you have no credit.
For single status: https://bounceremove.gq/api/?apikey=YOURAPIKEY&mode=single&email=examplemail@exampleserver.com
The above request should return one single word (one of
this): 'valid','invalid','role','suspicious','spamtrap','catch-all','complaint'
or 'invalid'
* It also can return 'invalidkey' for invalid API key and 'nocredit' if you have no credit.
We recommend to send messages only to valid emailsFor testing purposes (you don't need
credit) you should use email sandbox@bounceremove.gq
The above email will return always valid.
You should use
the email fakemail@bounceremove.gq
and will return always invalid
* sandbox@bounceremove.gq
and fakemail@bounceremove.gq
does not receive messages - it's used for testing purposes only.
<?php
//set your api key, return mode and email to be verified
$apikey = 'Your secret API key';
$returnmode = 'json';
$emailtobechecked = 'examplemail@exampleserver.com';
// use curl to make the request
$url = 'https://bounceremove.gq/api/?apikey='.$apikey.'&mode='.$returnmode.'&email='.urlencode($emailtobechecked);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch , CURLOPT_SSL_VERIFYPEER , false );
curl_setopt($ch , CURLOPT_RETURNTRANSFER , 1 );
$ret = urldecode(curl_exec($ch));
curl_close($ch);
//decode the json response
$json = json_decode($ret, true);
?>
Try
Dim apiKey as string = "Your secret key"
Dim emailtobechecked as string = "examplemail@exampleserver.com"
Dim returnmode as string = "json"
Dim responseString as string = ""
Dim apiURL as string =
"https://bounceremove.gq/api/?apikey=" & apiKey &
"&mode=" & returnmode & "&email=" &
HttpUtility.UrlEncode(emailtobechecked)
Dim request As HttpWebRequest = DirectCast(WebRequest.Create(apiURL),
HttpWebRequest)
request.Timeout = 150000
request.Method = "GET"
Using response As WebResponse = request.GetResponse()
response.GetResponseStream().ReadTimeout = 20000
Using ostream As New StreamReader(response.GetResponseStream())
responseString = ostream.ReadToEnd()
End Using
End Using
Catch ex as exception
'Errors will be shown here'
End Try
try {
string apiKey = "Your secret key";
string emailtobechecked = "examplemail@exampleserver.com";
string returnmode = "json";
string responseString = "";
string apiURL = "https://bounceremove.gq/api/?apikey=" + apiKey + "&mode=" +
returnmode + "&email=" + HttpUtility.UrlEncode(emailToValidate);
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(apiURL);
request.Timeout = 150000;
request.Method = "GET";
using (WebResponse response = request.GetResponse()) {
response.GetResponseStream().ReadTimeout = 20000;
using (StreamReader ostream = new StreamReader(response.GetResponseStream()))
{
responseString = ostream.ReadToEnd();
}
}
} catch (exception ex) {
//Errors will be shown here
}
url = "https://bounceremove.gq/api/"
apikey = "Your secret key"
email = "examplemail@exampleserver.com"
returnmode = "json"
params = {"email": email, "mode": returnmode, "apikey": apikey}
response = requests.get(url, params=params)
# Returned json
print json.loads(response.content)
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class MyClass {
public static void main(String[] args){
String key = "Your secret key";
String email = "examplemail@exampleserver.com";
String returnmode = "json";
String targetURL = "https://bounceremove.gq/api/?apikey="+key+"&mode="+returnmode+"&email="+email;
HttpURLConnection connection = null;
final String USER_AGENT = "Mozilla/5.0";
try {
URL url = new URL(targetURL);
connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.addRequestProperty("User-Agent", USER_AGENT);
connection.setUseCaches(false);
connection.setDoOutput(true);
BufferedReader in = new BufferedReader(
new InputStreamReader(connection.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
//print result
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
} finally {
if (connection != null) {
connection.disconnect();
}
}
}
}
This is your secret APIkeyCopy above key for Integrations |
Password recovery |
Edit Account |
Leave Your Comment |