Referensi

AvatarLookup Referensi API

Setiap endpoint berbagi satu kunci API dan satu saldo.

Item	Nilai
URL dasar	https://avatarlookup.com
Header autentikasi	X-API-Key: sk_your_api_key
Amplop respons	{ code, msg, data }

Harga tidak dicantumkan di sini; setiap produk ditagihkan per pemeriksaan yang berhasil. Lihat harga

Autentikasi

Gunakan kunci API yang dibuat di Pengaturan dan kirimkan bersama setiap permintaan.

Header autentikasi

X-API-Key: sk_your_api_key

Jaga kerahasiaan kunci API AndaSelalu panggil endpoint ini dari server Anda. Siapa pun yang memegang kunci dapat menghabiskan saldo Anda.

Pemeriksaan sinkron

POST/api/v1/checkPOST/api/v1/batch-checkPOST/api/v1/image/profile

Kirim satu pengenal, atau hingga 100 dalam satu permintaan, dan baca hasilnya dalam respons yang sama. Tanpa polling, tanpa callback. Hasil yang tidak dapat ditentukan mengembalikan 422 dengan code 42200 dan tidak ditagih. Permintaan multi mempertahankan urutan input, menagih setiap pengenal secara terpisah, dan memiliki waktu 300 detik untuk selesai — jika tidak, seluruh permintaan gagal dan setiap tagihan dikembalikan. Profil gambar menggunakan endpoint tersendiri, /api/v1/image/profile, dan menerima gambar alih-alih pengenal.

Parameter

Field	Tipe	Deskripsi
`service_type`	string	Kode produk, salah satu produk yang tercantum di bawah.
`identifier`	string	Pemeriksaan tunggal: satu pengenal. Server menormalkannya.
`identifiers`	string[]	Pemeriksaan multi: 1 hingga 100 pengenal. Respons mempertahankan urutan ini.
`file`	file	Profil gambar: satu gambar potret (unggahan multipart). Tidak ada `identifier`.

Produk dalam grup ini

Analisis profil gambarimage_profileUnggah gambar apa pun dan dapatkan atribut potretnya: perkiraan usia, gender, jenis gambar, warna rambut, dan warna kulit.Halaman produk
Analisis avatar WhatsAppws_profilePeriksa apakah sebuah nomor memiliki avatar WhatsApp, dapatkan URL gambarnya, dan baca atribut potret dari avatar tersebut.Halaman produk
Analisis avatar emailemail_profilePeriksa apakah akun email memiliki avatar dan baca atribut potretnya. Mencakup Gmail, Yandex, dan Mail.ru.Halaman produk

Analisis profil gambar

image_profilegambar

Unggah gambar apa pun dan dapatkan atribut potretnya: perkiraan usia, gender, jenis gambar, warna rambut, dan warna kulit.

Pemeriksaan tunggal

POST/api/v1/image/profile

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/image/profile" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=image_profile \
  -F file=@portrait.jpg

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "image_profile",
    "identifier": "img:7013df96c540904a4b7ba295e9162ab2",
    "category": "individual portrait",
    "age": 39,
    "gender": "male",
    "skin_color": "white",
    "hair_color": "brown"
  }
}

Field respons

Field	Tipe	Deskripsi
`identifier`	string	Sidik jari gambar yang dikirim, diturunkan dari isinya. Gambar yang sama selalu menghasilkan nilai yang sama.
`category`	string	Apa isi gambar: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar, atau object. unknown jika tidak ada potret yang dapat dihasilkan.
`age`	integer	Perkiraan usia sebagai bilangan bulat, akurat hingga sekitar 3 tahun dan dibatasi pada rentang 0-80. Dihilangkan jika tidak dapat diperkirakan (misalnya jika gender tidak dapat ditentukan).
`gender`	string	male, female, atau unknown.
`skin_color`	string	Warna kulit deskriptif, misalnya white, east_asian, atau hispanic. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.
`hair_color`	string	Warna rambut deskriptif, misalnya black, brown, blond, atau gray white. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.

Analisis avatar WhatsApp

ws_profiletelepon

Periksa apakah sebuah nomor memiliki avatar WhatsApp, dapatkan URL gambarnya, dan baca atribut potret dari avatar tersebut.

