Getting Started

EmailKind is a REST API that classifies email addresses by provider and type. This guide will help you get up and running in minutes.

1. Create an account

Sign up at emailkind.com/register to get your free API key. The free plan includes 100 requests per month.

2. Get your API key

After signing up, go to your Dashboard > API Keys and create a new key. Your key will look like:

sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345

Important: Copy and store your key securely. It will only be shown once.

3. Make your first request

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

4. Read the response

{
  "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. Integrate in your language

JavaScript / Node.js

const API_KEY = "sk_live_YOUR_KEY";

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_YOUR_KEY"

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_YOUR_KEY";

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_YOUR_KEY")

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_YOUR_KEY"

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"

Next steps