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

Periksa informasi avatar dari akun Telegram untuk nomor telepon global input, termasuk apakah akun aktif, URL foto profil, gender, usia, warna rambut, dan warna kulit.

Contoh upload file deteksi:

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

Contoh cek status task:

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

Respons upload file deteksi berhasil:

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Respons status pemrosesan:

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

Respons ketika task selesai (termasuk URL download hasil):

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256...",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL permintaan upload file

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

Parameter permintaan upload file

Parameter	Deskripsi
file	file, unggah file, setiap baris harus berisi satu nomor telepon dalam format E.164
task_type	string, tipe task, atur ke “tg_avatar”

URL permintaan cek status task

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

Parameter permintaan cek status task

Parameter	Deskripsi
task_id	string, ID task yang dikembalikan saat membuat task

Kolom hasil

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

Format respons

Field	Deskripsi
created_at	Timestamp saat task dibuat
updated_at	Timestamp update status task terakhir
task_id	Pengenal task unik
user_id	ID pengguna
status	Status task: pending: Antri dan menunggu processing: Sedang diproses exported: Hasil tersedia untuk diunduh failed: Task gagal, biaya yang terpotong dikembalikan secara otomatis
total	Total nomor telepon diproses
success	Nomor berhasil diidentifikasi
failure	Nomor yang gagal diproses
result_url	(Opsional) URL unduh untuk hasil 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