POST /api/v1/bulk-taskscurl -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.txtToplu ürün email_avatar_batch
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.
Büyük listelerin tamamı için bir ek seçenek — birkaç e-posta için gerçek zamanlı kontrol aynı istekte yanıt verir. Gerçek zamanlı kontrol →
API sözleşmesi
Gönderim hemen bir görev kimliği döndürür; görevi bu kimlikle kontrol edin ve başarılı olduğunda yanıt, sonuç dosyasının indirme bağlantısını içerir. Her istek kendi yanıtıyla birlikte gösterilir.
Görev kimliği hemen döner ve dosya arka planda hazırlanırken preparing true olarak ayarlanır: geçersiz satırlar ve yinelenenler çıkarılır ve ücretlendirilmez. Gönderilen satırlar için bakiye ayrılır ve tamamlandığında hesaplaşma yapılır; fark iade edilir.
POST /api/v1/bulk-taskscurl -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.txt200 OK{
"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örev kimliğiyle yoklama yapın. Hazırlık tamamlandığında submitted_lines = total + invalid_cnt + duplicate_cnt olur; burada total, kontrol edilen ve ücretlendirilen sayıdır. E-posta görevlerinde no_code_cnt ve other_country_cnt her zaman 0'dır. Başarılı bir yanıt, başarılı ve başarısız sayılarını ve sonuç dosyasının indirme bağlantısını içerir; hazırlık sırasında reddedilen bir görev reason_detail ile failed durumuna geçer ve tamamı iade edilir.
GET /api/v1/bulk-tasks/{id}curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"200 OK{
"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"
}
}Nasıl çalışır
Toplu kontrol, gerçek zamanlı kontrolün büyütülmüş hâli değildir — bir kez gönderilir, arka planda çalışır, daha sonra alınır. Sayfayı açık tutmanız gerekmez; görev durumu ve sonuçlar panelinizde kalır.
Her satırda bir e-posta bulunan bir .txt veya .csv dosyası. Doğrudan akış olarak iletilir; diske hiçbir şey yazılmaz.
Belirgin sorunlar (boş dosya, yanlış biçim, çok az satır) yükleme sırasında reddedilir. Ardından bakiye ayrılır ve dosya arka planda hazırlanır: yinelenen ve geçersiz satırlar çıkarılır ve sağlayıcı kapsamı kontrol edilir. Bu aşamada başarısız olan bir dosya, tamamı iade edilen başarısız bir görev olarak sonlanır; aksi takdirde yalnızca kalan satırlar kontrol edilir ve görev tamamlandığında hesaplaşılır.
Görev kendi başına çalışır — isterseniz sayfayı kapatın. Bir hata hemen bildirilir ve tamamı iade edilir.
Dosyayı toplu kontrol sayfasından alın. Yalnızca gerçekten sonuç döndüren e-postalar için ödersiniz; aradaki fark iade edilir.
Sonuç alanları
İndirilen dosya, bu tablonun tamamını içeren tek bir CSV dosyasıdır.
identifier · alex.kim@gmail.com — Gönderilen adres, küçük harflerle.activated · true — Adresin 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.avatar · true — Profil fotoğrafı ayarlanıp ayarlanmadığı: true veya false. Görsel kullanılamadığında avatar_url yine de boş olabilir.avatar_url · https://lh3.googleusercontent.com/a/example — Profil fotoğrafı URL'si; URL mevcut olmadığında boştur.En uygun kullanım
activatedavatar_urlBir adresin posta alabildiğini doğruladıktan sonra, daha kolay tanınması için herkese açık profil fotoğrafı bağlantısını kişi kaydına ekleyin.
Örneğin: bir satış CRM'inde zaten kayıtlı olan Gmail kişilerini zenginleştirin.
identifieractivatedavatarTeslim edilemeyen adresleri ve profil fotoğrafı olmayan kayıtları, daha sonra temizlenebilmeleri, birleştirilebilmeleri veya incelenebilmeleri için işaretleyin.
Örneğin: başarısız adresleri kaldırın, ardından profili eksik olan geçerli kişileri inceleyin.
activatedavataravatar_urlTeslim edilebilirliğin veya herkese açık profil fotoğrafının değişip değişmediğini görmek için kayıtlı bir listeyi periyodik olarak yeniden çalıştırın.
Örneğin: yüksek değerli kişilerin profil fotoğrafı verilerini her çeyrekte yenileyin.
Doğrudan yanıt
Toplu profil fotoğrafı kontrolü, gerçek zamanlı profil fotoğrafı kontrolünün (email_avatar) dosya sürümüdür ve Gmail, Yandex ve Mail.ru alan adlarını kapsar. Bunları tek dosyada serbestçe karıştırın; her adres sizin için yönlendirilir. Her adres için teslim edilebilir olup olmadığını, profil fotoğrafı ayarlanıp ayarlanmadığını ve profil fotoğrafı URL'sini döndürür. Bu listenin dışındaki adresleri içeren bir dosya hazırlanırken başarısız olur ve tamamı iade edilir.
Net sınırlar
Toplu kontrol ne zaman uygun
| Gerçek zamanlı kontrol | Toplu kontrol | |
|---|---|---|
| Kaç e-posta | Tekli kontrolde 1 e-posta; çoklu istekte birkaç tane — kesin üst sınırlar API belgelerindedir | Tek görevde büyük bir listenin tamamı — güncel boyut aralığı fiyatlandırma sayfasında yer alır |
| Sonuçları alma | Hemen: tekli ve çoklu uç nokta aynı yanıtta cevap verir; panel sonuçları tek tek döndürür | Görev tamamlandığında bir sonuç dosyası indirin |
| Sağlayıcı kapsamı | Kısıtlama yok — tek istekte serbestçe karıştırın | Tam adres kontrolü tek dosyada her alan adını kabul eder; profil fotoğrafı kontrolü Gmail, Yandex ve Mail.ru'yu tek dosyada karışık olarak kabul eder, bu üçü dışında hiçbir şeyi kabul etmez |
| Sonuç biçimi | JSON, e-posta başına alanlar | Sonuç dosyası (tablonun tamamını içeren tek bir CSV) |
| Tipik kullanım | Form doğrulama, temsilci sorgulamaları, gönderim öncesi kontrol | Liste temizliği, kampanya öncesi filtreleme, saklanan verilerin temizlenmesi |
Ürün SSS
Büyük listelerin tamamı için toplu kontrolü kullanın. Birkaç e-posta için gerçek zamanlı kontrol, planlanacak bir görev olmadan aynı istekte yanıt verir.
Ön kontrol hatalı satırları çıkarır, bu nedenle ücretlendirilebilir sayıya hiç girmezler. Kalan e-postalardan üst kaynağın çözemedikleri de ücretlendirilmez. Yalnızca gerçekten sonuç döndüren e-postalar için ödersiniz.
E-posta sayısına ve ürüne bağlıdır. Gönderdikten sonra sayfayı kapatabilirsiniz; görev arka planda çalışır ve sonuç sizi toplu kontrol sayfasında bekler.
Evet. Başarısız bir görevin tamamı iade edilir. Görev başarılı olur ancak bazı e-postalar hiçbir şey döndürmezse, o kısım otomatik olarak iade edilir. Ayrılan tutar ile gerçekte ücretlendirilen tutar arasındaki fark her zaman geri gelir.
İlgili ürünler
Toplu ve gerçek zamanlı kontroller aynı bakiyeden düşülür — ayrıca etkinleştirilecek bir şey yoktur. Kayıt olun ve ilk dosyanızı toplu kontrol sayfasında yükleyin.