Pemeriksaan tunggal

POST/api/v1/check

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_profile", "identifier": "+17253100591" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_profile",
    "identifier": "+17253100591",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://pps.whatsapp.net/v/example.jpg",
    "category": "individual portrait",
    "age": 39,
    "gender": "male",
    "skin_color": "white",
    "hair_color": "brown"
  }
}

Field respons

Field	Tipe	Deskripsi
`registered`	boolean	Apakah nomor terdaftar di WhatsApp.
`avatar`	boolean	Apakah avatar dipasang.
`avatar_url`	string	URL avatar; string kosong jika tidak ada foto yang dipasang.
`category`	string	Apa isi gambar: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar, atau object. unknown jika tidak ada potret yang dapat dihasilkan.
`age`	integer	Perkiraan usia sebagai bilangan bulat, akurat hingga sekitar 3 tahun dan dibatasi pada rentang 0-80. Dihilangkan jika tidak dapat diperkirakan (misalnya jika gender tidak dapat ditentukan).
`gender`	string	male, female, atau unknown.
`skin_color`	string	Warna kulit deskriptif, misalnya white, east_asian, atau hispanic. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.
`hair_color`	string	Warna rambut deskriptif, misalnya black, brown, blond, atau gray white. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.

Pemeriksaan multi

POST/api/v1/batch-check

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_profile", "identifiers": ["+17253100591", "+14155550000", "12345"] }'

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_profile",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "+17253100591",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "https://pps.whatsapp.net/v/example.jpg",
        "category": "individual portrait",
        "age": 39,
        "gender": "male",
        "skin_color": "white",
        "hair_color": "brown"
      },
      {
        "identifier": "+14155550000",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": "",
        "category": "unknown",
        "gender": "unknown",
        "skin_color": "unknown",
        "hair_color": "unknown"
      },
      {
        "identifier": "12345",
        "exists": false
      }
    ]
  }
}

Field respons

Field	Tipe	Deskripsi
`exists`	boolean	Apakah pengenal ini menghasilkan hasil. false berarti formatnya tidak valid, hasilnya tidak dapat ditentukan, atau pemeriksaan gagal; jika false, tidak ada field di bawah ini yang disertakan.
`registered`	boolean	Apakah akun ada di platform tersebut (untuk alamat email: apakah dapat dijangkau). Hanya disertakan jika exists bernilai true, dengan arti yang sama seperti pencarian tunggal.
`avatar`	boolean	Apakah avatar dipasang.
`avatar_url`	string	URL avatar; string kosong jika tidak ada foto yang dipasang.
`category`	string	Apa isi gambar: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar, atau object. unknown jika tidak ada potret yang dapat dihasilkan.
`age`	integer	Perkiraan usia sebagai bilangan bulat, akurat hingga sekitar 3 tahun dan dibatasi pada rentang 0-80. Dihilangkan jika tidak dapat diperkirakan (misalnya jika gender tidak dapat ditentukan).
`gender`	string	male, female, atau unknown.
`skin_color`	string	Warna kulit deskriptif, misalnya white, east_asian, atau hispanic. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.
`hair_color`	string	Warna rambut deskriptif, misalnya black, brown, blond, atau gray white. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.

Analisis avatar email

email_profileemail

Periksa apakah akun email memiliki avatar dan baca atribut potretnya. Mencakup Gmail, Yandex, dan Mail.ru.

Pemeriksaan tunggal

POST/api/v1/check

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_profile", "identifier": "alex.kim@gmail.com" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_profile",
    "identifier": "alex.kim@gmail.com",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://lh3.googleusercontent.com/a/example",
    "category": "individual portrait",
    "age": 39,
    "gender": "male",
    "skin_color": "white",
    "hair_color": "brown"
  }
}

Field respons

