Getting Started

EmailClassifier 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 emailclassifier.com/register to get your free API key. The free plan includes 500 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://api.emailclassifier.com/v1/[email protected]"

4. Read the response

{
  "data": {
    "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_custom_domain": false
    },
    "confidence": 0.98,
    "cached": false
  },
  "request_id": "req_abc123"
}

Next steps