AvatarLookup

Produk massal tg_username_profile_batch

Profil nama pengguna Telegram · Massal

Unggah nama pengguna Telegram: ID pengguna, hari aktif, dan URL avatar untuk setiap akun.

Tambahan untuk daftar besar secara utuh — untuk beberapa pengenal saja, pemeriksaan real-time menjawab dalam permintaan yang sama. Pemeriksaan real-time →

Lihat kontrak APIDaftar

Kontrak API

Dua langkah: kirim file, lalu periksa tugas

Baca dokumentasi API lengkap Buka Kunci API

Pengiriman langsung mengembalikan ID tugas; periksa tugas dengan ID tersebut dan, setelah berhasil, respons membawa tautan unduhan file hasil. Setiap permintaan ditampilkan bersama responsnya.

1. Kirim file

ID tugas langsung dikembalikan dengan preparing bernilai true selama file disiapkan di latar belakang: baris tidak valid, duplikat, dan — untuk tugas nomor — nomor tanpa kode negara atau dari negara lain dihapus dan tidak ditagihkan. Saldo dicadangkan untuk baris yang dikirim dan diselesaikan saat tugas selesai; selisihnya dikembalikan.

Permintaan cURLPOST /api/v1/bulk-tasks
curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_username_profile_batch \
  -F file=@usernames.txt
Respons: tugas dibuat200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_username_profile_batch",
    "status": "processing",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. Periksa tugas

Lakukan polling berdasarkan ID tugas. Setelah persiapan selesai, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, dengan total adalah jumlah yang diperiksa dan ditagihkan. Respons yang berhasil membawa jumlah keberhasilan dan kegagalan serta tautan unduhan file hasil; tugas yang ditolak selama persiapan berstatus failed dengan reason_detail dan dikembalikan sepenuhnya.

Permintaan cURLGET /api/v1/bulk-tasks/{id}
curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Respons: tugas selesai200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_username_profile_batch",
    "status": "success",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Cara kerjanya

Apa yang terjadi pada tugas massal

Massal bukan sekadar real-time dalam skala besar — kirim sekali, berjalan di latar belakang, ambil kemudian. Anda tidak perlu membiarkan halaman tetap terbuka; status tugas dan hasilnya tetap tersimpan di dasbor Anda.

  1. 01Unggah file

    File .txt atau .csv dengan satu nomor per baris. File langsung dialirkan; tidak ada yang ditulis ke disk.

  2. 02Pemeriksaan awal dan pencadangan

    Masalah yang jelas (file kosong, format salah, baris terlalu sedikit) ditolak saat diunggah. Saldo kemudian dicadangkan dan file disiapkan di latar belakang: baris duplikat dan tidak valid dihapus dan aturan negara diperiksa. File yang gagal di tahap itu berakhir sebagai tugas gagal dan dikembalikan sepenuhnya; jika tidak, hanya baris yang tersisa yang diperiksa, dan tugas diselesaikan tagihannya setelah selesai.

  3. 03Berjalan di latar belakang

    Tugas berjalan dengan sendirinya — Anda boleh menutup halaman. Kegagalan langsung dilaporkan dan dikembalikan sepenuhnya.

  4. 04Unduh hasilnya

    Ambil file dari halaman pemeriksaan massal. Anda hanya membayar untuk entri yang benar-benar mengembalikan hasil; selisihnya dikembalikan.

Field hasil

Kolom dalam file hasil

Unduhan berupa satu file CSV dengan tabel hasil lengkap.

Kolom file hasil

  • identifier · alex_kim — Nama pengguna yang dikirim, tanpa @ atau t.me/ (mis. alex_kim).
  • activated · true — Apakah nama pengguna milik akun Telegram yang ada: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
  • uid · 1234567890 — ID pengguna Telegram; dapat kosong bahkan untuk akun yang ada.
  • activedays · 9 — Jumlah hari sejak akun terakhir terlihat, sebagai bilangan bulat — semakin kecil semakin baru. Jika akun menyembunyikan waktu terakhir terlihat yang tepat, Telegram hanya menampilkan rentang, dan nilainya berupa perkiraan: 0 (baru-baru ini), 7 (dalam seminggu), 30 (dalam sebulan), atau 1000 (sudah lama). Dapat kosong jika akun tidak menampilkan informasi terakhir terlihat.
  • avatar_url · https://cdn5.telesco.pe/file/example.jpg — URL avatar; kosong jika akun tidak memiliki avatar.

Paling cocok untuk

Kapan menggunakan produk ini

  • Tinjauan audiens

    Periksa nama pengguna mana yang milik akun sungguhan dan simpan ID serta avatarnya dalam satu file.

  • Analisis komunitas

    Urutkan daftar nama pengguna ke dalam tingkatan berdasarkan kapan terakhir setiap akun online.

  • Pengayaan data kontak

    Lengkapi ID pengguna dan avatar untuk daftar nama pengguna.

Jawaban langsung

