Canlı demoPOST /api/v1/bulk-tasksservice_type=tg_profile_batch

Toplu ürün tg_profile_batch

Telegram Toplu Profil Kontrolü

Bütün bir listede kullanıcı kimliği, kullanıcı adı, aktif günler, profil fotoğrafı URL'si ve profil fotoğrafından tahmin edilen yaş, cinsiyet ve ten rengi.

Büyük listelerin tamamı için bir ek seçenek — birkaç numara için gerçek zamanlı kontrol aynı istekte yanıt verir. Gerçek zamanlı kontrol →

API sözleşmesini görüntüle Kayı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://tgvalidator.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: görev oluşturuldu200 OK

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

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://tgvalidator.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": "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"
  }
}

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.

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.
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: geçersiz satırlar, yinelenenler ve ülke kodu olmayan veya başka bir ülkeye ait numaralar çıkarılır ve tek ülke kuralı kontrol edilir. Bu aşamada başarısız olan bir dosya, tamamı iade edilen başarısız bir görev olarak sonlanır; aksi takdirde yalnızca kalan satırlar kontrol edilir ve görev tamamlandığında hesaplaşma yapılır.
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.
04Sonucu indirin
Dosyayı toplu kontrol sayfasından alın. Yalnızca gerçekten sonuç döndüren numaralar için ödeme yaparsınız; fark iade edilir.

Sonuç alanları

Sonuç dosyasındaki sütunlar

İndirilen dosya, bu tablonun tamamını 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 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, middle_eastern, east_asian; tanınamadığında unknown, profil fotoğrafı yoksa boştur.

En uygun kullanım

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

Hedef kitle segmentasyonu

agegenderskin_color

Kitleleri profil fotoğrafından tahmin edilen özelliklere göre ayırın, ardından her segment için daha uygun bir iletişim yaklaşımı kullanın.

Örneğin: yaşa ve cinsiyete göre ayrı iletişim listeleri oluşturun.

Hedefli liste ayrımları

activatedactivedays

Hâlâ kullanımda olan hesapları filtreleyin, ardından segmentlere ne kadar yakın zamanda aktif olduklarına göre öncelik verin.

Örneğin: yakın zamanda aktif olmuş kayıtlı segmentlerle başlayın.

Profil fotoğrafı toplama

avatar_urlusername

Sonraki incelemeleri kolaylaştırmak için kayıtlı kişilerin herkese açık profil fotoğrafı bağlantılarını ve kullanıcı adlarını doldurun.

Örneğin: herkese açık profil fotoğrafı bağlantılarını CRM kişi profillerine geri ekleyin.

Hesap gerçekliğine ilk bakış

uidusernameavatar_url

Manuel inceleme gerektirebilecek eksik kayıtları işaretlemek için kullanıcı kimliğini, kullanıcı adını ve profil fotoğrafını kullanın.

Örneğin: eksik veya olağan dışı kayıtları manuel incelemeye gönderin.

Doğrudan yanıt

Toplu Profil kontrolü nedir?

Telegram toplu profil kontrolü, kayıtlı her numaranın profilini döndürür: kullanıcı kimliği, kullanıcı adı, aktif günler, profil fotoğrafı URL'si ve profil fotoğrafından tahmin edilen yaş, cinsiyet ve ten rengi. Büyük listeleri segmentlere ayırmak için tasarlanmıştır. Sonuç yalnızca burada listelenen alanları içerir; sohbet geçmişi ve mesaj içeriği hiçbir zaman işin içinde değildir.

Net sınırlar

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

Kimlik doğrulaması değildir. Sonuç, numaranın platformdaki kayıt durumunu açıklar; numaranın sahibinin kim olduğunu doğrulayamaz.
Asla mesaj geçmişi, sohbet içeriği veya herhangi bir özel hesap içeriği döndürmez.
Gönderirken numaralarınızın ait olduğu ülkeyi seçin. Liste esas olarak o tek ülkeye ait olmalıdır; aynı alan kodunu paylaşan komşu ülkeler ülkeler arası sayılmaz. Koşulları karşılamayan bir liste, tamamı iade edilen başarısız bir görev olarak sonlanır.
Sonuçlar görevin çalıştığı anı yansıtır. Güncel durum için yeniden çalıştırın — saklanan sonuçlar sizin için asla yenilenmez.
İ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ı kontrol	Toplu kontrol
Kaç numara	Tekli kontrolde 1 numara; çoklu istekte birkaç numara — kesin sınırlar API belgelerinde yer alır	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 / bölge	Kısıtlama yok — tek istekte serbestçe karıştırın	Gönderimde bir ülke/bölge seçin; liste esas olarak o ülkeye ait olmalıdır ve başka yerlerden çok fazla numara olması görevin tam iadeyle başarısız olmasına neden olur
Sonuç biçimi	JSON, numara 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

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

Ürün SSS

Profil kontrolü 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ç numara için gerçek zamanlı kontrol, planlanacak bir görev olmadan aynı istekte yanıt verir.

Dosyadaki geçersiz numaralara 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?

Numara 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örevin tamamı iade edilir. Görev başarılı olur ancak bazı numaralar sonuç 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.

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