Kanal Gönderileri

GET/v1/telegram/channel/posts1 kredi

Herkese açık bir kanalın gönderilerinden bir sayfayı döndürür; metin, yayın zamanı, görüntülenme, tepkiler, medya, bağlantı önizlemeleri, iletildiği kaynak ve anketler (soru, seçenekler, sonuçlar) ile kanalın başlık bilgileri yer alır.

01Sorgu parametreleri

Ad	Tür	Açıklama
handlezorunlu	string	Herkese açık kanalın kullanıcı adı ya da bağlantısı: `durov`, `@durov` veya `https://t.me/durov`.
cursoristeğe bağlı	string	Bir önceki sayfanın `cursor` değeri (bir gönderi kimliği); daha eski gönderileri almak için geri gönderilir.
cache_max_ageisteğe bağlı	string	Uyumluluk 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/posts?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/posts?handle=durov

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "channel": {
    "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": 10300000,
    "subscriber_count_text": "10.3M",
    "member_count": null,
    "member_count_text": null,
    "photo_count": 102,
    "video_count": 47,
    "file_count": null,
    "link_count": 200
  },
  "posts": [
    {
      "id": "531",
      "channel_handle": "durov",
      "url": "https://t.me/durov/531",
      "author_name": "Pavel Durov",
      "author_url": "https://t.me/durov",
      "text": "🩵 Telegram now has a Rich Text Editor. It supports tables, headings, inline media, lists, AI content, formulas, and more. 😈 Messaging apps will never be the same!",
      "published_at": "2026-07-16T20:45:25+00:00",
      "view_count": 5840000,
      "view_count_text": "5.84M",
      "reactions": [
        {
          "emoji": "⭐",
          "emoji_id": null,
          "count": 6300,
          "count_text": "6.3K"
        },
        {
          "emoji": null,
          "emoji_id": "5265077361648368841",
          "count": 54600,
          "count_text": "54.6K"
        }
      ],
      "reaction_count": 95110,
      "forwarded_from": null,
      "media": [
        {
          "type": "video",
          "url": "https://cdn4.telesco.pe/file/b231b9b161.mp4?token=mg0DQG6NjrvUubauVWSFWjkR_WdX1AnXxIZXPdEMVuxXd72lxKw_kIMLanz6SGiuCz5l8mbIEze9wTqWNhHC8bILm1aUnpkvb_5M-royVgjY1hNDYasNtLKZmYNCj72U6woDbhxLqOGmCdfF5O5h7Z-NrBNtG1wGN7o5-vgp96q3P1hgNw3eJqK4HTkcxvqo3wKI_ZvOyea2svrb6uKd0ybBjRZF9-gtNUhO3gO_lh_RXyap86bgPxqCuAe5avXaoK0pkfHT4zBPLl-27hskOVX93COOb1QbzxqxPhyu_aPdL6dbMMKKqQ6ekV16mSputZMl8yTK5qy1RhVijS-_nIi-rc8JTn…",
          "thumbnail_url": "https://cdn4.telesco.pe/file/JcEMS9Bq90aZQ4T4hTjXv8GwjylP99JjolEOlrsaRUQUoTg-FkIiVr22US2gPq7F7KTpVfv3a0LheA34sLpn3yt56djZa24ahRgfrYjrR9Tht3S1qXOxDIqGaCEpDwxIAaXFxgsQPk2vxVM-4k-YrgxsPIhO0ojSDeOqZ5crBHjyNulwZ4VVYkYb03h6natXFjhUUxmiQgXSg_fzlL1-aiz3L4nkJv1RjF2Mvr5ZCS8-Y9L4G_vSBrGsxkeOLVpsnYzLy0ut75H8m3woet_EIqWuLRYS9l3zXRrdmaSwIFeATLcZJqs0Jj7ypHqzrDuyeuYKYaXVYbP93Vl2nV7orA",
          "duration": null
        }
      ],
      "link_preview": null,
      "poll": null
    },
    {
      "id": "532",
      "channel_handle": "durov",
      "url": "https://t.me/durov/532",
      "author_name": "Pavel Durov",
      "author_url": "https://t.me/durov",
      "text": "🎠 Telegram now supports carousels One small step for messaging, one giant leap toward turning cat photos into keynote presentations. 😺",
      "published_at": "2026-07-19T21:45:01+00:00",
      "view_count": 6550000,
      "view_count_text": "6.55M",
      "reactions": [
        {
          "emoji": "⭐",
          "emoji_id": null,
          "count": 5810,
          "count_text": "5.81K"
        },
        {
          "emoji": null,
          "emoji_id": "5373223594484587136",
          "count": 56000,
          "count_text": "56K"
        }
      ],
      "reaction_count": 84340,
      "forwarded_from": null,
      "media": [
        {
          "type": "video",
          "url": "https://cdn4.telesco.pe/file/181642ae31.mp4?token=nywY3wMCjnXLXXMiFJhv0sbQoLqxxSNKxSYovhlY7A3JUzZSXtSYahEfxgQrmhBaqfrM6prHQBiSwNb5dAwaRJonmM9QRom4BxMseDSfl-NDzOzs1y-YDfZ8zP8LJqyV7if1XQj5LYkJ8LE-oh1uBdyJkRutuPNX9UGyQq0wn8SlcFpj3nYHTzrQWgVMGfAxNPgiTn2Y-ou4LlcSkUjgJNLjByXSbXlxsfbijroRqq8lHAUEPpukvfNSdv6y3MnmLSKT-HGX0tqENF5VNQq6xMG5KchoVEIIZzlhqaUd25Eaz6BJSZQ090fUMqPDUa37RHH4KAF2cWOfYQcb9ZM9oQ",
          "thumbnail_url": "https://cdn4.telesco.pe/file/ZkMGYen6bnVsuBLEPnGvFu7hW4i2uC_OlHGJ-i7QBhxqoRm2_99vcbGkgLMAkw_msoy8PlviaPYQ3z1yfS3P9wvI1Vsqq842rUNl81TOjIJGc-Xr2OvmnUd3MeB_FquprJIHQpJ6rM85ufyouI-48-VIeNGaZbOb3u4V-M4gzRTNTAFq0zDlUFrwa_OSDlycjJztcK3mQsW2AFZpAMTCMmKUoEDYgcsWhTJ8nrV_ori1b5s3_-WS3TtkjCP5JQNofXo8c3ygy8XcsmRG2qrByPHuKAeJF8ll1z6bCYL6t_JoNmlmUHK_HxczE342GtLsFB_BLCYhbizLaTW2TNcnvQ",
          "duration": null
        }
      ],
      "link_preview": null,
      "poll": null
    }
  ],
  "cursor": "531",
  "has_more": true
}

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

