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. Creer un compte

Inscrivez-vous sur emailkind.com/fr/register pour obtenir votre cle API gratuite. Le plan gratuit inclut 100 requetes par mois.

2. Obtenir votre cle API

Apres inscription, rendez-vous dans votre Tableau de bord > Cles API et creez une nouvelle cle. Votre cle ressemblera a :

sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345

Important : Copiez et stockez votre cle en lieu sur. Elle ne sera affichee qu'une seule fois.

3. Faire votre premiere requete

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

4. Lire la reponse

{
  "success": true,
  "request_id": "req_abc123",
  "email": "[email protected]",
  "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
  },
  "mx": [
    "smtp.google.com",
    "smtp2.google.com"
  ],
  "confidence": 0.98,
  "cached": false
}

5. Integrer dans votre langage

JavaScript / Node.js

const API_KEY = "sk_live_VOTRE_CLE";

async function classifyEmail(email) {
  const res = await fetch(
    `https://emailkind.com/v1/classify?email=${encodeURIComponent(email)}`,
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );
  return res.json();
}

const result = await classifyEmail("[email protected]");
console.log(result.provider.name); // "Google Workspace"
console.log(result.classification.is_business); // true

Python

import requests

API_KEY = "sk_live_VOTRE_CLE"

def classify_email(email):
    response = requests.get(
        "https://emailkind.com/v1/classify",
        params={"email": email},
        headers={"Authorization": f"Bearer {API_KEY}"}
    )
    return response.json()

result = classify_email("[email protected]")
print(result["provider"]["name"])  # "Google Workspace"
print(result["classification"]["is_business"])  # True

PHP

$apiKey = "sk_live_VOTRE_CLE";

function classifyEmail(string $email, string $apiKey): array {
    $url = "https://emailkind.com/v1/classify?" . http_build_query(["email" => $email]);
    $ctx = stream_context_create(["http" => [
        "header" => "Authorization: Bearer $apiKey"
    ]]);
    $json = file_get_contents($url, false, $ctx);
    return json_decode($json, true);
}

$result = classifyEmail("[email protected]", $apiKey);
echo $result["provider"]["name"]; // "Google Workspace"

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)
puts data["provider"]["name"] # "Google Workspace"

Etapes suivantes