POST /api/v1/bulk-taskscurl -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
Toplu ürün viber_profile_batch
Numara yükleyin: Viber üye kimliği, aktif gün sayısı ve profil fotoğrafı URL'si ile profil fotoğrafından tanınan kategori, yaş, cinsiyet ve ten rengi.
Büyük listelerin tamamı için bir ek seçenek — birkaç tanımlayıcı için gerçek zamanlı kontrol aynı istekte yanıt verir. Gerçek zamanlı kontrol →
API sözleşmesi
Gönderim hemen bir görev kimliği döndürür; görevi bu kimlikle kontrol edin ve başarılı olduğunda yanıt, sonuç dosyasının indirme bağlantısını içerir. Her istek kendi yanıtıyla birlikte gösterilir.
Görev kimliği hemen döner ve dosya arka planda hazırlanırken preparing true olarak ayarlanır: geçersiz satırlar, yinelenenler ve — numara görevleri için — ülke kodu olmayan veya başka bir ülkeye ait numaralar çıkarılır ve ücretlendirilmez. Gönderilen satırlar için bakiye ayrılır ve tamamlandığında hesaplaşma yapılır; fark iade edilir.
POST /api/v1/bulk-taskscurl -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.txt200 OK{
"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"
}
}Görev kimliğiyle yoklama yapın. Hazırlık tamamlandığında submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt olur; burada total, kontrol edilen ve ücretlendirilen sayıdır. Başarılı bir yanıt, başarılı ve başarısız sayılarını ve sonuç dosyasının indirme bağlantısını içerir; hazırlık sırasında reddedilen bir görev reason_detail ile failed durumuna geçer ve tamamı iade edilir.
GET /api/v1/bulk-tasks/{id}curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"200 OK{
"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"
}
}Nasıl çalışır
Toplu kontrol, gerçek zamanlı kontrolün büyütülmüş hâli değildir — bir kez gönderilir, arka planda çalışır, daha sonra alınır. Sayfayı açık tutmanız gerekmez; görev durumu ve sonuçlar panelinizde kalır.
Her satırda bir numara bulunan bir .txt veya .csv dosyası. Doğrudan akış olarak iletilir; diske hiçbir şey yazılmaz.
Belirgin sorunlar (boş dosya, yanlış biçim, çok az satır) yükleme sırasında reddedilir. Ardından bakiye ayrılır ve dosya arka planda hazırlanır: yinelenen ve geçersiz satırlar çıkarılır ve ülke kuralı kontrol edilir. Bu aşamada başarısız olan bir dosya, tamamen iade edilen başarısız bir görev olarak sonuçlanır; aksi halde yalnızca kalan satırlar kontrol edilir ve görev tamamlandığında hesaplaşılır.
Görev kendi başına çalışır — isterseniz sayfayı kapatın. Bir hata hemen bildirilir ve tamamı iade edilir.
Dosyayı toplu kontrol sayfasından alın. Yalnızca gerçekten sonuç döndüren kayıtlar için ödeme yaparsınız; aradaki fark iade edilir.
Sonuç alanları
İndirilen dosya, tam sonuç tablosunu içeren tek bir CSV dosyasıdır.
identifier · 17253100591 — Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).activated · true — Numaranın Viber'da kayıtlı olup olmadığı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.uid · A5qCVDb3jPU= — Viber üye kimliği.activedays · 3 — Hesabın son çevrimiçi olmasından bu yana geçen gün sayısı — küçük değer daha yakın zamanı gösterir.avatar_url · https://viber.waavatar.xyz/v/example.jpg — Profil fotoğrafı URL'si; hesabın profil fotoğrafı yoksa boştur.category · individual portrait — Profil fotoğrafının neyi gösterdiği: individual portrait, group photo, cartoon avatar, pet avatar, landscape, object vb.; tanınamadığında unknown, profil fotoğrafı yoksa boştur.age · 31 — Profil fotoğrafından tahmin edilen yaş; tahmin edilemediğinde boştur.gender · male — Profil fotoğrafından tahmin edilen cinsiyet: male veya female; tanınamadığında unknown, profil fotoğrafı yoksa boştur.skin_color · white — Profil fotoğrafından tahmin edilen ten rengi, ör. white, asian, east_asian; tanınamadığında unknown, profil fotoğrafı yoksa boştur.En uygun kullanım
activatedactivedayscategoryViber numara listelerini hesap sonucuna, son etkinliğe ve profil fotoğrafının ne gösterdiğine göre düzenleyin.
Örnek: bir veri incelemesinden önce bireysel portreleri grup fotoğraflarından ayırın.
uidavatar_urlDaha hızlı tanıma ve temizlik için üye kimliklerini ve profil fotoğrafı bağlantılarını mevcut kişilere aktarın.
Örnek: bir CRM dışa aktarımındaki eksik kişi fotoğraflarını ve kalıcı üye tanımlayıcılarını doldurun.
activedaysgenderageEkiplerin ayrı dosyalar arasında geçiş yapmadan bir listeyi inceleyebilmesi için etkinlik ve profil özelliklerini bir arada tutun.
Örnek: özellikleri eksiksiz aktif profiller için bir operatör kuyruğu hazırlayın.
activatedavatar_urlcategoryBir sonraki içe aktarımdan önce hesap sonucu olmayan, kullanılabilir profil fotoğrafı olmayan veya görseli tanınamayan kayıtları bulun.
Örnek: iyi kayıtların üzerine yazmak yerine eksik satırları manuel incelemeye yönlendirin.
Doğrudan yanıt
Toplu Viber profil fotoğrafı sorgulaması, kayıtlı her numara için Viber üye kimliğini, hesabın son çevrimiçi olmasından bu yana kaç gün geçtiğini, profil fotoğrafı URL'sini ve profil fotoğrafından tanınan özellikleri döndürür: kategori, yaş, cinsiyet ve ten rengi. Yükleme sırasında numaraların ait olduğu ülkeyi seçin.
Net sınırlar
Toplu kontrol ne zaman uygun
| Gerçek zamanlı kontrol | Toplu kontrol | |
|---|---|---|
| Kaç tanımlayıcı | Tekil kontrol başına 1 tanımlayıcı; çoklu istek başına birkaç tane — kesin üst sınırlar API belgelerinde | Tek görevde büyük bir listenin tamamı — güncel boyut aralığı fiyatlandırma sayfasında yer alır |
| Sonuçları alma | Hemen: tekli ve çoklu uç nokta aynı yanıtta cevap verir; panel sonuçları tek tek döndürür | Görev tamamlandığında bir sonuç dosyası indirin |
| Ülke | Seçim gerekmez — gerçek zamanlı sorgulamalar ülkeye göre gruplanmadan tek tek gönderilir | Görev başına bir ülke; yüklemede seçilir ve dosyayla birlikte gönderilir |
| Sonuç biçimi | JSON, kayıt başına alanlar | Sonuç dosyası (tablonun tamamını içeren tek bir CSV) |
| Tipik kullanım | Form doğrulama, temsilci sorgulamaları, gönderim öncesi kontrol | Liste temizliği, kampanya öncesi filtreleme, saklanan verilerin temizlenmesi |
Ürün SSS
Büyük bir listenin tamamı için toplu kontrolü kullanın. Birkaç tanımlayıcı için gerçek zamanlı kontrol, planlanacak bir görev olmadan aynı istekte yanıt verir.
Ön kontrol hatalı biçimlendirilmiş satırları çıkarır, böylece bunlar asla ücretlendirilebilir sayıya girmez. Kalan numaralardan kontrol hizmetinin çözemedikleri de ücretlendirilmez. Yalnızca gerçekten sonuç döndüren numaralar için ödeme yaparsınız.
Kayıt sayısına ve ürüne bağlıdır. Gönderdikten sonra sayfayı kapatabilirsiniz; görev arka planda çalışır ve sonuç sizi toplu kontrol sayfasında bekler.
Evet. Başarısız bir görev tamamen iade edilir. Görev başarılı olur ancak bazı kayıtlar hiçbir şey döndürmezse, o kısım otomatik olarak iade edilir. Ayrılan tutar ile gerçekte ücretlendirilen tutar arasındaki fark her zaman geri döner.
İlgili ürünler
WhatsApp profil fotoğrafı analizi · TopluNumaralardan oluşan bir dosyanın tamamını yükleyin: WhatsApp profil fotoğrafı URL'si ve profil fotoğrafının gösterdikleri — kategori, yaş, cinsiyet, ten rengi ve saç rengi.
Telegram numara profili · TopluNumara yükleyin: Telegram kullanıcı kimliği, kullanıcı adı, aktif gün sayısı ve profil fotoğrafı URL'si ile profil fotoğrafından tanınan yaş, cinsiyet ve ten rengi.
Telegram kullanıcı adı profili · TopluTelegram kullanıcı adlarını yükleyin: her hesap için kullanıcı kimliği, aktif gün sayısı ve profil fotoğrafı URL'si.
MAX numara profili · TopluNumara yükleyin: MAX kullanıcı kimliği, profil fotoğrafı URL'si ve cinsiyet.
LINE profil fotoğrafı analizi · TopluNumara yükleyin: LINE kullanıcı kimliği ve profil fotoğrafı URL'si ile profil fotoğrafından tanınan kategori, yaş, cinsiyet, ten rengi ve saç rengi.
Zalo numara profili · TopluNumara yükleyin: Zalo kullanıcı kimliği ve profil fotoğrafı URL'si ile profil fotoğrafından tanınan kategori, yaş, cinsiyet ve ten rengi.
E-posta profil fotoğrafı kontrolü · TopluGmail, Yandex veya Mail.ru adreslerini yükleyin: her birinin teslim edilebilir olup olmadığı ve profil fotoğrafı.Toplu ve gerçek zamanlı kontroller aynı bakiyeden düşülür — ayrıca etkinleştirilecek bir şey yoktur. Kayıt olun ve ilk dosyanızı toplu kontrol sayfasında yükleyin.