# Telegram Post API (https://www.socialcrawl.dev/platforms/telegram/post)

> Returns one public Telegram post by its t.me URL, including the text, publish time, view count, the per-emoji reaction breakdown, and direct media URLs. View and reaction counts on posts are rounded by Telegram's own public preview, so use them for ranking rather than for exact deltas.

TL;DR: `GET /v1/telegram/post` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Public Telegram post URL, in the form https://t.me/{handle}/{id} |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/telegram/post?url=https%3A%2F%2Ft.me%2Fdurov%2F546" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What URL format does this endpoint take?

A public post permalink in the form https://t.me/{handle}/{id}. That is the link Telegram's own share button produces, so you can pass what a user copied straight through.

### How is this different from the channel posts endpoint?

This returns exactly one post you already have a link to, for the same price as a full page. Use the channel posts endpoint when you want history or do not know the post id yet.

### Are the view and reaction counts exact?

They are rounded to three significant figures by Telegram's own public surface, so 931,193 views reads as 931,000. Treat them as ranking signals. The channel profile's subscriber count is the exact figure.

### What comes back for a post with several photos?

Every image in the album is returned as its own URL in the media list, in the order Telegram shows them, so you never silently lose the second and later pictures in a group.

### Can I read a post in a private channel?

No. Only posts in public channels with a public preview page can be read. A link into a private channel returns a not-found response rather than a partial result.

See the full Telegram API: https://www.socialcrawl.dev/platforms/telegram

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get view counts for a single Telegram post?
- Which API reads a t.me post link and returns structured JSON?