Telegram Username Activity API: Pemeriksaan massal

Periksa username Telegram secara massal dan dapatkan ID pengguna, terakhir online, hari aktif, dan status keanggotaan.

Format input

Unggah file teks dengan satu nama pengguna per baris. Normalisasi nilai sebelum mengunggah.

@example_user
@another_user

Buat tugas

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

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

API mengembalikan ID tugas. Simpan ID ini dan gunakan untuk memeriksa status tugas.

Respons unggahan

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Periksa status tugas

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

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

Periksa hingga status menjadi exported. Jangan menganggap pending atau processing sebagai hasil selesai.

Respons pemrosesan

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Respons yang diekspor

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Kolom hasil

Kolom	Deskripsi	Contoh
username	Username yang dikirim dalam file input.	example_user
activated	Apakah username terdaftar di Telegram (yes / no).	yes
uid	ID pengguna Telegram berupa angka.	7084480174
lastseen	Tanggal terakhir akun online (YYYY-MM-DD).	2026-08-01
activedays	Rentang hari aktif dari penyedia, misalnya over 30 days.	over 30 days
member	Apakah akun memiliki keanggotaan Telegram (Premium) (yes / no).	no
avatar_url	URL avatar publik, disalin ke CDN kami. Kosong jika akun tidak punya foto publik.	https://telegram.waavatar.xyz/v/a.jpg

Catatan: Tiga produk username Telegram adalah tahapan dari satu alur. Akun tanpa avatar publik berhenti setelah tahap pendaftaran, sehingga kolom aktivitas dan profilnya dikirim kosong.

Penanganan file hasil

Unduh file dari result_url hanya setelah tugas diekspor. Pertahankan nama kolom yang dikembalikan saat memproses file.

Kolom respons

Kolom	Deskripsi
created_at	Waktu saat tugas dibuat.
updated_at	Waktu pembaruan status tugas terakhir.
task_id	Pengenal tugas unik.
status	pending, processing, exported, atau failed.
total	Total nilai input yang diproses.
success	Nilai yang berhasil diproses.
failure	Nilai yang gagal diproses.
result_url	URL unduhan saat tugas diekspor.
actual_amount	Jumlah akhir, jika tersedia.
estimated_amount	Jumlah perkiraan yang dikembalikan saat tugas dibuat.

Kode status

Status	Deskripsi
200	Permintaan berhasil.
202	Tugas berhasil dibuat dan biaya perkiraan diterapkan.
400	File tidak valid, jenis tugas tidak didukung, atau entri valid terlalu sedikit.
401	Kunci API tidak ada atau tidak valid.
402	Saldo akun tidak mencukupi.
404	Tugas tidak ditemukan.
413	File yang diunggah terlalu besar.
500	Kesalahan server internal; coba lagi nanti.

Catatan operasional

• Tugas berjalan secara asinkron; gunakan ID tugas untuk memeriksa status.
• Periksa batas input khusus produk sebelum mengunggah.
• Baris yang gagal dilaporkan dalam hasil ekspor dan tercermin pada penghitung tugas.
• Kolom di atas berdasarkan sample live saat ini dan dapat berubah jika skema ekspor berubah.