Başvuru

AvatarLookup API başvurusu

Tüm uç noktalar tek bir API anahtarını ve tek bir bakiyeyi paylaşır.

Öğe	Değer
Temel URL	https://avatarlookup.com
Kimlik doğrulama başlığı	X-API-Key: sk_your_api_key
Yanıt zarfı	{ code, msg, data }

Fiyatlar burada listelenmez; her ürün başarılı kontrol başına ücretlendirilir. Fiyatlandırmayı görün

Kimlik doğrulama

Ayarlar'da oluşturulan bir API anahtarını kullanın ve her istekle birlikte gönderin.

Kimlik doğrulama başlığı

X-API-Key: sk_your_api_key

API anahtarınızı gizli tutunBu uç noktayı her zaman sunucunuzdan çağırın. Anahtara sahip olan herkes bakiyenizi harcayabilir.

Senkron kontroller

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

Bir tanımlayıcı veya tek istekte en fazla 100 tanımlayıcı gönderin ve sonucu aynı yanıtta okuyun. Yoklama yok, geri çağırma yok. Belirsiz bir sonuç 42200 koduyla 422 döndürür ve ücretlendirilmez. Çoklu istek giriş sırasını korur, her tanımlayıcıyı bağımsız olarak ücretlendirir ve tamamlanmak için 300 saniyesi vardır — tamamlanamazsa isteğin tamamı başarısız olur ve her ücret iade edilir. Görsel profilleme kendi uç noktasını, /api/v1/image/profile adresini kullanır ve tanımlayıcı yerine bir görsel alır.

Parametreler

Alan	Tür	Açıklama
`service_type`	string	Ürün kodu; aşağıda listelenen ürünlerden biri.
`identifier`	string	Tekil kontrol: bir tanımlayıcı. Sunucu onu normalleştirir.
`identifiers`	string[]	Çoklu kontrol: 1 ila 100 tanımlayıcı. Yanıt bu sırayı korur.
`file`	file	Görsel profilleme: bir portre görseli (multipart yükleme). `identifier` yoktur.

Bu gruptaki ürünler

Görsel profil analiziimage_profileHerhangi bir resim yükleyin ve portre özelliklerini alın: tahmini yaş, cinsiyet, görsel türü, saç rengi ve ten rengi.Ürün sayfası
WhatsApp profil fotoğrafı analiziws_profileBir numaranın WhatsApp profil fotoğrafı olup olmadığını kontrol edin, görsel URL'sini alın ve o profil fotoğrafının portre özelliklerini okuyun.Ürün sayfası
E-posta profil fotoğrafı analiziemail_profileBir e-posta hesabının profil fotoğrafı olup olmadığını kontrol edin ve portre özelliklerini okuyun. Gmail, Yandex ve Mail.ru'yu kapsar.Ürün sayfası

Görsel profil analizi

image_profilegörsel

Herhangi bir resim yükleyin ve portre özelliklerini alın: tahmini yaş, cinsiyet, görsel türü, saç rengi ve ten rengi.

Tekli kontrol

POST/api/v1/image/profile

İstek

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

Yanıt

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

Yanıt alanları

Alan	Tür	Açıklama
`identifier`	string	Gönderilen resmin içeriğinden türetilen parmak izi. Aynı resim her zaman aynı değeri verir.
`category`	string	Resmin ne olduğu: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar veya object. Portre üretilemediğinde unknown.
`age`	integer	Yaklaşık 3 yıl hassasiyetle, 0-80 aralığıyla sınırlandırılmış tam sayı olarak tahmini yaş. Tahmin edilemediğinde (örneğin cinsiyet belirlenemediğinde) yer almaz.
`gender`	string	male, female veya unknown.
`skin_color`	string	Tanımlayıcı ten rengi, örneğin white, east_asian veya hispanic. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.
`hair_color`	string	Tanımlayıcı saç rengi, örneğin black, brown, blond veya gray white. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.

WhatsApp profil fotoğrafı analizi

ws_profiletelefon

