API Pemeriksa Massal Avatar, Usia & Gender WhatsApp: Analisis Profil

Periksa informasi avatar WhatsApp dari nomor internasional yang dimasukkan, termasuk status akun, URL foto profil, gender, usia, warna rambut, warna kulit, dan jenis foto profil.

Contoh upload file deteksi:

curl --location 'https://api.checknumber.ai/wa/api/deep/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"input.txt"'

Contoh cek status task:

curl --location 'https://api.checknumber.ai/wa/api/deep/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

Respons upload file berhasil:

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Respons status pemrosesan:

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Respons ketika task selesai (termasuk URL download hasil):

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

URL permintaan upload file

POST https://api.checknumber.ai/wa/api/deep/tasks

Parameter permintaan upload file

Parameter	Deskripsi
user_id	string, ID pengguna
file	file, Unggah file; setiap baris harus berisi satu nomor dalam format E.164

URL permintaan cek status task

GET https://api.checknumber.ai/wa/api/deep/tasks/{TASK_ID}

Parameter permintaan cek status task

Parameter	Deskripsi
user_id	string, ID pengguna

Kolom hasil

Kolom	Deskripsi	Contoh
Number	Nomor telepon dalam format E.164	+41798284651
age	Perkiraan rentang usia berdasarkan foto profil	25
avatar	URL foto profil WhatsApp	https://example.com/avatar.jpg
category	Klasifikasi jenis foto profil	individual portrait, pet avatar, object, etc.
gender	Gender yang terdeteksi dari foto profil	male, female
hair_color	Warna rambut yang terdeteksi dari foto profil	black, brown, blonde, etc.
skin_color	Etnis atau ras yang terdeteksi dari foto profil	white, black, etc.
whatsapp	Apakah nomor memiliki akun WhatsApp aktif	yes, no

Format respons

Field	Description
created_at	Waktu saat task dibuat
updated_at	Waktu pembaruan status task terakhir
task_id	ID unik task
user_id	ID pengguna
status	Status task: pending: Dalam antrean dan menunggu processing: Sedang diproses completed: Pemrosesan selesai exported: Hasil tersedia untuk diunduh
total	Total nomor telepon yang diproses
success	Nomor berhasil diidentifikasi
failure	Nomor yang gagal diproses
result_url	(Opsional) URL unduh hasil saat status exported

Kode status

Status	Deskripsi
200	charge, Permintaan berhasil, task dibuat atau status diperoleh
400	free, Permintaan tidak valid, parameter atau format file tidak benar
500	free, Kesalahan server internal, coba lagi nanti