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 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="[email protected]")
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: '[email protected]' });
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: "[email protected]",
})
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