EmailCheckPro
Başvuru

EmailCheckPro API başvurusu

Tüm uç noktalar tek bir API anahtarını ve tek bir bakiyeyi paylaşır.

ÖğeDeğer
Temel URLhttps://emailcheckpro.com
Kimlik doğrulama başlığıX-API-Key: sk_your_api_key
Yanıt zarfı{ code, msg, data }

Fiyatlar burada listelenmez; her ürün başarılı kontrol başına ücretlendirilir. Fiyatlandırmayı görün

Kimlik doğrulama

Ayarlar'da oluşturduğunuz bir API anahtarını kullanın ve her istekle birlikte gönderin.

Kimlik doğrulama başlığı
X-API-Key: sk_your_api_key

API anahtarınızı gizli tutunBu uç noktayı her zaman sunucunuzdan çağırın. Anahtara sahip olan herkes bakiyenizi harcayabilir.

Senkron kontroller

POST/api/v1/checkPOST/api/v1/batch-check

Tek bir e-posta adresi veya tek istekte en fazla 100 adres gönderin ve sonucu aynı yanıtta okuyun. Sorgulama yok, geri çağırma yok. Belirlenemeyen bir sonuç 42200 koduyla 422 döndürür ve ücretlendirilmez. Çoklu istek giriş sırasını korur, her tanımlayıcıyı ayrı ayrı ücretlendirir ve tamamlanmak için 300 saniyesi vardır — tamamlanmazsa isteğin tamamı başarısız olur ve tüm ücretler iade edilir.

Parametreler

AlanTürAçıklama
service_typestringÜrün kodu; aşağıda listelenen ürünlerden biri.
identifierstringTekli kontrol: tek bir e-posta adresi. Sunucu bunu normalleştirir.
identifiersstring[]Çoklu kontrol: 1 ile 100 arası e-posta adresi. Yanıt bu sırayı korur.

Bu gruptaki ürünler

E-posta Teslim Edilebilirlik Kontrolü

emaile-posta

Bir e-posta adresinin hâlâ posta alıp alamadığını doğrulayın — Gmail'den bir şirketin kendi alan adına kadar her alan adında çalışır.

Tekli kontrol

POST/api/v1/check
İstek
curl -X POST "https://emailcheckpro.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email", "identifier": "name@gmail.com" }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "identifier": "name@gmail.com",
    "registered": true
  }
}
Yanıt alanları
AlanTürAçıklama
registeredbooleanAdresin teslim edilebilir olup olmadığı — posta alıp alamadığı.

Çoklu kontrol

POST/api/v1/batch-check
İstek
curl -X POST "https://emailcheckpro.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email", "identifiers": ["name@gmail.com", "unknown@gmail.com", "not-an-email"] }'
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "name@gmail.com",
        "exists": true,
        "registered": true
      },
      {
        "identifier": "unknown@gmail.com",
        "exists": true,
        "registered": false
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}
Yanıt alanları
AlanTürAçıklama
existsbooleanBu e-postanın sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirlenemediği veya kontrolün başarısız olduğu anlamına gelir; false olduğunda aşağıdaki alanların hiçbiri yer almaz.
registeredbooleanE-postanın teslim edilebilir olup olmadığı, yani posta alıp alamadığı. Yalnızca exists true olduğunda bulunur ve tekli kontrolle aynı anlamı taşır.

E-posta Profil Fotoğrafı Kontrolü

email_avatare-posta

Gmail, Yandex ve Mail.ru için teslim edilebilirlik durumu ve adresin arkasındaki profil fotoğrafı URL'si.

Tekli kontrol

POST/api/v1/check
İstek
curl -X POST "https://emailcheckpro.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_avatar", "identifier": "name@gmail.com" }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "identifier": "name@gmail.com",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://lh3.googleusercontent.com/a-/example"
  }
}
Yanıt alanları
AlanTürAçıklama
registeredbooleanAdresin o sağlayıcıda teslim edilebilir olup olmadığı — posta alıp alamadığı.
avatarbooleanProfil fotoğrafı ayarlanıp ayarlanmadığı.
avatar_urlstringVarsa profil fotoğrafının URL'si; avatar true olsa bile boş olabilir.

Çoklu kontrol

POST/api/v1/batch-check
İstek
curl -X POST "https://emailcheckpro.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_avatar", "identifiers": ["name@gmail.com", "unknown@gmail.com", "not-an-email"] }'
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "name@gmail.com",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "https://lh3.googleusercontent.com/a-/example"
      },
      {
        "identifier": "unknown@gmail.com",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": ""
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}
Yanıt alanları
AlanTürAçıklama
existsbooleanBu e-postanın sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirlenemediği veya kontrolün başarısız olduğu anlamına gelir; false olduğunda aşağıdaki alanların hiçbiri yer almaz.
registeredbooleanE-postanın teslim edilebilir olup olmadığı, yani posta alıp alamadığı. Yalnızca exists true olduğunda bulunur ve tekli kontrolle aynı anlamı taşır.
avatarbooleanProfil fotoğrafı ayarlanıp ayarlanmadığı.
avatar_urlstringVarsa profil fotoğrafının URL'si; avatar true olsa bile boş olabilir.

Asenkron kontroller

POST/api/v1/bulk-tasksGET/api/v1/bulk-tasks/{id}

Bir dosya yükleyin ve hemen bir görev kimliği alın, ardından bu kimliği başarılı olana kadar kontrol edin. Başarılı yanıt, sonuç indirme bağlantısı olan result_url alanını içerir. Yalnızca iki işlem vardır: gönder ve kontrol et. 30 saniyede bir defadan daha sık yoklama yapmayın.

