API Pemeriksa Usia & Gender Viber: Deteksi Profil Massal

Periksa apakah nomor telepon memiliki akun Viber dan lengkapi tiap nomor dengan atribut profil (usia, gender, avatar, terakhir online). Alur tugas batch yang sama dengan pemeriksa lainnya.

Unggah file deteksi — contoh:

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="viber_senior"'

Periksa status tugas — contoh:

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Respons setelah unggahan berhasil

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2026-04-28T11:58:08.916446594Z"
}

Respons saat pemrosesan

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Respons saat selesai (exported)

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL permintaan unggah file

POST https://api.numberchecker.ai/v1/tasks

Parameter permintaan unggah file

Parameter	Deskripsi
file	file, satu nomor telepon per baris (format E.164)
task_type	string, atur ke viber_senior

URL permintaan cek status tugas

POST https://api.numberchecker.ai/v1/gettasks

Parameter permintaan cek status tugas

Parameter	Deskripsi
task_id	string, ID tugas yang dikembalikan saat pembuatan tugas

Kolom hasil

Kolom	Deskripsi
number	Nomor telepon dalam format E.164
activated	Apakah akun terdaftar/aktif (yes / no)
last_online_time	Terakhir kali akun terlihat online
active_days	Rentang hari aktif terbaru
mid	ID anggota Viber internal
nickname	Nama tampilan profil
person_count	Jumlah wajah yang terdeteksi di avatar
avatar_type	Klasifikasi avatar
age	Perkiraan rentang usia
skin_color	Perkiraan warna kulit
gender	Perkiraan gender
avatar	URL gambar avatar (jika ada)

Format respons

Field	Deskripsi
created_at	Stempel waktu saat tugas dibuat
updated_at	Stempel waktu pembaruan status tugas terakhir
task_id	Pengidentifikasi tugas unik
user_id	ID pengguna
status	pending · processing · exported · failed (dikembalikan otomatis)
total	Total nomor telepon yang diproses
success	Nomor yang berhasil diidentifikasi
failure	Nomor yang gagal diproses
result_url	URL unduh saat status adalah exported
actual_amount	(Opsional) Jumlah yang benar-benar ditagih, tersedia setelah task diselesaikan
estimated_amount	(Respons pembuatan) Perkiraan biaya task; tagihan final diselesaikan saat task selesai

Kode status

Status	Deskripsi
200	free, Permintaan berhasil (mis. cek status)
202	charge, Task berhasil dibuat; perkiraan biaya dipotong
400	free, Permintaan tidak valid: parameter atau format file salah, jenis task tidak didukung, atau entri valid kurang dari batch minimum
401	free, API key tidak ada atau tidak valid
402	free, Saldo tidak mencukupi
404	free, Task tidak ditemukan
413	free, File yang diunggah terlalu besar
500	free, Kesalahan server internal, coba lagi nanti