Field	Tipe	Deskripsi
`registered`	boolean	Apakah alamat email dapat dijangkau (dapat menerima email).
`avatar`	boolean	Apakah avatar dipasang.
`avatar_url`	string	URL avatar; string kosong jika tidak ada avatar yang dipasang.
`category`	string	Apa isi gambar: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar, atau object. unknown jika tidak ada potret yang dapat dihasilkan.
`age`	integer	Perkiraan usia sebagai bilangan bulat, akurat hingga sekitar 3 tahun dan dibatasi pada rentang 0-80. Dihilangkan jika tidak dapat diperkirakan (misalnya jika gender tidak dapat ditentukan).
`gender`	string	male, female, atau unknown.
`skin_color`	string	Warna kulit deskriptif, misalnya white, east_asian, atau hispanic. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.
`hair_color`	string	Warna rambut deskriptif, misalnya black, brown, blond, atau gray white. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.

Pemeriksaan multi

POST/api/v1/batch-check

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_profile", "identifiers": ["alex.kim@gmail.com", "no.such.user@gmail.com", "not-an-email"] }'

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_profile",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "alex.kim@gmail.com",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "https://lh3.googleusercontent.com/a/example",
        "category": "individual portrait",
        "age": 39,
        "gender": "male",
        "skin_color": "white",
        "hair_color": "brown"
      },
      {
        "identifier": "no.such.user@gmail.com",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": "",
        "category": "unknown",
        "gender": "unknown",
        "skin_color": "unknown",
        "hair_color": "unknown"
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}

Field respons

Field	Tipe	Deskripsi
`exists`	boolean	Apakah pengenal ini menghasilkan hasil. false berarti formatnya tidak valid, hasilnya tidak dapat ditentukan, atau pemeriksaan gagal; jika false, tidak ada field di bawah ini yang disertakan.
`registered`	boolean	Apakah akun ada di platform tersebut (untuk alamat email: apakah dapat dijangkau). Hanya disertakan jika exists bernilai true, dengan arti yang sama seperti pencarian tunggal.
`avatar`	boolean	Apakah avatar dipasang.
`avatar_url`	string	URL avatar; string kosong jika tidak ada avatar yang dipasang.
`category`	string	Apa isi gambar: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar, atau object. unknown jika tidak ada potret yang dapat dihasilkan.
`age`	integer	Perkiraan usia sebagai bilangan bulat, akurat hingga sekitar 3 tahun dan dibatasi pada rentang 0-80. Dihilangkan jika tidak dapat diperkirakan (misalnya jika gender tidak dapat ditentukan).
`gender`	string	male, female, atau unknown.
`skin_color`	string	Warna kulit deskriptif, misalnya white, east_asian, atau hispanic. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.
`hair_color`	string	Warna rambut deskriptif, misalnya black, brown, blond, atau gray white. Perlakukan sebagai kumpulan terbuka; unknown jika tidak dapat ditentukan.

Pemeriksaan asinkron

POST/api/v1/bulk-tasksGET/api/v1/bulk-tasks/{id}

Unggah file dan langsung dapatkan ID tugas, lalu periksa ID tersebut sampai berhasil. Respons yang berhasil membawa result_url, tautan unduhan hasil. Hanya ada dua tindakan: kirim dan periksa. Lakukan polling tidak lebih sering dari sekali setiap 30 detik.

Parameter

Field	Tipe	Deskripsi
`service_type`	string	Kode produk massal, salah satu produk yang tercantum di bawah.
`country`	string	Kode ISO 3166-1 seperti `US`. Wajib untuk tugas nomor: setiap nomor harus menyertakan kode negaranya dan berasal dari negara ini (nomor yang tidak memenuhi akan dikecualikan dan tidak ditagihkan); juga menentukan perutean. Dalam multipart, field ini harus berada sebelum `file`.
`file`	file	File `.txt` atau `.csv` dengan satu pengenal per baris, hingga `max_file_bytes` (default 20MB).
`Idempotency-Key`	header	Opsional, hingga 128 karakter. Mengirim ulang kunci yang sama mengembalikan tugas asli alih-alih membuat tugas kedua.

Produk dalam grup ini

