İçeriğe geç

Kanal

GET/v1/telegram/channel1 kredi

Herkese açık bir Telegram kanalını döndürür: ad, açıklama, avatar, doğrulama durumu, kesin abone sayısı ve paylaşılan fotoğraf, video, dosya ve bağlantı sayıları.

01Sorgu parametreleri

AdTürAçıklama
handlezorunlustringHerkese açık kanalın kullanıcı adı ya da bağlantısı: `durov`, `@durov` veya `https://t.me/durov`.
cache_max_ageisteğe bağlıstringUyumluluk için kabul edilir: önbellekteki bir yanıtın en fazla ne kadar eski olabileceğini belirtir. Her çağrı canlı olarak çekildiği için yanıtı da fiyatı da değiştirmez.Kabul edilen değerler:1d3d7d14d30d

02İstek

curl "https://api.scrapesocial.ai/v1/telegram/channel?handle=durov" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/telegram/channel?handle=durov

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "handle": "durov",
  "name": "Pavel Durov",
  "description": "Founder of Telegram.",
  "url": "https://t.me/durov",
  "avatar_url": "https://cdn4.telesco.pe/file/enJjZA2XzVbFAjeTOqFmqCmKVB5C_ZO1xVZAc4I4FHpcUdG6hDb5J51QzS22g6-tJRQGrlGmdtgU1eGT8p-i8JKeqcmCeGhl9vfVeW9yE4BGbeGSkiCZM8PKp_tk6ERV37lqm7F5woM7pH1Yr1ZfsNolrCfBiG16Ds2xrbM99J5Hr-5gsTz2I5f3Mom7BMCwHLFDseUGGHAonLz0SzXMeiX-mnheeroFMi0MZ2WS6E2RFng-3J1CBNV9iH9CUz2sLmQiNcTqepMdytRNF0cNDdMkibIS5_zANtiRy-CRf3bgXHspFVdqQX3lMPpf_rQgT1ABeQh4Cv79DhmnL_hYVw.jpg",
  "is_verified": true,
  "subscriber_count": 10254399,
  "subscriber_count_text": "10,254,399",
  "member_count": null,
  "member_count_text": null,
  "photo_count": 102,
  "video_count": 47,
  "file_count": null,
  "link_count": 200
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

`subscriber_count` kesin bir tam sayıdır, `subscriber_count_text` ise biçimlendirilmiş hâlidir. Gruplarda bunun yerine `member_count` doldurulur ve medya sayaçları null olur; Telegram'ın göstermediği bir sayaç da null döner. Bulunamayan bir kanal ücretsiz bir 404 döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

  • 400missing_parameter

    Zorunlu bir parametre eksik veya geçersiz.

  • 403private_account

    Hesap gizli ya da yaş kısıtlamalı.

  • 404not_found

    Böyle bir hesap yok.

  • 503upstream_error

    Platform şu an cevap vermiyor; tekrar deneyin.