​
Sources

Source endpoints resolve Telegram sources and return source metadata or messages.

​
Get source by reference

GET /v1/sources/by-ref?source=<source_ref>
Required scope: 
messages.read

​
Query parameters

NameTypeRequiredDescription
sourcestringyes@username, https://t.me/name, t.me/name, invite link, or peer id

​
Response

{
  "source_ref": "@Tbatashev",
  "source_type": "channel",
  "telegram_peer_id": "-1001870525842",
  "title": "Batashev / Systems",
  "username": "Tbatashev",
  "invite_link": null,
  "is_active": true,
  "ai_summary": "The source is focused on systems thinking, AI automation, open-source projects, and practical notes on building with Telegram and AI infrastructure."
}

​
Notes

ai_summary is a compact AI-generated description of the source based on recent public content available to the service.

​
List source messages

GET /v1/sources/messages?source=<source_ref>&limit=50&offset=0
Required scope: 
messages.read

​
Query parameters

NameTypeRequiredDefaultDescription
sourcestringyes-Telegram source reference
limitintegerno50Maximum 200
offsetintegerno0Realtime pagination offset
period_fromdatetimenonullLower datetime bound
period_todatetimenonullUpper datetime bound

​
Response

{
  "items": [
    {
      "source_ref": "@Tbatashev",
      "telegram_message_id": "604",
      "text": "Full message text.",
      "sender_peer_id": "123456",
      "posted_at": "2026-04-10T12:00:00Z",
      "message_link": "https://t.me/Tbatashev/604"
    }
  ],
  "limit": 50,
  "offset": 0
}