กลับหน้าหลัก

API Documentation

Free API to check Gmail email status. No API key required.

API Endpoint

POST https://gmail.k1god.com/api/v1/check
No API Key Required - This API is completely free and open for everyone to use.

Request Format

Headers

Content-Type: application/json

Request Body

{
  "emails": ["example@gmail.com", "test@gmail.com"],
  "mode": "precision-detailed"
}

Parameters

Field Type Required Description
emails Array or String Yes Array of email addresses or comma/newline separated string (max 300 emails)
email String No Single email address (alternative to emails array)
mode String No Check mode: "fast", "precision", or "precision-detailed" (default: "precision-detailed")

Response Format

Success Response (200 OK)

{
  "success": true,
  "total": 2,
  "results": [
    {
      "email": "example@gmail.com",
      "status": "live"
    },
    {
      "email": "test@gmail.com",
      "status": "Verify"
    }
  ],
  "summary": {
    "live": 1,
    "verify": 1,
    "disabled": 0,
    "error": 0,
    "unregistered": 0
  },
  "timestamp": "2025-01-19T10:30:00.000Z"
}

Error Response

{
  "success": false,
  "message": "ไม่พบอีเมลที่ถูกต้อง",
  "error": "INVALID_EMAILS"
}

Status Values

Status Description
live Email is active and can be used
Verify Email requires verification
Disabled Email account is disabled
Error Error occurred during check
Unregistered Email is not registered

Code Examples

JavaScript (Fetch API)

fetch('https://gmail.k1god.com/api/v1/check', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    emails: ['example@gmail.com', 'test@gmail.com']
  })
})
.then(response => response.json())
.then(data => {
  console.log(data);
})
.catch(error => {
  console.error('Error:', error);
});

Python (Requests)

import requests

url = 'https://gmail.k1god.com/api/v1/check'
data = {
    'emails': ['example@gmail.com', 'test@gmail.com']
}

response = requests.post(url, json=data)
result = response.json()
print(result)

Node.js (Axios)

const axios = require('axios');

axios.post('https://gmail.k1god.com/api/v1/check', {
  emails: ['example@gmail.com', 'test@gmail.com']
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error);
});

cURL

curl -X POST 'https://gmail.k1god.com/api/v1/check' \
  -H 'Content-Type: application/json' \
  -d '{
    "emails": ["example@gmail.com", "test@gmail.com"]
  }'

PHP (cURL)

$ch = curl_init('https://gmail.k1god.com/api/v1/check');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'emails' => ['example@gmail.com', 'test@gmail.com']
]));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Rate Limits & Restrictions