Parametreler

AlanTürAçıklama
service_typestringToplu ürün kodu; aşağıda listelenen ürünlerden biri.
countrystringE-posta görevleri için gerekmez; göndermeyin. Gönderirseniz yok sayılır.
filefileHer satırda bir tanımlayıcı bulunan, en fazla max_file_bytes (varsayılan 20MB) boyutunda bir .txt veya .csv dosyası.
Idempotency-Keyheaderİsteğe bağlı, en fazla 128 karakter. Aynı anahtarın tekrar gönderilmesi ikinci bir görev oluşturmak yerine orijinal görevi döndürür.

Bu gruptaki ürünler

E-posta Toplu Teslim Edilebilirlik Kontrolü

email_batche-postaGörev başına 1.000–500.000

Bütün bir adres dosyasını yükleyin, hangilerinin posta alabildiğini öğrenin ve bittiğinde sonucu indirin.

Görev gönder

POST/api/v1/bulk-tasks
İstek
curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_batch \
  -F file=@emails.txt
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_batch",
    "status": "processing",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Görevi kontrol et

GET/api/v1/bulk-tasks/{id}
İstek
curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_batch",
    "status": "success",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Sonuç sütunları
Alanörnek:Açıklama
identifieralex.kim@example.comGönderilen e-posta adresi, küçük harflerle.
activatedtrueAdresin posta alıp alamadığı: true (ulaşılabilir) veya false (ulaşılamaz).

E-posta Toplu Profil Fotoğrafı Kontrolü

email_avatar_batche-postaGörev başına 1.000–500.000

Gmail, Yandex veya Mail.ru adreslerinden oluşan bütün bir dosyayı yükleyin: hangilerinin teslim edilebilir olduğunu öğrenin ve her birinin profil fotoğrafını alın.

Görev gönder

POST/api/v1/bulk-tasks
İstek
curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_avatar_batch \
  -F file=@emails.txt
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "processing",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Görevi kontrol et

GET/api/v1/bulk-tasks/{id}
İstek
curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "success",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Sonuç sütunları
Alanörnek:Açıklama
identifieralex.kim@gmail.comGönderilen adres, küçük harflerle.
activatedtrueAdresin o sağlayıcıda teslim edilebilir olup olmadığı — posta alıp alamadığı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.
avatartrueProfil fotoğrafı ayarlanıp ayarlanmadığı: true veya false. Görsel kullanılamadığında avatar_url yine de boş olabilir.
avatar_urlhttps://lh3.googleusercontent.com/a/exampleProfil fotoğrafı URL'si; URL mevcut olmadığında boştur.

Bakiye

GET/api/v1/balance

Mevcut hesap bakiyesini USD mikro birimi cinsinden okuyun. Salt okunurdur: kontrol kaydı oluşturmaz ve ücret almaz.

Bakiye

GET/api/v1/balance
İstek
curl "https://emailcheckpro.com/api/v1/balance" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "balance_micros": 12500000
  }
}

Eşzamanlılık, zaman aşımları ve yeniden deneme davranışı

E-posta teslim edilebilirlik kontrolleri senkrondur. Sonucu kabul etmeye mi yoksa yeniden denemeye mi karar vermek için dönen code değerini kullanın.

AlanAçıklama
Kullanıcı başına aynı anda 5 istekTekli ve çoklu kontroller bu sınırı paylaşır ve bir çoklu istek kaç e-posta içerirse içersin tek istek sayılır. Buna ek olarak, hesap başına aynı anda yalnızca bir çoklu kontrol çalışır; ilki bitene kadar ikincisi reddedilir. Sınırlardan herhangi birine ulaşmak, ücret alınmadan anında 42901 kodunu ve bir Retry-After başlığını döndürür — devam eden bir istek bittiğinde yeniden gönderin.
Tekli 60 sn, çoklu 300 snSüre sınırının aşılması, ücret alınmadan 50400 kodunu döndürür. Zaman aşımına uğrayan bir çoklu kontrol bütünüyle başarısız olur — kısmi sonuç yoktur ve tutarın tamamı iade edilir.
Bir çoklu kontrol en fazla 100 e-posta alırSonuçlar gönderim sırasını ve uzunluğunu korur. Hesap başına aynı anda bir çoklu kontrol çalışır; bir önceki grup döndükten sonra sonraki grubu gönderin.

Hata kodları

KodAçıklama
40000Desteklenmeyen hizmet türü veya çelişen istek alanları
40001Geçersiz JSON gövdesi
40002Geçersiz e-posta
40100Eksik veya geçersiz API anahtarı
40200Yetersiz bakiye
42200E-posta şu anda belirlenemedi. Veri döndürülmez ve istek ücretlendirilmez
42900Bir kullanım kotası tükendi veya tamamlanmamış sipariş sayısı çok fazla
42901Devam eden beş istek yuvasının tamamı dolu veya bu hesapta zaten bir çoklu kontrol çalışıyor; devam eden bir istek bittikten sonra gönderin. Reddedilen istek ücretlendirilmez ve bir Retry-After başlığı taşır
50303Hizmet şu anda tam kapasitede; ücret alınmadı. Retry-After saniyesi kadar bekleyin ve aynı isteği yeniden gönderin
50400Kontrol zaman aşımı süresi içinde tamamlanmadı ve ücretlendirilmez; yeniden deneyin. Grup zaman aşımında grubun tamamı başarısız olur ve tutarın tamamı iade edilir
50300Doğrulama hizmeti bakımda