Başvuru

TG Validator API başvurusu

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

Öğe	Değer
Temel URL	https://tgvalidator.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-check

Bir telefon numarası veya tek istekte en fazla 100 numara gönderin ve sonucu aynı yanıtta okuyun. Yoklama yok, geri çağırma yok. Belirlenemeyen bir sonuç 42200 koduyla 422 döndürür ve ücretlendirilmez. Çoklu istek girdi sırasını korur, her tanımlayıcıyı bağımsız olarak ücretlendirir ve tamamlanmak için 300 saniyesi vardır — tamamlanmazsa isteğin tamamı başarısız olur ve tüm ücretler iade edilir.

Parametreler

Alan	Tür	Açıklama
`service_type`	string	Ürün kodu; aşağıda listelenen ürünlerden biri.
`identifier`	string	Tekli kontrol: tek bir telefon numarası. Sunucu numarayı normalleştirir.
`identifiers`	string[]	Çoklu kontrol: 1 ila 100 telefon numarası. Yanıt bu sırayı korur.

Bu gruptaki ürünler

Telegram Kayıt KontrolütgBir numaranın Telegram'da kayıtlı olup olmadığını doğrulayın — göndermeden önce kişi listesini kontrol etmek için kullanışlıdır.Ürün sayfası

Telegram Kayıt Kontrolü

tgtelefon

Bir numaranın Telegram'da kayıtlı olup olmadığını doğrulayın — göndermeden önce kişi listesini kontrol etmek için kullanışlıdır.

Tekli kontrol

POST/api/v1/check

İstek

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

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "tg",
    "identifier": "+17253100591",
    "registered": true
  }
}

Yanıt alanları

Alan	Tür	Açıklama
`registered`	boolean	Numaranın Telegram'da kayıtlı olup olmadığı.

Çoklu kontrol

POST/api/v1/batch-check

İstek

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

Yanıt

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "tg",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "+17253100591",
        "exists": true,
        "registered": true
      },
      {
        "identifier": "+14155550000",
        "exists": true,
        "registered": false
      },
      {
        "identifier": "12345",
        "exists": false
      }
    ]
  }
}

Yanıt alanları

Alan	Tür	Açıklama
`exists`	boolean	Bu numaranın bir sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirlenemediği 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	Numaranın kayıtlı olup olmadığı. Yalnızca exists true olduğunda bulunur ve tekli kontroldekiyle aynı anlama gelir.

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

Telegram Toplu Kayıt Kontrolütg_batchNumaralardan oluşan bir dosyanın tamamını yükleyin, hangilerinin Telegram'da kayıtlı olduğunu öğrenin ve bittiğinde sonuç dosyasını indirin.Ürün sayfası
Telegram Toplu Etkinlik Kontrolütg_active_batchBütün bir listede kayıt durumu ile birlikte kullanıcı kimliği, kullanıcı adı ve aktif günler — her hesabın son görülmesinden bu yana geçen gün sayısı.Ürün sayfası
Telegram Toplu Profil Kontrolütg_profile_batchBü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.Ürün sayfası
Telegram Toplu Kullanıcı Adı Kontrolütg_username_batchTelegram kullanıcı adlarından oluşan bir liste yükleyin ve hangilerinin gerçek hesaplara ait olduğunu doğrulayın.Ürün sayfası
Telegram Toplu Kullanıcı Adı Profil Kontrolütg_username_profile_batchBütün bir kullanıcı adı listesi için kullanıcı kimliği, aktif günler ve profil fotoğrafı URL'si.Ürün sayfası

Telegram Toplu Kayıt Kontrolü

tg_batchtelefonGörev başına 1.000–500.000

Numaralardan oluşan bir dosyanın tamamını yükleyin, hangilerinin Telegram'da kayıtlı olduğunu öğrenin ve bittiğinde sonuç dosyasını indirin.

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_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://tgvalidator.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_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.

Telegram Toplu Etkinlik Kontrolü

tg_active_batchtelefonGörev başına 1.000–500.000

Bütün bir listede kayıt durumu ile birlikte kullanıcı kimliği, kullanıcı adı ve aktif günler — her hesabın son görülmesinden bu yana geçen gün sayısı.

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_active_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://tgvalidator.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_active_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).

Telegram Toplu Profil Kontrolü

tg_profile_batchtelefonGörev başına 1.000–500.000

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.

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

{
  "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://tgvalidator.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, middle_eastern, east_asian; tanınamadığında unknown, profil fotoğrafı yoksa boştur.

Telegram Toplu Kullanıcı Adı Kontrolü

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

Telegram kullanıcı adlarından oluşan bir liste yükleyin ve hangilerinin gerçek hesaplara ait olduğunu doğrulayın.

Görev gönder

POST/api/v1/bulk-tasks

İstek

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

Yanıt

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_username_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://tgvalidator.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_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.

Telegram Toplu Kullanıcı Adı Profil Kontrolü

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

Bütün bir kullanıcı adı listesi için kullanıcı kimliği, aktif günler ve profil fotoğrafı URL'si.

Görev gönder

POST/api/v1/bulk-tasks

İstek

curl -X POST "https://tgvalidator.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://tgvalidator.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.

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://tgvalidator.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ışı

Telegram kayıt kontrolleri senkrondur. Sonucu kabul etmeye mi yoksa yeniden denemeye mi karar vermek için dönen kodu kullanın.

Alan	Açıklama
`Kullanıcı başına aynı anda 5 istek`	Tekli ve çoklu kontroller bu sınırı paylaşır ve bir çoklu istek, kaç numara taşırsa taşısın tek istek sayılır. Buna ek olarak, hesap başına aynı anda yalnızca bir çoklu kontrol çalışır; ikincisi, ilki bitene kadar reddedilir. Sınırlardan herhangi birine ulaşılması, ücret alınmadan 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ı, ücret alınmadan 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 numara 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 numara
`40100`	Eksik veya geçersiz API anahtarı
`40200`	Yetersiz bakiye
`42200`	Numara ş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 tamamı 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 tam kapasitede; ü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