Créez un test de spam via REST, envoyez votre e-mail à l’adresse de réception que nous vous renvoyons, puis récupérez en JSON un score de délivrabilité de 0 à 100, avec l’analyse de l’expéditeur, le détail de chaque vérification, des captures d’écran et des heatmaps générées par IA.
Le POST crée un test et renvoie une adresse de réception unique. Envoyez-y votre véritable e-mail depuis votre infrastructure actuelle, puis récupérez le résultat en GET. Aucune limite de payload, aucun bricolage MIME.
Chaque test terminé renvoie le score, l’hôte de l’expéditeur, son adresse IP, le message-ID et un tableau results[] avec les vérifications SPF, DKIM, DMARC et les vérifications de contenu. Une seule lecture couvre tout le verdict.
Chaque test de spam porte deux sous-ressources : /screenshots renvoie les rendus ordinateur, tablette et mobile, et /heatmap renvoie les cartes de focus et d’attention générées par IA pour ce même e-mail. Passez le même id de test à POST /client-previews pour afficher l’e-mail dans plus de 50 clients de messagerie et appareils réels.
Les tests de spam passés restent conservés. GET /spam-check?page=N&per_page=15 renvoie la liste paginée avec id, status, score, horodatages et le report_url hébergé. Intégrez l’historique des résultats à votre propre tableau de bord sans relancer le test.
Un score de délivrabilité de 0 à 100, le détail des vérifications qui le produisent, et les extras visuels et IA pour vos pipelines de QA.
Le champ score est un entier de 0 à 100 qui réunit chaque signal (authentification, contenu, listes noires, en-têtes) en un seul nombre sur lequel une étape de CI peut se brancher. Les rapports Unspam lisent 90 à 100 comme excellent, 70 à 89 comme solide, 50 à 69 comme à risque et 0 à 49 comme risque élevé, et traitent un échec SPF, DKIM ou DMARC comme un risque élevé quel que soit le chiffre : branchez-vous donc aussi sur results[].
Associez-le au report_url si votre équipe a besoin du détail visuel complet : les deux champs arrivent dans la même réponse.
Le tableau results[] énumère chaque vérification exécutée par le moteur : SPF, DKIM, DMARC, BIMI, densité de mots spam, réputation des liens, ratio image/texte et bien d’autres. Chaque entrée porte un id stable que vous pouvez rattacher à votre propre tableau de bord.
Aucun endpoint distinct pour obtenir les verdicts vérification par vérification. Un seul GET, toute l’histoire.
GET /spam-check/{id}/screenshots renvoie les URL des images pour les rendus ordinateur, tablette et mobile de votre e-mail. Déposez-les dans vos artefacts de CI ou dans votre tableau de bord d’expéditeur, sans traitement supplémentaire.
GET /spam-check/{id}/heatmap renvoie des heatmaps de focus et d’attention générées par IA sur ces mêmes trois appareils, pour voir exactement où vos lecteurs regarderont avant de lancer l’envoi suivant.
L’API de test de spam est asynchrone : vous créez un test, vous envoyez votre e-mail à l’adresse de réception que nous vous renvoyons, puis vous lisez le verdict.
POST /ext/v2/spam-check avec votre bearer token. La réponse 201 renvoie un id de test et une inbox_address unique.
Depuis votre pipeline transactionnel, votre plateforme marketing ou une étape de CI. Le message passe par notre moteur de test de spam, qui le retient pour l’analyser.
GET /ext/v2/spam-check/{id} renvoie le score, l’analyse de l’expéditeur, le message-ID et le tableau results[] dès que status passe à "completed". Interrogez l’API avec un back-off ou branchez-la sur un worker de tâches.
/spam-check/{id}/screenshots pour les rendus sur les trois appareils, /spam-check/{id}/heatmap pour les cartes de focus et d’attention par IA, et POST /client-previews avec le même id de test pour l’e-mail dans plus de 50 clients de messagerie réels (voir l’API de prévisualisation des e-mails). Chacun puise dans sa propre limite : les captures d’écran et la heatmap consomment une unité la première fois que vous les demandez, et chaque demande de prévisualisation consomme une prévisualisation d’appareil, quel que soit le nombre d’appareils. Demander la heatmap avant les captures d’écran consomme aussi une unité de captures, car la heatmap est calculée sur la capture d’écran de bureau.
Intégration, facturation, limites de requêtes et contenu renvoyé par l’endpoint de test de spam.
POST /ext/v2/spam-check renvoie une inbox_address ; votre plateforme d’envoi livre le véritable e-mail à cette adresse ; puis GET /ext/v2/spam-check/{id} renvoie le verdict dès que status === "completed". La plupart des tests se terminent en quelques secondes : espacez les appels avec un délai exponentiel ou utilisez un worker de tâches.GET /ext/v2/status renvoie votre adresse e-mail, le nom de votre abonnement et la table des limites (spam_check, inbox_placement, screenshots, heatmaps, has_history, has_ai_assistant). Pratique pour afficher la consommation dans votre propre interface d’administration.Authorization: Bearer YOUR_API_TOKEN.L’accès à l’API est inclus dans le plan sur mesure, qui s’achète en ligne à partir d’un minimum de $5 par mois. Intégrez-le à votre propre produit et revendez-le sous votre propre marque.
Voir les tarifs