Analisis avatar WhatsApp · Massalws_profile_batchUnggah seluruh file nomor: URL avatar WhatsApp beserta isi avatarnya — kategori, usia, gender, warna kulit, dan warna rambut.Halaman produk
Profil nomor Telegram · Massaltg_profile_batchUnggah nomor: ID pengguna Telegram, nama pengguna, hari aktif, dan URL avatar, beserta usia, gender, dan warna kulit yang dikenali dari avatar.Halaman produk
Profil nama pengguna Telegram · Massaltg_username_profile_batchUnggah nama pengguna Telegram: ID pengguna, hari aktif, dan URL avatar untuk setiap akun.Halaman produk
Profil nomor Viber · Massalviber_profile_batchUnggah nomor: ID anggota Viber, hari aktif, dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.Halaman produk
Profil nomor MAX · Massalmax_profile_batchUnggah nomor: ID pengguna MAX, URL avatar, dan gender.Halaman produk
Analisis avatar LINE · Massalline_profile_batchUnggah nomor: ID pengguna LINE dan URL avatar, beserta kategori, usia, gender, warna kulit, dan warna rambut yang dikenali dari avatar.Halaman produk
Profil nomor Zalo · Massalzalo_profile_batchUnggah nomor: ID pengguna Zalo dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.Halaman produk
Pemeriksaan avatar email · Massalemail_avatar_batchUnggah alamat Gmail, Yandex, atau Mail.ru: apakah setiap alamat dapat dikirimi, beserta avatarnya.Halaman produk

Analisis avatar WhatsApp · Massal

ws_profile_batchtelepon1.000–500.000 per tugas

Unggah seluruh file nomor: URL avatar WhatsApp beserta isi avatarnya — kategori, usia, gender, warna kulit, dan warna rambut.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_profile_batch",
    "status": "processing",
    "country": "US",
    "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_profile_batch",
    "status": "success",
    "country": "US",
    "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"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`identifier`	17253100591	Nomor yang dikirim dalam bentuk digit polos dengan kode negara, tanpa tanda plus atau spasi (mis. 17253100591).
`activated`	true	Apakah nomor terdaftar di WhatsApp: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
`avatar_url`	https://pps.waavatar.xyz/v/example.jpg	URL avatar; kosong jika akun tidak memiliki avatar.
`category`	individual portrait	Apa yang ditampilkan avatar: individual portrait, group photo, cartoon avatar, pet avatar, landscape, object, dan sebagainya; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`age`	31	Usia yang diperkirakan dari avatar; kosong jika tidak dapat diperkirakan.
`gender`	male	Gender yang diperkirakan dari avatar: male atau female; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`skin_color`	east_asian	Warna kulit yang diperkirakan dari avatar, mis. white, asian, east_asian; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`hair_color`	black	Warna rambut yang diperkirakan dari avatar, mis. black, brown; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.

Profil nomor Telegram · Massal

tg_profile_batchtelepon1.000–500.000 per tugas

Unggah nomor: ID pengguna Telegram, nama pengguna, hari aktif, dan URL avatar, beserta usia, gender, dan warna kulit yang dikenali dari avatar.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_profile_batch",
    "status": "processing",
    "country": "US",
    "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_profile_batch",
    "status": "success",
    "country": "US",
    "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"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`identifier`	17253100591	Nomor yang dikirim dalam bentuk digit polos dengan kode negara, tanpa tanda plus atau spasi (mis. 17253100591).
`activated`	true	Apakah nomor terdaftar di Telegram: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
`uid`	1234567890	ID pengguna Telegram.
`username`	alex_kim	Nama pengguna, kosong jika akun tidak memilikinya.
`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).
`avatar_url`	https://telegram.waavatar.xyz/v/example.jpg	URL avatar; kosong jika akun tidak memiliki avatar.
`age`	31	Usia yang diperkirakan dari avatar; kosong jika tidak dapat diperkirakan.
`gender`	male	Gender yang diperkirakan dari avatar: male atau female; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`skin_color`	white	Warna kulit yang diperkirakan dari avatar, mis. white, asian, east_asian; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.

Profil nama pengguna Telegram · Massal

tg_username_profile_batchnama pengguna1.000–500.000 per tugas

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

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

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

{
  "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "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"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`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.

Profil nomor Viber · Massal

viber_profile_batchtelepon1.000–500.000 per tugas

Unggah nomor: ID anggota Viber, hari aktif, dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=viber_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "viber_profile_batch",
    "status": "processing",
    "country": "US",
    "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "viber_profile_batch",
    "status": "success",
    "country": "US",
    "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"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`identifier`	17253100591	Nomor yang dikirim dalam bentuk digit polos dengan kode negara, tanpa tanda plus atau spasi (mis. 17253100591).
