İçeriğe geç

Gönderi

GET/v1/telegram/post1 kredi

Herkese açık bir kanaldaki tek bir gönderiyi döndürür: metin, yazar, yayın zamanı, görüntülenme, tepkiler, medya, bağlantı önizlemesi, iletildiği kaynak ve anketi (soru, seçenekler, sonuçlar).

01Sorgu parametreleri

AdTürAçıklama
urlzorunlustringHerkese açık gönderinin URL'si, örneğin `https://t.me/durov/543`.
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/post?url=https%3A%2F%2Ft.me%2Fdurov%2F543" \
  -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/post?url=https%3A%2F%2Ft.me%2Fdurov%2F543

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "543",
  "channel_handle": "durov",
  "url": "https://t.me/durov/543",
  "author_name": "Pavel Durov",
  "author_url": "https://t.me/durov",
  "text": "💎 Telegram has applied for the .gram domain zone. If the application is approved by ICANN, a billion Telegram users could get their own second-level domains. 🖥 For example, @durov would get durov.gram, and @monk would get monk.gram. Users would be able to set up their interactive websites hosted by Telegram — just by typing one prompt ✨",
  "published_at": "2026-08-18T17:37:31+00:00",
  "view_count": 4050000,
  "view_count_text": "4.05M",
  "reactions": [
    {
      "emoji": "⭐",
      "emoji_id": null,
      "count": 17300,
      "count_text": "17.3K"
    },
    {
      "emoji": null,
      "emoji_id": "5373223594484587136",
      "count": 59200,
      "count_text": "59.2K"
    }
  ],
  "reaction_count": 113300,
  "forwarded_from": null,
  "media": [],
  "link_preview": null,
  "poll": null
}

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

`view_count`, Telegram'ın yuvarlanmış değerinden okunur (`3.96M`, 3960000 olur); orijinal değer `view_count_text` içindedir. `poll` (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ığı, kesin oy veren sayısı ve her seçeneğin yüzdesi ile oy sayısıdır; 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. Özel ve davetle erişilen bağlantılar (`t.me/c/...`) ile diğer URL'ler ücretsiz bir 400 hatası verir; bulunamayan bir gönderi ü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.