API de test de spam.

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.

POST /ext/v2/spam-check
curl -X POST https://api.unspam.email/ext/v2/spam-check \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (201)
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# now send your email to inbox_address
# from your sending platform.
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "id": "2Bl8rzTFN6VV",
  "status": "completed",
  "score": 85,
  "sender": "you@yourdomain.com",
  "sender_ip": "192.0.2.1",
  "results": [
    { "id": "spf_check", ... },
    { "id": "dkim_check", ... },
    { "id": "dmarc_check", ... }
  ],
  "report_url": "https://unspam.email/email-test/2Bl8rzTFN6VV"
}

Quatre types de requête. Une seule clé d’API.

Une seule clé couvre les quatre endpoints. Commencez par POST /spam-check pour le score, l’analyse de l’expéditeur et le détail de chaque vérification, puis réutilisez la même exécution pour envoyer aux boîtes de test, récupérer de vraies prévisualisations dans les clients de messagerie ou demander la heatmap d’attention.

Tests de spam

POST /spam-checkScore, analyse de l’expéditeur, détail de chaque vérification. Conçu pour les plateformes d’envoi et les équipes CRM.

Inbox Placement

POST /inbox-placementEnvoyez à nos boîtes de test et obtenez le dossier d’arrivée boîte par boîte (boîte de réception / promotions / spam) et l’exposition aux listes noires.

Prévisualisations dans les clients de messagerie

GET /spam-check/{id}/client-previewsVotre e-mail rendu dans plus de 50 clients de messagerie et appareils réels, en mode clair et sombre. Voir l’API de prévisualisation des e-mails.

Heatmaps d’e-mails

GET /spam-check/{id}/heatmapDes heatmaps de focus et d’attention générées par IA sur les trois tailles d’appareil.

Pourquoi les équipes retiennent Unspam comme API de test de spam.

Un flux asynchrone : créer, puis lire.

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.

Un score de 0 à 100, plus le détail expéditeur et authentification.

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.

Captures d’écran, prévisualisations et heatmaps IA intégrées.

Chaque test de spam porte trois sous-ressources : /screenshots renvoie les rendus ordinateur, tablette et mobile, /client-previews affiche l’e-mail dans plus de 50 clients de messagerie et appareils réels, et /heatmap renvoie les cartes de focus et d’attention générées par IA pour ce même e-mail.

Chaque test conservé et paginé.

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.

Ce que renvoie chaque test de spam.

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.

01

Un score unique de 0 à 100 pour l’étape de délivrabilité.

Le champ score réunit chaque signal (authentification, contenu, listes noires, en-têtes) en un seul nombre sur lequel une étape de CI peut se brancher. À partir de 80, tout est sain ; de 50 à 70, c’est risqué ; sous 50, l’e-mail finit probablement dans les spams.

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.

BOÎTE DE RÉCEPTION
85/100
0 : spam 100 : propre
02

Le détail de chaque vérification dans le même payload.

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.

  • Vérification SPF spf_check
  • Vérification DKIM dkim_check
  • Vérification DMARC dmarc_check
  • Mots spam spam_words
  • Réputation des liens link_rep
  • Ratio image / texte img_ratio
03

Captures d’écran et heatmaps IA sur le même test.

GET /spam-check/{id}/screenshots renvoie les URL du CDN 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.

ordinateur
tablette
mobile

Le fonctionnement de l’API en quatre étapes.

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.

  1. 01

    Créer un test de spam

    POST /ext/v2/spam-check avec votre bearer token. La réponse 201 renvoie un id de test et une inbox_address unique.

  2. 02

    Envoyer votre e-mail à l’adresse de réception

    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.

  3. 03

    Lire le verdict

    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.

  4. 04

    Récupérer captures d’écran, prévisualisations et heatmaps (facultatif)

    /spam-check/{id}/screenshots pour les rendus sur les trois appareils, /spam-check/{id}/client-previews pour l’e-mail dans plus de 50 clients de messagerie réels (voir l’API de prévisualisation des e-mails) et /spam-check/{id}/heatmap pour les cartes de focus et d’attention par IA. Tous partagent le même id de test : aucune comptabilité de crédits supplémentaire dans votre code.

Questions fréquentes sur l’API.

Intégration, facturation, limites de requêtes et contenu renvoyé par l’endpoint de test de spam.

Comment obtenir l’accès à l’API ?
L’accès à l’API est fourni avec notre plan White Label, entièrement sur mesure : les limites de tests de spam, de tests de placement en boîte de réception, de captures d’écran et de heatmaps sont dimensionnées pour votre compte. Contactez un commercial en indiquant le volume attendu et nous définirons l’offre adaptée.
Quelles sont les limites de requêtes ?
La limite publique est de 100 requêtes par minute par IP ou par compte authentifié. Cela couvre la majeure partie du trafic de production. S’il vous faut davantage de capacité en pointe ou une file dédiée, ouvrez le chat en indiquant le débit attendu.
Comment fonctionne le flux créer puis lire ?
Deux appels. 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.
Puis-je consulter ma limite restante depuis l’API ?
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.
Quelle est la précision du score de spam ?
Le score reflète la façon dont nos moteurs et nos comptes de test évaluent le message. La livraison réelle dépend encore de la réputation d’expéditeur, de l’hygiène de liste et de l’engagement des destinataires. L’API vous donne le signal contenu et authentification, pas une garantie de placement en boîte de réception.
Puis-je appeler l’API depuis n’importe quel langage ?
Oui. L’API est en REST + JSON sur HTTPS. N’importe quel client HTTP fonctionne (curl, Node, Python, Go, Ruby, PHP, …). Aucun SDK obligatoire ; l’authentification tient dans un seul en-tête Authorization: Bearer YOUR_API_TOKEN.
Existe-t-il un bac à sable ou un essai gratuit ?
Nous ne proposons pas d’essai d’API en libre-service. Contactez un commercial pour obtenir un accès d’évaluation. La plupart des équipes commencent par l’outil web gratuit afin de vérifier que la logique de test correspond à leur cas d’usage.

Prêt à brancher Unspam sur votre stack ?

L’accès à l’API est inclus dans le plan White Label. Les tarifs sont sur la page publique, les limites sur mesure se discutent par chat.

Voir les tarifs