Channel

GET/v1/telegram/channel1 credit

Returns a public Telegram channel: name, description, avatar, verification, exact subscriber count and the number of photos, videos, files and links it has shared.

01Query parameters

Name	Type	Description
handlerequired	string	The public channel's username or link: `durov`, `@durov` or `https://t.me/durov`.
cache_max_ageoptional	string	Accepted for compatibility: how old a cached answer may be. Every call is fetched fresh, so it does not change the answer or the price.Accepted values:`1d3d7d14d30d`

02Request

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

03Responses

Real answers from the API. Lists are shortened to 2 items.

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
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

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

04Notes

`subscriber_count` is an exact integer, `subscriber_count_text` the formatted figure. For a group, `member_count` is filled instead and the media counters are null; a counter Telegram does not show is null. An unknown channel is a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.