skip to Main Content
Data-quality - Qualifiez votre liste d'adresses email et améliorez votre délivrabilité.

L’URL pour interroger l’API est :

 https://app.cleanmylist.email/_api/request.php?email=[email]&test=[test]&api_key=[api_key]

Un quota d’utilisation est en place, si vous effectuez des requêtes en boucle, appliquez une temporisation de 300ms entre chaque requête.

[api_key] est à remplacer par votre clé API
Elle est disponible dans votre espace membre (Menu déroulant en hait à droite : Gestion du compte > API)

[email] est à remplacer par l’adresse email à tester

[test] = 0 pour ne pas faire de test d’envoi
ou 1 pour faire une simulation d’envoi.
La valeur [test]=1 allonge le temps de réponse.

Le retour est au format JSON

Exemple :
{‘quota’:’461774′,’score’:55,’email’:’nadine@sxtxuxoxe.fr’,’valid’:true,’last_delivery’:’2018-11-26 08:10:50′}

Variables disponibles dans la réponse : 

Certaines valeurs ne sont pas toujours présentes. Dans ce cas elles sont indiquées comme « (optionnel) ».
Les dates sont au format SQL : yyyy-MM-DD HH:mm:ss

quota : le crédit restant sur votre compte
Si vous utilisez l’API sur un site, nous vous conseillons de paramétrer une alerte quand le quota devient bas.

email : l’email testé

error (optionnel) : si présent, explique pourquoi l’email ne semble pas valide
Valeurs possibles : NODOMAIN, NOMX, hard_bounce, test_ko (simulation d’envoi échouée)

valid : validité de l’adresse email
Valeurs possibles :
« true » =  l’email est à priori viable.
« false » = l’email ne peut pas fonctionner

risk (optionnel) : présent s’il y a un risque quelconque à utiliser cette adresse email
Valeurs possibles :
Il y a différentes valeurs possibles :
« role » , « spam_reporter » (reporte aux organismes antispam), « abuse_reporter » (reporte aux boucles de rétroaction antispam)

abuse (optionnel) : si présent, la valeur est « true » . Cette adresse email a généré plusieurs plaintes aux services abuse

last_activity (optionnel) : date de dernière activité détectée. Si non vide, cela donne la date de dernière activité de l’adresse (ouverture ou clic). C’est avec cette valeur qui permet de qualifier les actifs et segmenter la base : actifs de moins de 6 mois, un an, etc…

last_delivered (optionnel) : date la plus récente à laquelle un email a bien été délivré à cette adresse.

hard_bounce_detected (optionnel) : date de détection NPAI hard. Présent uniquement si « error » vaut « hard_bounce »

spamtrap (optionnel) : si présent, la valeur est « true » , c’est une adresse piège.
spamtrap_detail (optionnel) : si spamtrap est à « true » , cette variable donne le détail

score : un nombre entre 0 et 100
Plus le score est haut, plus l’adresse email est susceptible d’être valide et active. A l’inverse, un score bas indique une adresse erronée, inactive ou problématique.
Pour des opérations de marketing nous vous conseillons d’écarter toutes les adresses ayant un score strictement inférieur à 50.
Pour de la validation d’adresse à la volée, lors d’une inscription sur un site par exemple, nous vous conseillons de régler ce seuil à 30.

Back To Top