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
| Ad | Tür | Açıklama |
|---|---|---|
| urlzorunlu | string | Herkese açık gönderinin URL'si, örneğin `https://t.me/durov/543`. |
| 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/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.