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. Get an API key

The free plan includes 100 requests per month. There are two ways to get a key, and they produce the same thing.

In a browser

Sign up at emailkind.com/register, then go to Dashboard > API Keys and create a key.

From a script or an AI agent

Two requests, no browser and no human step. The first emails you a short code; the second trades it for a key.

curl -X POST https://emailkind.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

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

The second call returns the key:

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

See Authentication for the full reference, including error codes and limits.

Either way: copy and store your key securely. It is only shown once.

2. Make your first request

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

3. Read the response

{
  "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. Integrate with an SDK

Install the official SDK for your language:

Python (PyPI)

pip install emailkind

from emailkind import EmailKind

client = EmailKind("sk_live_YOUR_KEY")
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_YOUR_KEY');
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_YOUR_KEY")
result, _ := client.Classify(ctx, &emailkind.ClassifyParams{
    Email: "ceo@stripe.com",
})
fmt.Println(result.Provider.Name) // "Google Workspace"

See the full SDK documentation for batch classification, custom rules, bulk processing, and error handling.

Other languages

You can also use the REST API directly with any HTTP client. See the Classify endpoint reference for cURL, PHP, and Ruby examples.

Next steps