Gönderiler `posts` içinde, sayfa başına yaklaşık 20 adet gelir ve sayfa içinde eskiden yeniye sıralanır; ilk sayfa en son gönderileri içerir. `has_more` true olduğu sürece daha eski gönderiler için `cursor` değerini `cursor` parametresiyle geri gönderin; en eski sayfada null olur ve onun ötesindeki bir sayfa boş bir liste döndürür, 0 kredi düşer. Görüntülenme ve tepki sayıları Telegram'ın yuvarlanmış değerlerinden okunur (`5.81M`, 5810000 olur). Her gönderide bir `poll` anahtarı vardır (bizim eklememiz, ScrapeCreators'ın yanıtında yoktur): anket yoksa null, varsa sorusu, türü (`regular` ya da `quiz`), anonim, çoktan seçmeli ya da kapanmış olup olmadığı, oy veren sayısı (burada yuvarlanmış, `48.7K`) ve her seçeneğin yüzdesi ile oy sayısı; Telegram sayfasının göstermediği bir değer null olur (kapanmış bir anket artık quiz ya da anonim olduğunu söylemez; quiz'in doğru cevabı hiç gösterilmez) ve oy sayıları yalnızca sayfadaki sonuç çubuklarından kesin olarak çıkarılabildiğinde doldurulur. Grup ya da herkese açık önizlemesi olmayan bir kanal ücretsiz bir 403, 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.