Docs/Telegram Messages
Docs / API reference
POST/v1/data/telegram/messages
Telegram Messages
Get recent messages from a public Telegram channel with text, views, reactions, media, forwards, replies, and link previews.
Execution model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| username | string | Required | Channel username, with or without @. 1-100 characters. |
| limit | number | Optional | Messages to return (1-50). |
Response fields
| Field | Type | Description |
|---|---|---|
| username / count | string / number | Channel username and number of messages returned. |
| messages[] | array | Message rows. See the fields below. |
| id / text / date / views / author / url | number / string | Message ID, text, ISO date, view count, author signature, and t.me permalink. Optional fields are omitted when Telegram does not show them. |
| reactions[] | array | Optional: emoji and count per reaction; omitted when the message has none. |
| media | object | Optional: type (photo, video, gallery, document, sticker) with url, thumbnail, or photo/video counts for galleries. |
| forwarded_from / reply_to / link_preview | object | Optional: forward source (name, url), replied-to message (author, text), and link preview (title, description, site_name). |
Request and response
curl -X POST "https://api.datablue.dev/v1/data/telegram/messages" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "durov",
"limit": 20
}'Example response
{
"success": true,
"time_taken": 1.24,
"username": "durov",
"count": 1,
"messages": [
{
"id": 380,
"text": "Telegram now supports example feature for all users.",
"date": "2026-11-10T12:00:00+00:00",
"views": 2100000,
"author": "Pavel Durov",
"reactions": [
{
"emoji": "👍",
"count": 41000
},
{
"emoji": "🔥",
"count": 12000
}
],
"media": {
"type": "photo",
"url": "https://cdn4.telesco.pe/file/example.jpg"
},
"url": "https://t.me/durov/380"
}
]
}