Cara AvatarLookup memeriksa avatar sebuah akun

Selesaikan satu pencarian

Bagian ini membahas produk real-time: dasbor dan endpoint REST sinkron berbagi satu layanan pencarian dan satu makna respons. Daftar lengkap diproses melalui opsi massal asinkron, yang dibahas di akhir halaman ini.

1. 1

   Pilih sumbernya

   service_type=ws_profile menerima nomor. service_type=email_profile menerima email dan mencakup Gmail, Yandex, dan Mail.ru dalam satu produk.

2. 2

   Kirim satu pengenal

   Satu per permintaan, atau hingga 100 dalam satu permintaan multi sinkron. Seluruh batch memakai satu service_type yang sama.

3. 3

   Baca tiga field

   registered, avatar, dan avatar_url. Jalankan pencarian baru ketika Anda memerlukan status terkini — avatar bisa berubah.

Format pengenal yang harus dikirim

Setiap produk menerima tepat satu bentuk pengenal. Bentuk yang salah ditolak sebelum ada tagihan.

• WhatsApp: satu nomor dalam format E.164 — tanda plus, kode negara, lalu nomor pelanggan tanpa spasi atau pemisah.
• Email: satu alamat lengkap. Hanya domain Gmail, Yandex, dan Mail.ru yang diterima; domain lain ditolak sebelum ditagih, karena tidak ada layanan upstream yang mencakupnya.
• Format nomor nasional dengan angka nol di depan, spasi, tanda hubung, atau tanda kurung tidak diterima. Format yang ditolak bukan hasil «tidak ada avatar».

Apa arti ketiga field tersebut?

Ketiganya menjawab tiga pertanyaan berbeda dan tidak boleh digabung menjadi satu. Akun yang tidak ada tidak mungkin memiliki avatar, tetapi akun yang ada pun mungkin tidak memilikinya — keduanya adalah hasil yang berbeda dan ditagih sama.

• registered — apakah pengenal tersebut memiliki akun di platform itu.
• avatar — apakah akun tersebut memasang avatar. False adalah hasil, bukan kegagalan.
• avatar_url — alamat gambar ketika avatar bernilai true, string kosong jika tidak. URL mengarah ke CDN milik platform itu sendiri dan dapat kedaluwarsa sesuai jadwal mereka, jadi perlakukan sebagai penunjuk, bukan arsip.

Gunakan hasil sesuai cakupannya

Pencarian mencerminkan status pada saat permintaan. Ini bukan verifikasi identitas dan bukan izin untuk menghubungi seseorang.

• Avatar tidak memastikan siapa pemilik akun, apakah akun sedang digunakan, atau apakah ada yang membacanya.
• Avatar dapat ditambahkan, diubah, dan dihapus kapan saja. Hasil yang disimpan bulan lalu adalah catatan saat itu, bukan hari ini.
• Tidak ada yang dikirim ke akun yang dicari.

Daftar lengkap: opsi asinkron

Endpoint multi real-time mencakup sebagian besar daftar. Di luar itu, kirim seluruh file sebagai satu tugas massal asinkron — ini juga satu-satunya cara menjangkau platform yang tidak memiliki produk real-time (Telegram, Viber, LINE, MAX, Zalo).

• Unggah file .txt atau .csv dengan satu pengenal per baris, dari halaman pemeriksaan massal atau melalui API.
• Produk nomor telepon memerlukan pemilihan negara saat mengunggah; produk nama pengguna dan email tidak.
• Saldo dicadangkan untuk baris yang valid saat pengiriman, Anda hanya ditagih untuk pengenal yang mengembalikan hasil, dan selisihnya dikembalikan.
• Tugas berjalan di latar belakang; unduh CSV hasil setelah selesai. Tugas yang gagal dikembalikan sepenuhnya.