· 3 min read
API Pengecek Nomor WhatsApp Massal Mendalam (Deep API)
Cek nomor telepon global untuk akun WhatsApp dan ambil informasi demografis terperinci termasuk gender, usia, warna rambut, dan analisis foto profil.
Cek atribut profil dan demografis nomor telepon global di WhatsApp termasuk gender, usia, dan analisis foto profil.
URL API
POST https://api.checknumber.ai/v1/tasks
Fitur Utama
API Pengecek Nomor WhatsApp Massal Mendalam menawarkan kemampuan analitis yang kuat:
Analisis Demografis
API ini menyediakan informasi demografis terperinci dari foto profil, termasuk:
- Deteksi gender (jenis kelamin)
- Estimasi usia
- Analisis warna rambut
- Deteksi warna kulit
Atribut Profil
Informasi profil yang komprehensif termasuk:
- Verifikasi status akun WhatsApp
- Pengambilan URL foto profil
- Klasifikasi jenis foto profil
- Status verifikasi akun
Pemrosesan Massal
Proses beberapa nomor secara bersamaan melalui pengunggahan file, membuatnya efisien untuk analisis berskala besar.
Langkah-langkah Penggunaan
Pengunggahan File
Unggah file teks berisi nomor telepon dalam format E.164:
Contoh Permintaan
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file"' \
--form 'task_type="ws_avatar"'
Parameter Permintaan
| Parameter | Tipe | Deskripsi |
|---|---|---|
file | file | File yang berisi nomor-nomor yang akan dicek, satu nomor per baris |
task_type | string | ws_avatar — atribut berbasis avatar |
Pengecekan Status
Pantau status pemrosesan tugas Anda:
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
Contoh Respons
Respons Pembuatan Tugas
{
"created_at": "2024-10-19T18:24:56.450567423Z",
"updated_at": "2024-10-19T18:24:56.450567423Z",
"task_id": "cs9viu7i61pkfs4oavvg",
"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",
"status": "processing",
"total": 20000,
"success": 6724,
"failure": 0
}
Respons Tugas Selesai
{
"created_at": "2024-10-19T18:24:56.450567423Z",
"updated_at": "2024-10-19T18:53:43.141760071Z",
"task_id": "cs9viu7i61pkfs4oavvg",
"status": "exported",
"total": 20000,
"success": 20000,
"failure": 0,
"result_url": "https://example-link-to-results.xlsx"
}
Bidang Hasil Pengecekan Nomor WhatsApp
| Bidang | Deskripsi | Contoh |
|---|---|---|
Number | Nomor telepon dalam format E.164 | +6281234567890 |
age | Rentang estimasi usia berdasarkan foto profil | 25 |
avatar | URL foto profil WhatsApp | https://checknumber.ai/avatar.jpg |
category | Klasifikasi tipe foto profil | individual portrait, pet avatar, object, dll. |
gender | Gender yang terdeteksi dari foto profil | male, female |
hair_color | Warna rambut yang terdeteksi dari foto profil | black, brown, blonde, dll. |
whatsapp | Apakah nomor memiliki akun WhatsApp aktif | yes, no |
Format Respons API
| Bidang | Deskripsi |
|---|---|
created_at | Stempel waktu pembuatan tugas |
updated_at | Stempel waktu pembaruan status terakhir tugas |
task_id | Pengidentifikasi tugas unik |
status | Status tugas: pending/processing/completed/exported |
total | Total nomor telepon yang diproses |
success | Nomor yang berhasil diidentifikasi |
failure | Nomor yang gagal dalam pemrosesan |
result_url | (Opsional) URL unduhan hasil jika status adalah exported |
Kode Status
| Status | Deskripsi |
|---|---|
200 | charge, Permintaan berhasil, tugas dibuat atau status diambil |
400 | free, Permintaan salah, parameter atau format file tidak valid |
500 | free, Kesalahan server internal, coba lagi nanti |
Catatan Integrasi
- Setiap baris di file input harus memuat satu nomor telepon dalam format E.164.
- Monitor status tugas menggunakan
task_id. - Unduh hasil dari
result_urlsaat status berubah menjadi “exported”. - Tangani setiap kode status dengan benar di aplikasi Anda.
FAQ
1. Berapa kapasitas pemrosesan dari API ini?
API ini dapat memproses nomor dalam jumlah besar secara efisien, dengan update status real-time saat berjalan.
2. Format apa yang harus digunakan pada file masukan?
File masukan sebaiknya berupa file teks (text file) yang berisi satu nomor per baris berformat E.164 (misalnya: +6281234567890).
3. Seberapa akurat analisis demografis ini?
Analisis demografis didasarkan pada pemrosesan AI tingkat lanjut terhadap foto profil dan memberikan perkiraan untuk usia, jenis kelamin, dan atribut lainnya jika tersedia.
4. Apa saja kode status respons API?
API menggunakan kode status HTTP standar untuk menandakan keberhasilan atau kegagalan:
200: Permintaan berhasil (dikenakan biaya)400: Parameter atau format file tidak valid (gratis)500: Kesalahan server internal (gratis)
5. Berapa harga untuk API Mendalam (Deep API) ini?
Harganya adalah $6 USD per 10.000 nomor. Informasi respons API ini meliputi:
- Verifikasi status akun WhatsApp
- Deteksi gender (jenis kelamin)
- Estimasi usia
- Analisis jenis foto profil
- Deteksi etnis/warna kulit
- Analisis warna rambut
Untuk informasi selengkapnya tentang harga dan pemrosesan dalam volume yang lebih tinggi, silakan hubungi kami.