AvatarLookup

Toplu ürün max_profile_batch

MAX numara profili · Toplu

Numara yükleyin: MAX kullanıcı kimliği, profil fotoğrafı URL'si ve cinsiyet.

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şmesini görüntüleKayıt Ol

API sözleşmesi

İki adım: dosyayı gönderin, ardından görevi kontrol edin

API belgelerinin tamamını okuyun API Anahtarlarını aç

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.

1. Dosyayı gönderin

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.

cURL isteğiPOST /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=max_profile_batch \
  -F country=US \
  -F file=@numbers.txt
Yanıt: görev oluşturuldu200 OK
{
  "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"
  }
}

2. Görevi kontrol edin

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.

cURL isteğiGET /api/v1/bulk-tasks/{id}
curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Yanıt: görev tamamlandı200 OK
{
  "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"
  }
}

Nasıl çalışır

Bir toplu göreve ne olur

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.

  1. 01Dosyayı yükleyin

    Her satırda bir numara bulunan bir .txt veya .csv dosyası. Doğrudan akış olarak iletilir; diske hiçbir şey yazılmaz.

  2. 02Ön kontrol ve ayırma

    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.

  3. 03Arka planda çalıştırın

    Görev kendi başına çalışır — isterseniz sayfayı kapatın. Bir hata hemen bildirilir ve tamamı iade edilir.

  4. 04Sonucu indirin

    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ı

Sonuç dosyasındaki sütunlar

İndirilen dosya, tam sonuç tablosunu içeren tek bir CSV dosyasıdır.

Sonuç dosyası sütunları

  • identifier · 17253100591 — Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
  • activated · true — Numaranın MAX'te 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 · 343064807 — MAX kullanıcı kimliği.
  • avatar_url · https://i.oneme.ru/i?r=example — Profil fotoğrafı URL'si; hesabın profil fotoğrafı yoksa boştur.
  • gender · male — Hesabın cinsiyeti: male veya female; bilinmiyorsa boştur.

En uygun kullanım

Bu ürünü ne zaman kullanmalısınız

  • Liste segmentasyonu

    Bir MAX numara listesini kayda, profil fotoğrafına ve cinsiyete göre gruplayın.

  • Kişi verisi zenginleştirme

    Mevcut kişi kayıtlarına MAX kullanıcı kimliklerini ve profil fotoğraflarını ekleyin.

  • Kitle incelemesi

    İnceleme için hesap kimliklerini, profil fotoğraflarını ve cinsiyeti tek bir dosyada bir arada tutun.

Doğrudan yanıt

Toplu MAX numara profili nedir?

Toplu MAX profil fotoğrafı sorgulaması, kayıtlı her numara için MAX kullanıcı kimliğini, profil fotoğrafı URL'sini ve hesabın cinsiyetini döndürür. Yükleme sırasında numaraların ait olduğu ülkeyi seçin.

Net sınırlar

Bu ürünün sınırları

  • Sonuçlar görevin çalıştığı anı yansıtır. Profil fotoğrafları değişir — güncel durum için yeniden çalıştırın; saklanan sonuçlar sizin için asla yenilenmez.
  • Bir ulaşılabilirlik veya etkinlik kontrolü değildir ve kimlik doğrulaması değildir.
  • Dosyadaki tanımlayıcılara hiçbir şey gönderilmez.
  • Hangi sütunların döneceği platforma bağlıdır. Yüklemeden önce bu sayfada listelenirler.
  • İndirme bağlantılarının süresi dolar. Dosyayı görev tamamlandıktan kısa süre sonra alın; bir bağlantının süresi dolarsa yenisi için görevi tekrar kontrol edin.

Toplu kontrol ne zaman uygun

Toplu kontrol ne zaman değer — ve gerçek zamanlı ne zaman daha hızlı

Gerçek zamanlı kontrolToplu 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 belgelerindeTek görevde büyük bir listenin tamamı — güncel boyut aralığı fiyatlandırma sayfasında yer alır
Sonuçları almaHemen: tekli ve çoklu uç nokta aynı yanıtta cevap verir; panel sonuçları tek tek döndürürGörev tamamlandığında bir sonuç dosyası indirin
ÜlkeSeçim gerekmez — gerçek zamanlı sorgulamalar ülkeye göre gruplanmadan tek tek gönderilirGörev başına bir ülke; yüklemede seçilir ve dosyayla birlikte gönderilir
Sonuç biçimiJSON, kayıt başına alanlarSonuç dosyası (tablonun tamamını içeren tek bir CSV)
Tipik kullanımForm doğrulama, temsilci sorgulamaları, gönderim öncesi kontrolListe temizliği, kampanya öncesi filtreleme, saklanan verilerin temizlenmesi

Gerçek zamanlı kontrol · Fiyatlandırmayı görüntüle

Ürün SSS

MAX numara profili hakkında

Gerçek zamanlı kontrol yerine ne zaman toplu kontrol kullanmalıyım?

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.

Dosyadaki geçersiz tanımlayıcılara ne olur?

Ö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.

Bir görev ne kadar sürer?

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.

Başarısız olursa iade alır mıyım?

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

Diğer toplu ü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.Viber numara profili · TopluNumara 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.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 görev göndermek için hesap oluşturun

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.

Kayıt Ol Fiyatlandırmayı görüntüle