· 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

ParameterTipeDeskripsi
filefileFile yang berisi nomor-nomor yang akan dicek, satu nomor per baris
task_typestringws_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

BidangDeskripsiContoh
NumberNomor telepon dalam format E.164+6281234567890
ageRentang estimasi usia berdasarkan foto profil25
avatarURL foto profil WhatsApphttps://checknumber.ai/avatar.jpg
categoryKlasifikasi tipe foto profilindividual portrait, pet avatar, object, dll.
genderGender yang terdeteksi dari foto profilmale, female
hair_colorWarna rambut yang terdeteksi dari foto profilblack, brown, blonde, dll.
whatsappApakah nomor memiliki akun WhatsApp aktifyes, no

Format Respons API

BidangDeskripsi
created_atStempel waktu pembuatan tugas
updated_atStempel waktu pembaruan status terakhir tugas
task_idPengidentifikasi tugas unik
statusStatus tugas: pending/processing/completed/exported
totalTotal nomor telepon yang diproses
successNomor yang berhasil diidentifikasi
failureNomor yang gagal dalam pemrosesan
result_url(Opsional) URL unduhan hasil jika status adalah exported

Kode Status

StatusDeskripsi
200charge, Permintaan berhasil, tugas dibuat atau status diambil
400free, Permintaan salah, parameter atau format file tidak valid
500free, Kesalahan server internal, coba lagi nanti

Catatan Integrasi

  1. Setiap baris di file input harus memuat satu nomor telepon dalam format E.164.
  2. Monitor status tugas menggunakan task_id.
  3. Unduh hasil dari result_url saat status berubah menjadi “exported”.
  4. 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.

Related Posts

View All Posts »