Apa itu Profil nama pengguna Telegram massal?

Pencarian nama pengguna Telegram massal menerima nama pengguna alih-alih nomor dan, selain memastikan akun ada, mengembalikan ID pengguna, hari aktif, dan URL avatar. Tidak perlu memilih negara; satu nama pengguna per baris, dengan atau tanpa awalan @ atau t.me/.

Batasan yang jelas

Batasan produk ini

  • Hasil mencerminkan saat tugas dijalankan. Avatar bisa berubah — jalankan lagi untuk status terbaru, hasil yang tersimpan tidak pernah diperbarui secara otomatis.
  • Ini bukan pemeriksaan keterjangkauan atau aktivitas, dan bukan verifikasi identitas.
  • Tidak ada yang dikirim ke pengenal di dalam file.
  • Kolom yang dikembalikan tergantung platformnya. Kolom-kolom tersebut tercantum di halaman ini sebelum Anda mengunggah.
  • Tautan unduhan memiliki masa berlaku. Ambil file segera setelah tugas selesai; jika tautan kedaluwarsa, periksa tugas lagi untuk mendapatkan tautan baru.

Kapan massal cocok

Kapan massal sepadan — dan kapan real-time lebih cepat

Pemeriksaan real-timePemeriksaan massal
Berapa banyak pengenal1 pengenal per pemeriksaan tunggal; beberapa per permintaan multi — batas pastinya ada di dokumentasi APISeluruh daftar besar dalam satu tugas — rentang ukuran saat ini ada di halaman harga
Mendapatkan hasilLangsung: endpoint tunggal dan multi menjawab dalam respons yang sama; dasbor mengembalikannya satu per satuUnduh file hasil setelah tugas selesai
NegaraTidak perlu dipilih — pencarian real-time dikirim satu per satu, tidak dikelompokkan per negaraSatu negara per tugas, dipilih saat mengunggah dan dikirim bersama file
Bentuk hasilJSON, field per itemFile hasil (satu CSV dengan tabel lengkap)
Penggunaan umumValidasi formulir, pencarian oleh agen, penyaringan sebelum pengirimanPembersihan daftar, penyaringan sebelum kampanye, pembersihan data tersimpan

Pemeriksaan real-time · Lihat harga

FAQ produk

Tentang Profil nama pengguna Telegram

Kapan saya sebaiknya menggunakan massal alih-alih pemeriksaan real-time?

Gunakan massal untuk daftar besar secara utuh. Untuk beberapa pengenal saja, pemeriksaan real-time menjawab dalam permintaan yang sama, tanpa tugas yang perlu dijadwalkan.

Apa yang terjadi pada pengenal yang tidak valid di dalam file?

Pemeriksaan awal membuang baris yang formatnya salah, sehingga tidak pernah masuk ke jumlah yang ditagihkan. Dari nomor yang tersisa, nomor yang tidak dapat diselesaikan oleh layanan hulu juga tidak ditagihkan. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil.

Berapa lama sebuah tugas berlangsung?

Tergantung jumlah entri dan produknya. Anda dapat menutup halaman setelah mengirim; tugas berjalan di latar belakang dan hasilnya menunggu Anda di halaman pemeriksaan massal.

Apakah saya mendapatkan pengembalian dana jika gagal?

Ya. Tugas yang gagal dikembalikan sepenuhnya. Jika tugas berhasil tetapi beberapa entri tidak mengembalikan apa pun, bagian tersebut dikembalikan secara otomatis. Selisih antara jumlah yang dicadangkan dan yang benar-benar ditagih selalu dikembalikan.

Produk terkait

Produk massal lainnya

Analisis avatar WhatsApp · MassalUnggah seluruh file nomor: URL avatar WhatsApp beserta isi avatarnya — kategori, usia, gender, warna kulit, dan warna rambut.Profil nomor Telegram · MassalUnggah nomor: ID pengguna Telegram, nama pengguna, hari aktif, dan URL avatar, beserta usia, gender, dan warna kulit yang dikenali dari avatar.Profil nomor Viber · MassalUnggah nomor: ID anggota Viber, hari aktif, dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.Profil nomor MAX · MassalUnggah nomor: ID pengguna MAX, URL avatar, dan gender.Analisis avatar LINE · MassalUnggah nomor: ID pengguna LINE dan URL avatar, beserta kategori, usia, gender, warna kulit, dan warna rambut yang dikenali dari avatar.Profil nomor Zalo · MassalUnggah nomor: ID pengguna Zalo dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.Pemeriksaan avatar email · MassalUnggah alamat Gmail, Yandex, atau Mail.ru: apakah setiap alamat dapat dikirimi, beserta avatarnya.

Buat akun untuk mengirim tugas massal

Pemeriksaan massal dan real-time menggunakan saldo yang sama — tidak ada yang perlu diaktifkan tambahan. Daftar dan unggah file pertama Anda di halaman pemeriksaan massal.

Daftar Lihat harga