`activated`	true	Apakah nomor terdaftar di Viber: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
`uid`	A5qCVDb3jPU=	ID anggota Viber.
`activedays`	3	Jumlah hari sejak akun terakhir online — semakin kecil semakin baru.
`avatar_url`	https://viber.waavatar.xyz/v/example.jpg	URL avatar; kosong jika akun tidak memiliki avatar.
`category`	individual portrait	Apa yang ditampilkan avatar: individual portrait, group photo, cartoon avatar, pet avatar, landscape, object, dan sebagainya; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`age`	31	Usia yang diperkirakan dari avatar; kosong jika tidak dapat diperkirakan.
`gender`	male	Gender yang diperkirakan dari avatar: male atau female; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`skin_color`	white	Warna kulit yang diperkirakan dari avatar, mis. white, asian, east_asian; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.

Profil nomor MAX · Massal

max_profile_batchtelepon1.000–500.000 per tugas

Unggah nomor: ID pengguna MAX, URL avatar, dan gender.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=max_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "max_profile_batch",
    "status": "processing",
    "country": "US",
    "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "max_profile_batch",
    "status": "success",
    "country": "US",
    "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"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`identifier`	17253100591	Nomor yang dikirim dalam bentuk digit polos dengan kode negara, tanpa tanda plus atau spasi (mis. 17253100591).
`activated`	true	Apakah nomor terdaftar di MAX: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
`uid`	343064807	ID pengguna MAX.
`avatar_url`	https://i.oneme.ru/i?r=example	URL avatar; kosong jika akun tidak memiliki avatar.
`gender`	male	Gender akun: male atau female; kosong jika tidak diketahui.

Analisis avatar LINE · Massal

line_profile_batchtelepon2.000–500.000 per tugas

Unggah nomor: ID pengguna LINE dan URL avatar, beserta kategori, usia, gender, warna kulit, dan warna rambut yang dikenali dari avatar.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=line_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "line_profile_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 2027,
    "total": 2027,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "line_profile_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 2027,
    "total": 2000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 24,
    "preparing": false,
    "success_cnt": 1980,
    "failure_cnt": 20,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`identifier`	17253100591	Nomor yang dikirim dalam bentuk digit polos dengan kode negara, tanpa tanda plus atau spasi (mis. 17253100591).
`activated`	true	Apakah nomor terdaftar di LINE: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
`uid`	u5158553776c28d9164035c4fd0a07cd4	ID pengguna LINE.
`avatar_url`	https://profile.line-scdn.net/example	URL avatar; kosong jika akun tidak memiliki avatar.
`category`	individual portrait	Apa yang ditampilkan avatar: individual portrait, group photo, cartoon avatar, pet avatar, landscape, object, dan sebagainya; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`age`	31	Usia yang diperkirakan dari avatar; kosong jika tidak dapat diperkirakan.
`gender`	male	Gender yang diperkirakan dari avatar: male atau female; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`skin_color`	east_asian	Warna kulit yang diperkirakan dari avatar, mis. white, asian, east_asian; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`hair_color`	black	Warna rambut yang diperkirakan dari avatar, mis. black, brown; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.

Profil nomor Zalo · Massal

zalo_profile_batchtelepon1.000–500.000 per tugas

Unggah nomor: ID pengguna Zalo dan URL avatar, beserta kategori, usia, gender, dan warna kulit yang dikenali dari avatar.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=zalo_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "zalo_profile_batch",
    "status": "processing",
    "country": "US",
    "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "zalo_profile_batch",
    "status": "success",
    "country": "US",
    "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"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`identifier`	17253100591	Nomor yang dikirim dalam bentuk digit polos dengan kode negara, tanpa tanda plus atau spasi (mis. 17253100591).
`activated`	true	Apakah nomor terdaftar di Zalo: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
`uid`	452114152	ID pengguna Zalo.
`avatar_url`	https://s160-ava-talk.zadn.vn/example.jpg	URL avatar; kosong jika akun tidak memiliki avatar.
`category`	individual portrait	Apa yang ditampilkan avatar: individual portrait, group photo, cartoon avatar, pet avatar, landscape, object, dan sebagainya; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`age`	31	Usia yang diperkirakan dari avatar; kosong jika tidak dapat diperkirakan.
`gender`	male	Gender yang diperkirakan dari avatar: male atau female; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.
`skin_color`	asian	Warna kulit yang diperkirakan dari avatar, mis. white, asian, east_asian; unknown jika tidak dapat dikenali, kosong jika tidak ada avatar.

