Docs / API reference

POST/v1/data/telegram/message

Telegram Message

Get one public Telegram channel message by ID with text, views, reactions, media, forward, reply, and link preview.

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.
message_idnumberRequiredMessage ID: the number at the end of the t.me/<channel>/<message_id> link.

Response fields

FieldTypeDescription
messageobjectThe message. 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/message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "username": "durov",
  "message_id": 380
}'
Example response
{
  "success": true,
  "time_taken": 0.88,
  "message": {
    "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"
  }
}