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.txtProduk massal email_avatar_batch
Unggah seluruh file alamat Gmail, Yandex, atau Mail.ru: ketahui mana yang dapat dikirimi dan dapatkan avatar masing-masing.
Tambahan untuk daftar besar secara utuh — untuk sedikit email, pemeriksaan real-time menjawab dalam permintaan yang sama. Pemeriksaan real-time →
Kontrak API
Pengiriman langsung mengembalikan ID tugas; periksa tugas dengan ID tersebut dan, setelah berhasil, respons membawa tautan unduhan file hasil. Setiap permintaan ditampilkan bersama responsnya.
ID tugas langsung dikembalikan dengan preparing bernilai true selama file disiapkan di latar belakang: baris tidak valid dan duplikat dihapus dan tidak ditagihkan. Saldo dicadangkan untuk baris yang dikirim dan diselesaikan saat tugas selesai; selisihnya dikembalikan.
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"
}
}Lakukan polling berdasarkan ID tugas. Setelah persiapan selesai, submitted_lines = total + invalid_cnt + duplicate_cnt, dengan total adalah jumlah yang diperiksa dan ditagihkan; no_code_cnt dan other_country_cnt selalu 0 untuk tugas email. Respons yang berhasil membawa jumlah keberhasilan dan kegagalan serta tautan unduhan file hasil; tugas yang ditolak selama persiapan berstatus failed dengan reason_detail dan dikembalikan sepenuhnya.
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"
}
}Cara kerjanya
Massal bukan sekadar real-time dalam skala besar — kirim sekali, berjalan di latar belakang, ambil kemudian. Anda tidak perlu membiarkan halaman tetap terbuka; status tugas dan hasilnya tetap tersimpan di dasbor Anda.
File .txt atau .csv dengan satu email per baris. File dialirkan langsung; tidak ada yang ditulis ke disk.
Masalah yang jelas (file kosong, format salah, jumlah baris terlalu sedikit) ditolak saat diunggah. Saldo kemudian dicadangkan dan file disiapkan di latar belakang: baris duplikat dan tidak valid dihapus dan cakupan penyedia diperiksa. File yang gagal pada tahap itu berakhir sebagai tugas gagal dan dikembalikan sepenuhnya; jika tidak, hanya baris yang tersisa yang diperiksa, dan tugas diselesaikan tagihannya saat selesai.
Tugas berjalan dengan sendirinya — Anda boleh menutup halaman. Kegagalan langsung dilaporkan dan dikembalikan sepenuhnya.
Ambil file dari halaman pemeriksaan massal. Anda hanya membayar untuk email yang benar-benar mengembalikan hasil; selisihnya dikembalikan.
Field hasil
Unduhan berupa satu file CSV yang berisi tabel lengkap ini.
identifier · alex.kim@gmail.com — Alamat yang dikirim, dalam huruf kecil.activated · true — Apakah alamat dapat dikirimi di penyedia tersebut — apakah dapat menerima email: true atau false. Jika tidak true, setiap kolom lain di baris tersebut dibiarkan kosong.avatar · true — Apakah avatar sudah diatur: true atau false. avatar_url tetap bisa kosong jika gambar tidak tersedia.avatar_url · https://lh3.googleusercontent.com/a/example — URL avatar; kosong jika tidak ada URL yang tersedia.Paling cocok untuk
activatedavatar_urlSetelah memastikan alamat dapat menerima email, tambahkan tautan avatar publiknya kembali ke catatan kontak agar lebih mudah dikenali.
Contoh: memperkaya kontak Gmail yang sudah tersimpan di CRM penjualan.
identifieractivatedavatarTandai alamat yang tidak dapat dikirimi dan entri tanpa avatar agar dapat dibersihkan, digabungkan, atau ditinjau nanti.
Contoh: hapus alamat yang gagal, lalu tinjau kontak valid dengan profil yang belum lengkap.
activatedavataravatar_urlJalankan ulang daftar yang tersimpan secara berkala untuk melihat apakah keterkiriman atau avatar publik telah berubah.
Contoh: perbarui data avatar untuk kontak bernilai tinggi setiap kuartal.
Jawaban langsung
Pemeriksaan avatar massal adalah versi file dari pemeriksaan avatar real-time (email_avatar) dan mencakup domain Gmail, Yandex, dan Mail.ru. Campur dengan bebas dalam satu file; setiap alamat dirutekan untuk Anda. Untuk setiap alamat, pemeriksaan mengembalikan apakah alamat dapat dikirimi, apakah avatar sudah diatur, dan URL avatar. File dengan alamat di luar daftar itu gagal saat sedang disiapkan dan dikembalikan sepenuhnya.
Batasan yang jelas
Kapan massal cocok
| Pemeriksaan real-time | Pemeriksaan massal | |
|---|---|---|
| Berapa banyak email | 1 email per pemeriksaan tunggal; beberapa per permintaan multi — batas pastinya ada di dokumentasi API | Seluruh daftar besar dalam satu tugas — rentang ukuran saat ini ada di halaman harga |
| Mendapatkan hasil | Langsung: endpoint tunggal dan multi menjawab dalam respons yang sama; dasbor mengembalikannya satu per satu | Unduh file hasil setelah tugas selesai |
| Cakupan penyedia | Tanpa batasan — campur bebas dalam satu permintaan | Pemeriksaan alamat lengkap menerima domain apa pun dalam satu file; pemeriksaan avatar menerima Gmail, Yandex, dan Mail.ru bercampur dalam satu file, dan tidak ada di luar ketiganya |
| Bentuk hasil | JSON, kolom per email | File hasil (satu CSV dengan tabel lengkap) |
| Penggunaan umum | Validasi formulir, pencarian oleh agen, penyaringan sebelum pengiriman | Pembersihan daftar, penyaringan sebelum kampanye, pembersihan data tersimpan |
FAQ produk
Gunakan pemeriksaan massal untuk daftar besar secara utuh. Untuk sedikit email, pemeriksaan real-time menjawab dalam permintaan yang sama, tanpa tugas yang perlu dijadwalkan.
Pemeriksaan awal membuang baris yang formatnya salah, sehingga tidak pernah masuk ke hitungan yang ditagih. Dari email yang tersisa, yang tidak dapat diselesaikan oleh upstream juga tidak ditagih. Anda hanya membayar untuk email yang benar-benar mengembalikan hasil.
Tergantung pada jumlah email dan produknya. Anda dapat menutup halaman setelah mengirim; tugas berjalan di latar belakang dan hasilnya menunggu Anda di halaman pemeriksaan massal.
Ya. Tugas yang gagal dikembalikan sepenuhnya. Jika tugas berhasil tetapi sebagian email tidak mengembalikan apa pun, bagian itu dikembalikan secara otomatis. Selisih antara jumlah yang dicadangkan dan yang benar-benar ditagih selalu dikembalikan.
Produk terkait
Pemeriksaan massal dan real-time menggunakan saldo yang sama — tidak ada yang perlu diaktifkan tambahan. Daftar dan unggah file pertama Anda di halaman pemeriksaan massal.