Pemeriksaan avatar email · Massal

email_avatar_batchemail1.000–500.000 per tugas

Unggah alamat Gmail, Yandex, atau Mail.ru: apakah setiap alamat dapat dikirimi, beserta avatarnya.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_avatar_batch \
  -F file=@emails.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_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"
  }
}

Kolom hasil

Field	contoh:	Deskripsi
`identifier`	alex.kim@gmail.com	Alamat yang dikirim, dalam huruf kecil.
`activated`	true	Apakah alamat dapat dikirimi di penyedia tersebut — apakah dapat menerima email: true atau false. Jika nilainya bukan true, semua kolom lain di baris tersebut dibiarkan kosong.
`avatar`	true	Apakah avatar dipasang: true atau false. avatar_url tetap bisa kosong jika gambar tidak tersedia.
`avatar_url`	https://lh3.googleusercontent.com/a/example	URL avatar; kosong jika tidak ada URL yang tersedia.

Saldo

GET/api/v1/balance

Baca saldo akun saat ini dalam mikro USD. Hanya-baca: tidak membuat catatan pemeriksaan dan tidak menagih apa pun.

Saldo

GET/api/v1/balance

Permintaan

curl "https://avatarlookup.com/api/v1/balance" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "balance_micros": 12500000
  }
}

Konkurensi, batas waktu, dan perilaku percobaan ulang

Pencarian avatar bersifat sinkron. Gunakan code yang dikembalikan untuk memutuskan apakah menerima hasil atau mencoba lagi nanti.

Field	Deskripsi
`5 permintaan berjalan per pengguna`	Pemeriksaan tunggal dan multi berbagi batas ini, dan satu permintaan multi dihitung sebagai satu permintaan berapa pun jumlah pengenal yang dibawanya. Selain itu, hanya satu pemeriksaan multi per akun yang berjalan pada satu waktu; pemeriksaan kedua ditolak sampai yang pertama selesai. Mencapai salah satu batas akan langsung mengembalikan code 42901 tanpa tagihan, disertai header Retry-After — kirim ulang setelah permintaan yang sedang berjalan selesai.
`60 dtk tunggal, 300 dtk multi`	Melebihi batas waktu mengembalikan code 50400 tanpa tagihan. Pemeriksaan multi yang kehabisan waktu gagal secara keseluruhan — tanpa hasil parsial, dan seluruh jumlah dikembalikan.
`Pemeriksaan multi menerima hingga 100 pengenal`	Hasil mempertahankan urutan dan jumlah seperti yang dikirim. Satu pemeriksaan multi per akun berjalan dalam satu waktu; kirim batch berikutnya setelah batch sebelumnya kembali.

Kode error

Kode	Deskripsi
`40000`	Tipe layanan tidak didukung atau field permintaan saling bertentangan
`40001`	Body JSON tidak valid
`40002`	Pengenal tidak valid
`40100`	Kunci API tidak ada atau tidak valid
`40200`	Saldo tidak mencukupi
`42200`	Pengenal tidak dapat ditentukan saat ini. Tidak ada data yang dikembalikan dan permintaan tidak ditagih
`42900`	Kuota penggunaan habis, atau terlalu banyak pesanan yang belum selesai
`42901`	Kelima slot permintaan yang sedang berjalan sudah terisi, atau pemeriksaan multi sudah berjalan di akun ini; kirim setelah permintaan yang sedang berjalan selesai. Permintaan yang ditolak tidak ditagih dan menyertakan header Retry-After
`50303`	Layanan sedang mencapai kapasitas penuh; tidak ditagih. Tunggu selama detik Retry-After lalu kirim ulang permintaan yang sama
`50400`	Pemeriksaan tidak selesai dalam batas waktunya dan tidak ditagihkan; coba lagi. Batas waktu batch membuat seluruh batch gagal dan seluruh jumlah dikembalikan
`50300`	Pemeliharaan layanan validasi