Bir numaranın WhatsApp profil fotoğrafı olup olmadığını kontrol edin, görsel URL'sini alın ve o profil fotoğrafının portre özelliklerini okuyun.

Tekli kontrol

POST/api/v1/check

İstek

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

Yanıt alanları

Alan	Tür	Açıklama
`registered`	boolean	Numaranın WhatsApp'ta kayıtlı olup olmadığı.
`avatar`	boolean	Profil fotoğrafı ayarlanıp ayarlanmadığı.
`avatar_url`	string	Profil fotoğrafının URL'si; fotoğraf ayarlanmamışsa boş dize.
`category`	string	Resmin ne olduğu: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar veya object. Portre üretilemediğinde unknown.
`age`	integer	Yaklaşık 3 yıl hassasiyetle, 0-80 aralığıyla sınırlandırılmış tam sayı olarak tahmini yaş. Tahmin edilemediğinde (örneğin cinsiyet belirlenemediğinde) yer almaz.
`gender`	string	male, female veya unknown.
`skin_color`	string	Tanımlayıcı ten rengi, örneğin white, east_asian veya hispanic. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.
`hair_color`	string	Tanımlayıcı saç rengi, örneğin black, brown, blond veya gray white. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.

Çoklu kontrol

POST/api/v1/batch-check

İstek

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"] }'

Yanıt

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

Yanıt alanları

Alan	Tür	Açıklama
`exists`	boolean	Bu tanımlayıcının bir sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirsiz kaldığı veya kontrolün başarısız olduğu anlamına gelir; false olduğunda aşağıdaki alanların hiçbiri bulunmaz.
`registered`	boolean	Hesabın o platformda var olup olmadığı (e-posta adresi için: ulaşılabilir olup olmadığı). Yalnızca exists true olduğunda bulunur ve tekil sorgulamayla aynı anlamı taşır.
`avatar`	boolean	Profil fotoğrafı ayarlanıp ayarlanmadığı.
`avatar_url`	string	Profil fotoğrafının URL'si; fotoğraf ayarlanmamışsa boş dize.
`category`	string	Resmin ne olduğu: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar veya object. Portre üretilemediğinde unknown.
`age`	integer	Yaklaşık 3 yıl hassasiyetle, 0-80 aralığıyla sınırlandırılmış tam sayı olarak tahmini yaş. Tahmin edilemediğinde (örneğin cinsiyet belirlenemediğinde) yer almaz.
`gender`	string	male, female veya unknown.
`skin_color`	string	Tanımlayıcı ten rengi, örneğin white, east_asian veya hispanic. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.
`hair_color`	string	Tanımlayıcı saç rengi, örneğin black, brown, blond veya gray white. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.

E-posta profil fotoğrafı analizi

email_profilee-posta

Bir e-posta hesabının profil fotoğrafı olup olmadığını kontrol edin ve portre özelliklerini okuyun. Gmail, Yandex ve Mail.ru'yu kapsar.

Tekli kontrol

POST/api/v1/check

İstek

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

Yanıt alanları

Alan	Tür	Açıklama
`registered`	boolean	E-posta adresine ulaşılabilir olup olmadığı (posta alabilir mi).
`avatar`	boolean	Profil fotoğrafı ayarlanıp ayarlanmadığı.
`avatar_url`	string	Profil fotoğrafının URL'si; profil fotoğrafı ayarlanmamışsa boş dize.
`category`	string	Resmin ne olduğu: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar veya object. Portre üretilemediğinde unknown.
`age`	integer	Yaklaşık 3 yıl hassasiyetle, 0-80 aralığıyla sınırlandırılmış tam sayı olarak tahmini yaş. Tahmin edilemediğinde (örneğin cinsiyet belirlenemediğinde) yer almaz.
`gender`	string	male, female veya unknown.
`skin_color`	string	Tanımlayıcı ten rengi, örneğin white, east_asian veya hispanic. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.
`hair_color`	string	Tanımlayıcı saç rengi, örneğin black, brown, blond veya gray white. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.

Çoklu kontrol

POST/api/v1/batch-check

