Premiers pas

EmailKind est une API REST qui classifie les adresses email par fournisseur et type. Ce guide vous aidera a demarrer en quelques minutes.

1. Obtenir une cle API

Le plan gratuit inclut 100 requetes par mois. Il y a deux facons d'obtenir une cle, et elles donnent le meme resultat.

Dans un navigateur

Inscrivez-vous sur emailkind.com/fr/register, puis rendez-vous dans Tableau de bord > Cles API et creez une cle.

Depuis un script ou un agent IA

Deux requetes, sans navigateur et sans etape humaine. La premiere vous envoie un code court par email, la seconde l'echange contre une cle.

curl -X POST https://emailkind.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "vous@exemple.com", "lang": "fr"}'
curl -X POST https://emailkind.com/v1/signup/confirm \
  -H "Content-Type: application/json" \
  -d '{"email": "vous@exemple.com", "code": "K7M2QXAB"}'

Le second appel renvoie la cle :

{
  "success": true,
  "api_key": "sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345",
  "plan": "free",
  "monthly_limit": 100,
  "burst_limit": 10
}

Voir Authentification pour la reference complete, codes d'erreur et limites inclus.

Dans les deux cas : copiez et stockez votre cle en lieu sur. Elle n'est affichee qu'une seule fois.

2. Faire votre premiere requete

curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  "https://emailkind.com/v1/classify?email=john@google.com"

3. Lire la reponse

{
  "success": true,
  "request_id": "req_abc123",
  "email": "john@google.com",
  "domain": "google.com",
  "provider": {
    "id": "google_workspace",
    "name": "Google Workspace",
    "type": "business"
  },
  "classification": {
    "is_business": true,
    "is_free": false,
    "is_disposable": false,
    "is_education": false,
    "is_custom_domain": true,
    "is_role": false
  },
  "mx": [
    "smtp.google.com",
    "smtp2.google.com"
  ],
  "confidence": 0.98,
  "cached": false
}

4. Integrer avec un SDK

Installez le SDK officiel pour votre langage :

Python (PyPI)

pip install emailkind
from emailkind import EmailKind

client = EmailKind("sk_live_VOTRE_CLE")
result = client.classify(email="ceo@stripe.com")
print(result.provider.name)                # "Google Workspace"
print(result.classification.is_business)   # True

Node.js (npm)

npm install emailkind
import EmailKind from 'emailkind';

const client = new EmailKind('sk_live_VOTRE_CLE');
const result = await client.classify({ email: 'ceo@stripe.com' });
console.log(result.provider.name);             // "Google Workspace"
console.log(result.classification.is_business); // true

Go (pkg.go.dev)

go get github.com/gastonmedia/emailkind-go
client := emailkind.NewClient("sk_live_VOTRE_CLE")
result, _ := client.Classify(ctx, &emailkind.ClassifyParams{
    Email: "ceo@stripe.com",
})
fmt.Println(result.Provider.Name) // "Google Workspace"

Consultez la documentation complete des SDKs pour la classification par lot, les regles personnalisees, le traitement bulk et la gestion des erreurs.

Autres langages

Vous pouvez aussi utiliser l'API REST directement. Voir la reference de l'endpoint Classify pour des exemples cURL, PHP et Ruby.

Etapes suivantes