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

NameTypeRequirementDescription
usernamestringRequiredChannel username, with or without @. 1-100 characters.
limitnumberOptionalMessages to return (1-50).

Response fields

FieldTypeDescription
username / countstring / numberChannel username and number of messages returned.
messages[]arrayMessage rows. See the fields below.
id / text / date / views / author / urlnumber / stringMessage ID, text, ISO date, view count, author signature, and t.me permalink. Optional fields are omitted when Telegram does not show them.
reactions[]arrayOptional: emoji and count per reaction; omitted when the message has none.
mediaobjectOptional: type (photo, video, gallery, document, sticker) with url, thumbnail, or photo/video counts for galleries.
forwarded_from / reply_to / link_previewobjectOptional: 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"
    }
  ]
}