POST /api/v1/bulk-taskscurl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=email_avatar_batch \
-F file=@emails.txt
Produk massal email_avatar_batch
Unggah alamat Gmail, Yandex, atau Mail.ru: apakah setiap alamat dapat dikirimi, beserta avatarnya.
Tambahan untuk daftar besar secara utuh — untuk beberapa pengenal saja, 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, duplikat, dan — untuk tugas nomor — nomor tanpa kode negara atau dari negara lain 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://avatarlookup.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 + no_code_cnt + other_country_cnt + duplicate_cnt, dengan total adalah jumlah yang diperiksa dan ditagihkan. 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://avatarlookup.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 nomor per baris. File langsung dialirkan; tidak ada yang ditulis ke disk.
Masalah yang jelas (file kosong, format salah, baris terlalu sedikit) ditolak saat diunggah. Saldo kemudian dicadangkan dan file disiapkan di latar belakang: baris duplikat dan tidak valid dihapus dan aturan negara diperiksa. File yang gagal di tahap itu berakhir sebagai tugas gagal dan dikembalikan sepenuhnya; jika tidak, hanya baris yang tersisa yang diperiksa, dan tugas diselesaikan tagihannya setelah 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 entri yang benar-benar mengembalikan hasil; selisihnya dikembalikan.
Field hasil
Unduhan berupa satu file CSV dengan tabel hasil lengkap.
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 nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.avatar · true — Apakah avatar dipasang: 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
Periksa alamat mana yang dapat dikirimi dan mana yang memiliki avatar.
Tulis kembali URL avatar ke catatan kontak yang sudah ada.
Temukan alamat yang tidak dapat dikirimi atau tidak memiliki avatar.
Jawaban langsung
Pencarian avatar email massal mencakup domain Gmail, Yandex, dan Mail.ru; campur bebas dalam satu file. Untuk setiap alamat, pencarian ini mengembalikan apakah alamat dapat dikirimi, apakah avatar dipasang, dan URL avatar. File yang berisi alamat di luar daftar tersebut gagal saat disiapkan dan dikembalikan sepenuhnya.
Batasan yang jelas
Kapan massal cocok
| Pemeriksaan real-time | Pemeriksaan massal | |
|---|---|---|
| Berapa banyak pengenal | 1 pengenal 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 |
| Negara | Tidak perlu dipilih — pencarian real-time dikirim satu per satu, tidak dikelompokkan per negara | Satu negara per tugas, dipilih saat mengunggah dan dikirim bersama file |
| Bentuk hasil | JSON, field per item | 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 massal untuk daftar besar secara utuh. Untuk beberapa pengenal saja, 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 jumlah yang ditagihkan. Dari nomor yang tersisa, nomor yang tidak dapat diselesaikan oleh layanan hulu juga tidak ditagihkan. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil.
Tergantung jumlah entri 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 beberapa entri tidak mengembalikan apa pun, bagian tersebut dikembalikan secara otomatis. Selisih antara jumlah yang dicadangkan dan yang benar-benar ditagih selalu dikembalikan.
Produk terkait
Analisis avatar WhatsApp · MassalUnggah seluruh file nomor: URL avatar WhatsApp beserta isi avatarnya — kategori, usia, gender, warna kulit, dan warna rambut.
Profil nomor Telegram · MassalUnggah nomor: ID pengguna Telegram, nama pengguna, hari aktif, dan URL avatar, beserta usia, gender, dan warna kulit yang dikenali dari avatar.
Profil nama pengguna Telegram · MassalUnggah nama pengguna Telegram: ID pengguna, hari aktif, dan URL avatar untuk setiap akun.
Profil nomor Viber · MassalUnggah nomor: ID anggota Viber, hari aktif, dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.
Profil nomor MAX · MassalUnggah nomor: ID pengguna MAX, URL avatar, dan gender.
Analisis avatar LINE · MassalUnggah nomor: ID pengguna LINE dan URL avatar, beserta kategori, usia, gender, warna kulit, dan warna rambut yang dikenali dari avatar.
Profil nomor Zalo · MassalUnggah nomor: ID pengguna Zalo dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.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.