Social platforms
Telegram API
Retrieve Telegram profiles, channel posts and individual messages.
Read channel and group metadata, audience and media counts, paginated posts, reactions and media links. Search posts within a channel or retrieve a message by its permalink.
API availability: Available
http://localhost:3020Public API: https://api.scrapeatlas.com.Endpoints
/v1/telegram/channelGet a Telegram channel
Read public Telegram channel and group metadata, descriptions, avatars and audience counts. Optionally include photo, video, file and link inventory. The channel and profile routes are equivalent.
Reference/v1/telegram/profileGet a Telegram profile via /profile
Read public Telegram channel and group metadata, descriptions, avatars and audience counts. Optionally include photo, video, file and link inventory. The channel and profile routes are equivalent.
Reference/v1/telegram/channel/postsGet Telegram channel posts
Read one page of Telegram channel posts with channel metadata, media inventory, text, media and reactions. Continue older history with cursor or search within the channel with q.
Reference/v1/telegram/profile/postsGet Telegram posts via /profile/posts
Read one page of Telegram channel posts with channel metadata, media inventory, text, media and reactions. Continue older history with cursor or search within the channel with q.
Reference/v1/telegram/postGet a Telegram post
Retrieve a Telegram message by permalink, including text, publication time, views, reactions, media and link previews.
ReferenceQuick start
Create an API key on your account page, then call the public API. Values below are placeholders.
curl "https://api.scrapeatlas.com/v1/telegram/channel?handle=example" \
-H "x-api-key: YOUR_API_KEY"Coverage & limits
Coverage notes for this platform are not published yet.
| HTTP | failure.code | Meaning |
|---|---|---|
| 400 | invalid_request | Missing, duplicate, unsupported or invalid parameters. |
| 401 | unauthorized | Missing or invalid service key. |
| 403 | restricted_page | Public page explicitly reports restricted access. |
| 404 | not_found | Missing profile or generic contact fallback. |
| 429 | upstream_rate_limited | No automatic retry. |
| 502 | upstream_challenged unsupported_page | Challenge, unrecognized page or identity mismatch. |
| 502 | upstream_error unsafe_redirect response_too_large payload_too_complex request_limit | Bounded retrieval failed. |
| 503 | busy | All worker slots occupied. |
| 504 | timeout | Deadline exceeded. |
| 200 | partial | Unknown entity type or unavailable displayed counts. |