İstek

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"] }'

Yanıt

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

Yanıt alanları

Alan	Tür	Açıklama
`exists`	boolean	Bu tanımlayıcının bir sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirsiz kaldığı veya kontrolün başarısız olduğu anlamına gelir; false olduğunda aşağıdaki alanların hiçbiri bulunmaz.
`registered`	boolean	Hesabın o platformda var olup olmadığı (e-posta adresi için: ulaşılabilir olup olmadığı). Yalnızca exists true olduğunda bulunur ve tekil sorgulamayla aynı anlamı taşır.
`avatar`	boolean	Profil fotoğrafı ayarlanıp ayarlanmadığı.
`avatar_url`	string	Profil fotoğrafının URL'si; profil fotoğrafı ayarlanmamışsa boş dize.
`category`	string	Resmin ne olduğu: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar veya object. Portre üretilemediğinde unknown.
`age`	integer	Yaklaşık 3 yıl hassasiyetle, 0-80 aralığıyla sınırlandırılmış tam sayı olarak tahmini yaş. Tahmin edilemediğinde (örneğin cinsiyet belirlenemediğinde) yer almaz.
`gender`	string	male, female veya unknown.
`skin_color`	string	Tanımlayıcı ten rengi, örneğin white, east_asian veya hispanic. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.
`hair_color`	string	Tanımlayıcı saç rengi, örneğin black, brown, blond veya gray white. Açık uçlu bir küme olarak değerlendirin; belirlenemediğinde unknown.

Asenkron kontroller

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

Bir dosya yükleyin ve hemen bir görev kimliği alın, ardından bu kimliği başarılı olana kadar kontrol edin. Başarılı yanıt, sonuç indirme bağlantısı olan result_url alanını içerir. Yalnızca iki işlem vardır: gönder ve kontrol et. 30 saniyede bir defadan daha sık yoklama yapmayın.

Parametreler

Alan	Tür	Açıklama
`service_type`	string	Toplu ürün kodu; aşağıda listelenen ürünlerden biri.
`country`	string	`US` gibi bir ISO 3166-1 kodu. Numara görevleri için zorunludur: her numara ülke kodunu içermeli ve bu ülkeye ait olmalıdır (uymayan numaralar çıkarılır ve ücretlendirilmez); ayrıca yönlendirmeyi de belirler. Multipart'ta `file` alanından önce gelmelidir.
`file`	file	Her satırda bir tanımlayıcı bulunan, en fazla `max_file_bytes` (varsayılan 20MB) boyutunda bir `.txt` veya `.csv` dosyası.
`Idempotency-Key`	header	İsteğe bağlı, en fazla 128 karakter. Aynı anahtarın tekrar gönderilmesi ikinci bir görev oluşturmak yerine orijinal görevi döndürür.

Bu gruptaki ürünler

WhatsApp profil fotoğrafı analizi · Topluws_profile_batchNumaralardan 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.Ürün sayfası
Telegram numara profili · Toplutg_profile_batchNumara 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.Ürün sayfası
Telegram kullanıcı adı profili · Toplutg_username_profile_batchTelegram 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.Ürün sayfası
Viber numara profili · Topluviber_profile_batchNumara 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.Ürün sayfası
MAX numara profili · Toplumax_profile_batchNumara yükleyin: MAX kullanıcı kimliği, profil fotoğrafı URL'si ve cinsiyet.Ürün sayfası
LINE profil fotoğrafı analizi · Topluline_profile_batchNumara 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.Ürün sayfası
Zalo numara profili · Topluzalo_profile_batchNumara 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.Ürün sayfası
E-posta profil fotoğrafı kontrolü · Topluemail_avatar_batchGmail, Yandex veya Mail.ru adreslerini yükleyin: her birinin teslim edilebilir olup olmadığı ve profil fotoğrafı.Ürün sayfası

WhatsApp profil fotoğrafı analizi · Toplu

ws_profile_batchtelefonGörev başına 1.000–500.000

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

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

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

Görevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`identifier`	17253100591	Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
`activated`	true	Numaranın WhatsApp'ta kayıtlı olup olmadığı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.
`avatar_url`	https://pps.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`	east_asian	Profil fotoğrafından tahmin edilen ten rengi, ör. white, asian, east_asian; tanınamadığında unknown, profil fotoğrafı yoksa boştur.
`hair_color`	black	Profil fotoğrafından tahmin edilen saç rengi, ör. black, brown; tanınamadığında unknown, profil fotoğrafı yoksa boştur.

Telegram numara profili · Toplu

tg_profile_batchtelefonGörev başına 1.000–500.000

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

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

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

Görevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`identifier`	17253100591	Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
`activated`	true	Numaranın Telegram'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`	1234567890	Telegram kullanıcı kimliği.
`username`	alex_kim	Kullanıcı adı; hesabın kullanıcı adı yoksa boştur.
`activedays`	9	Hesabın son görülmesinden bu yana geçen gün sayısı, tam sayı olarak — küçük değer daha yakın zamanı gösterir. Hesap tam son görülme zamanını gizlediğinde Telegram yalnızca bir aralık gösterir ve değer yaklaşıktır: 0 (yakın zamanda), 7 (bir hafta içinde), 30 (bir ay içinde) veya 1000 (uzun zaman önce).
`avatar_url`	https://telegram.waavatar.xyz/v/example.jpg	Profil fotoğrafı URL'si; hesabın 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.

Telegram kullanıcı adı profili · Toplu

tg_username_profile_batchkullanıcı adıGörev başına 1.000–500.000

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

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

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

Görevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`identifier`	alex_kim	Gönderilen kullanıcı adı, @ veya t.me/ olmadan (ör. alex_kim).
`activated`	true	Kullanıcı adının mevcut bir Telegram hesabına ait olup olmadığı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.
`uid`	1234567890	Telegram kullanıcı kimliği; mevcut bir hesap için bile boş olabilir.
`activedays`	9	Hesabın son görülmesinden bu yana geçen gün sayısı, tam sayı olarak — küçük değer daha yakın zamanı gösterir. Hesap tam son görülme zamanını gizlediğinde Telegram yalnızca bir aralık gösterir ve değer yaklaşıktır: 0 (yakın zamanda), 7 (bir hafta içinde), 30 (bir ay içinde) veya 1000 (uzun zaman önce). Hesap hiçbir son görülme bilgisi göstermediğinde boş olabilir.
`avatar_url`	https://cdn5.telesco.pe/file/example.jpg	Profil fotoğrafı URL'si; hesabın profil fotoğrafı yoksa boştur.

Viber numara profili · Toplu

viber_profile_batchtelefonGörev başına 1.000–500.000

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.

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

