Endpoint Classify

L'endpoint classify analyse une adresse email ou un domaine et retourne les informations du fournisseur et les details de classification.

Requete

GET /v1/classify

Parametres de requete

| Parametre | Type | Requis | Description | |---|---|---|---| | email | string | Oui* | L'adresse email a classifier | | domain | string | Oui* | Le domaine a classifier |

*Au moins un des parametres email ou domain doit etre fourni. Si les deux sont fournis, le domaine de l'email prevaut.

Exemples

cURL

# Classifier par email
curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  "https://emailkind.com/v1/[email protected]"

# Classifier par domaine
curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  "https://emailkind.com/v1/classify?domain=google.com"

JavaScript

const API_KEY = "sk_live_VOTRE_CLE";

const res = await fetch(
  "https://emailkind.com/v1/[email protected]",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const data = await res.json();

if (data.classification.is_disposable) {
  console.log("Bloque : email jetable");
} else if (data.classification.is_business) {
  console.log("Email pro de", data.provider.name);
}

Python

import requests

response = requests.get(
    "https://emailkind.com/v1/classify",
    params={"email": "[email protected]"},
    headers={"Authorization": "Bearer sk_live_VOTRE_CLE"}
)
data = response.json()

if data["classification"]["is_disposable"]:
    print("Bloque : email jetable")
elif data["classification"]["is_business"]:
    print(f"Email pro de {data['provider']['name']}")

PHP

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://emailkind.com/v1/classify?" . http_build_query(["email" => "[email protected]"]),
    CURLOPT_HTTPHEADER => ["Authorization: Bearer sk_live_VOTRE_CLE"],
    CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($result["classification"]["is_disposable"]) {
    echo "Bloque : email jetable";
}

Go

req, _ := http.NewRequest("GET", "https://emailkind.com/v1/[email protected]", nil)
req.Header.Set("Authorization", "Bearer sk_live_VOTRE_CLE")

resp, err := http.DefaultClient.Do(req)

Ruby

require "net/http"
require "json"

uri = URI("https://emailkind.com/v1/[email protected]")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer sk_live_VOTRE_CLE"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)

Reponse

{
  "success": true,
  "request_id": "req_abc123",
  "email": "[email protected]",
  "domain": "gmail.com",
  "provider": {
    "id": "gmail",
    "name": "Gmail",
    "type": "personal"
  },
  "classification": {
    "is_business": false,
    "is_free": true,
    "is_disposable": false,
    "is_education": false,
    "is_custom_domain": false
  },
  "mx": [
    "gmail-smtp-in.l.google.com",
    "alt1.gmail-smtp-in.l.google.com"
  ],
  "confidence": 0.98,
  "cached": true
}

Champs de reponse

| Champ | Type | Description | |---|---|---| | success | boolean | Si la requete a reussi | | request_id | string | Identifiant unique de la requete pour le support | | email | string | L'email soumis (vide si requete par domaine uniquement) | | domain | string | Le domaine analyse | | provider.id | string | Identifiant unique du fournisseur (ex. google_workspace, gmail, microsoft_365) | | provider.name | string | Nom lisible du fournisseur | | provider.type | string | Un parmi : business, personal, disposable, hosting, education, isp, self_hosted, unknown | | classification.is_business | boolean | Vrai si l'email est professionnel | | classification.is_free | boolean | Vrai si le fournisseur est gratuit | | classification.is_disposable | boolean | Vrai si l'email est jetable/temporaire | | classification.is_education | boolean | Vrai si le domaine appartient a un etablissement educatif | | classification.is_custom_domain | boolean | Vrai si le domaine utilise un fournisseur connu | | mx | string[] | Enregistrements MX trouves pour le domaine | | confidence | number | Score de confiance de 0.0 a 1.0 | | cached | boolean | Si le resultat DNS provient du cache |

Types de fournisseurs

| Type | Description | Exemples | |---|---|---| | business | Fournisseur email professionnel | Google Workspace, Microsoft 365, Zoho | | personal | Email personnel gratuit | Gmail, Outlook.com, Yahoo Mail | | disposable | Email temporaire/jetable | Guerrilla Mail, Mailinator | | hosting | Email d'hebergeur | GoDaddy, OVH, Namecheap | | education | Etablissement educatif | Systemes email universitaires | | isp | Fournisseur d'acces internet | Comcast, AT&T, Vodafone | | self_hosted | Serveur mail auto-heberge | Enregistrements MX personnalises | | unknown | Indeterminable | Aucun enregistrement MX ou fournisseur non reconnu |

Exemples de classification

| Email | Fournisseur | is_business | is_free | is_disposable | is_education | |---|---|---|---|---|---| | [email protected] | Google Workspace | true | false | false | false | | [email protected] | Gmail | false | true | false | false | | [email protected] | Disposable | false | false | true | false | | [email protected] | Microsoft 365 | true | false | false | true | | [email protected] | Yahoo Mail | false | true | false | false | | [email protected] | Cloudflare Email Routing | true | false | false | false |