{
  "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örevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`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.

MAX numara profili · Toplu

max_profile_batchtelefonGörev başına 1.000–500.000

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

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

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

Görevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`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.

LINE profil fotoğrafı analizi · Toplu

line_profile_batchtelefonGörev başına 2.000–500.000

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

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

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

Görevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`identifier`	17253100591	Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
`activated`	true	Numaranın LINE'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`	u5158553776c28d9164035c4fd0a07cd4	LINE kullanıcı kimliği.
`avatar_url`	https://profile.line-scdn.net/example	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`	east_asian	Profil fotoğrafından tahmin edilen ten rengi, ör. white, asian, east_asian; tanınamadığında unknown, profil fotoğrafı yoksa boştur.
`hair_color`	black	Profil fotoğrafından tahmin edilen saç rengi, ör. black, brown; tanınamadığında unknown, profil fotoğrafı yoksa boştur.

Zalo numara profili · Toplu

zalo_profile_batchtelefonGörev başına 1.000–500.000

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

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

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

Görevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`identifier`	17253100591	Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
`activated`	true	Numaranın Zalo'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`	452114152	Zalo kullanıcı kimliği.
`avatar_url`	https://s160-ava-talk.zadn.vn/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`	asian	Profil fotoğrafından tahmin edilen ten rengi, ör. white, asian, east_asian; tanınamadığında unknown, profil fotoğrafı yoksa boştur.

E-posta profil fotoğrafı kontrolü · Toplu

email_avatar_batche-postaGörev başına 1.000–500.000

Gmail, Yandex veya Mail.ru adreslerini yükleyin: her birinin teslim edilebilir olup olmadığı ve profil fotoğrafı.

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

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

Görevi kontrol et

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

İstek

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

Yanıt

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

Sonuç sütunları

Alan	örnek:	Açıklama
`identifier`	alex.kim@gmail.com	Gönderilen adres, küçük harflerle.
`activated`	true	Adresin o sağlayıcıda teslim edilebilir olup olmadığı — posta alıp alamayacağı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.
`avatar`	true	Profil fotoğrafı ayarlanıp ayarlanmadığı: true veya false. Görsel mevcut olmadığında avatar_url yine de boş olabilir.
`avatar_url`	https://lh3.googleusercontent.com/a/example	Profil fotoğrafı URL'si; URL mevcut olmadığında boştur.

Bakiye

GET/api/v1/balance

Mevcut hesap bakiyesini USD mikro birimi cinsinden okuyun. Salt okunurdur: kontrol kaydı oluşturmaz ve ücret almaz.

Bakiye

GET/api/v1/balance

İstek

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

Yanıt

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

Eşzamanlılık, zaman aşımları ve yeniden deneme davranışı

Profil fotoğrafı sorgulamaları senkrondur. Sonucu kabul etmeye mi yoksa daha sonra yeniden denemeye mi karar vermek için döndürülen kodu kullanın.

Alan	Açıklama
`Kullanıcı başına aynı anda 5 istek`	Tekil ve çoklu kontroller bu sınırı paylaşır ve bir çoklu istek, kaç tanımlayıcı taşırsa taşısın tek bir istek sayılır. Buna ek olarak, hesap başına aynı anda yalnızca bir çoklu kontrol çalışır; ikincisi, ilki bitene kadar reddedilir. Herhangi bir sınıra ulaşmak, ücretlendirme olmadan hemen 42901 kodunu ve bir Retry-After başlığını döndürür — devam eden bir istek bittiğinde yeniden gönderin.
`Tekli 60 sn, çoklu 300 sn`	Süre sınırının aşılması, ücretlendirme olmadan 50400 kodunu döndürür. Zaman aşımına uğrayan bir çoklu kontrol bütünüyle başarısız olur — kısmi sonuç yoktur ve tutarın tamamı iade edilir.
`Bir çoklu kontrol en fazla 100 tanımlayıcı alır`	Sonuçlar gönderim sırasını ve uzunluğunu korur. Hesap başına aynı anda bir çoklu kontrol çalışır; bir önceki grup döndükten sonra sonraki grubu gönderin.

Hata kodları

Kod	Açıklama
`40000`	Desteklenmeyen hizmet türü veya çelişen istek alanları
`40001`	Geçersiz JSON gövdesi
`40002`	Geçersiz tanımlayıcı
`40100`	Eksik veya geçersiz API anahtarı
`40200`	Yetersiz bakiye
`42200`	Tanımlayıcı şu anda belirlenemedi. Veri döndürülmez ve istek ücretlendirilmez
`42900`	Bir kullanım kotası tükendi veya tamamlanmamış sipariş sayısı çok fazla
`42901`	Devam eden beş istek yuvasının tümü dolu veya bu hesapta zaten bir çoklu kontrol çalışıyor; devam eden bir istek bittikten sonra gönderin. Reddedilen istek ücretlendirilmez ve bir Retry-After başlığı taşır
`50303`	Hizmet şu anda kapasitesinin sınırında; ücretlendirilmez. Retry-After saniyesi kadar bekleyin ve aynı isteği yeniden gönderin
`50400`	Kontrol zaman aşımı süresi içinde tamamlanmadı ve ücretlendirilmez; yeniden deneyin. Grup zaman aşımında grubun tamamı başarısız olur ve tutarın tamamı iade edilir
`50300`	Doğrulama hizmeti bakımda