Endpoint Playground

Try the Telegram Channel Posts API

Returns one page of up to 20 posts from a public Telegram channel's web preview (t.me/s/{username}), newest first. Each post has its id, link, text, links found in the text, publish time, edited flag, view count, author signature, forwarded-from and reply references, photo and video thumbnails, link-preview card, and reaction tallies. Page backwards by passing the previous response's next_before as before; has_more is false and next_before is omitted on the last page. Pass query to search inside the channel instead of browsing; search pages use the same before cursor. A search with no matches returns an empty posts list. Views are the preview's abbreviated figures (for example 32.4K) and are approximate above 1,000. Media entries carry thumbnail references only, never playable file URLs. Polls, documents, voice notes and stickers appear as an unsupported media entry. Private channels, groups, bots, user accounts and channels that disabled their web preview are not supported. Telegram's terms restrict using platform content to train AI or machine-learning systems, so results must not be used for that purpose.

Request: GET /telegram/channel-posts
Cost: 1 credit/request
Auth: apiKey

Telegram Channel Posts API documentation Telegram platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/telegram/channel-posts?username=durov' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
username	string	Yes	durov	Public channel username, with or without @ or a t.me link
before	integer	No		Return only posts with an id lower than this; use the previous response's next_before. Omit for the newest page
query	string	No		Search term to look for inside the channel, up to 128 characters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "username": "durov",
    "title": "Pavel Durov",
    "posts": [
      {
        "id": 531,
        "username": "durov",
        "url": "https://t.me/durov/531",
        "text": "Telegram now has a Rich Text Editor.\n\nIt supports tables, headings, inline media, lists, AI content, formulas, and more.",
        "published_at": "2026-07-16T20:45:25+00:00",
        "edited": false,
        "views": 5840000,
        "author": "Pavel Durov",
        "media": [
          {
            "type": "video",
            "url": "https://t.me/durov/531",
            "thumbnail_url": "https://cdn4.telesco.pe/file/THUMB_ID.jpg"
          }
        ],
        "reactions": [
          {
            "count": 6300,
            "paid": true
          },
          {
            "custom_emoji_id": "5265077361648368841",
            "count": 54600,
            "paid": false
          }
        ]
      }
    ],
    "has_more": true,
    "next_before": 531
  }
}

More Telegram endpoints

Get a public Telegram channel profile Get a public Telegram group profile Get one public Telegram channel post

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requesttelegram.channelPostsResponseDocTelegram

GET /telegram/channel-posts

List posts from a public Telegram channel

Response behavior

- A page holds at most 20 posts. `has_more` is `false` and `next_before` is omitted on the last page of the channel's history or of the search results. - A search with no matches returns an empty `posts` list, not an error. A channel page that comes back empty without Telegram's own "no posts" notice is reported as an upstream error instead of an empty list. - `views` and reaction counts are expanded from Telegram's abbreviated figures (for example `32.4K`), so they are approximate above 1,000. - A standard reaction has an `emoji`. A custom (Premium) emoji reaction has no glyph in the preview and carries `custom_emoji_id` instead. The Telegram Stars reaction has `paid: true` and neither. - `media[].type` is `photo`, `video` or `unsupported`. Media entries carry thumbnail references only, never playable file URLs. `unsupported` means an attachment the web preview cannot display, such as a poll, document, voice note or sticker. - Private channels, groups, bots, user accounts and channels that turned off their web preview are not supported; the error says which case it was. - Telegram's terms restrict using platform content to train AI or machine-learning systems, so results must not be used for that purpose. Example response (trimmed to one post): ```json { "code": 200, "msg": "OK", "data": { "username": "durov", "title": "Pavel Durov", "posts": [ { "id": 531, "username": "durov", "url": "https://t.me/durov/531", "text": "Telegram now has a Rich Text Editor.\n\nIt supports tables, headings, inline media, lists, AI content, formulas, and more.", "published_at": "2026-07-16T20:45:25+00:00", "edited": false, "views": 5840000, "author": "Pavel Durov", "media": [ { "type": "video", "url": "https://t.me/durov/531", "thumbnail_url": "https://cdn4.telesco.pe/file/THUMB_ID.jpg" } ], "reactions": [ { "count": 6300, "paid": true }, { "custom_emoji_id": "5265077361648368841", "count": 54600, "paid": false } ] } ], "has_more": true, "next_before": 531 } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

username

requiredstring

Public channel username, with or without @ or a t.me link

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "username": "durov",
    "title": "Pavel Durov",
    "posts": [
      {
        "id": 531,
        "username": "durov",
        "url": "https://t.me/durov/531",
        "text": "Telegram now has a Rich Text Editor.\n\nIt supports tables, headings, inline media, lists, AI content, formulas, and more.",
        "published_at": "2026-07-16T20:45:25+00:00",
        "edited": false,
        "views": 5840000,
        "author": "Pavel Durov",
        "media": [
          {
            "type": "video",
            "url": "https://t.me/durov/531",
            "thumbnail_url": "https://cdn4.telesco.pe/file/THUMB_ID.jpg"
          }
        ],
        "reactions": [
          {
            "count": 6300,
            "paid": true
          },
          {
            "custom_emoji_id": "5265077361648368841",
            "count": 54600,
            "paid": false
          }
        ]
      }
    ],
    "has_more": true,
    "next_before": 531
  }
}

Try the Telegram Channel Posts API

Request: GET /telegram/channel-posts
Cost: 1 credit/request
Auth: apiKey

Telegram Channel Posts API documentation Telegram platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/telegram/channel-posts?username=durov' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
username	string	Yes	durov	Public channel username, with or without @ or a t.me link
before	integer	No		Return only posts with an id lower than this; use the previous response's next_before. Omit for the newest page
query	string	No		Search term to look for inside the channel, up to 128 characters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "username": "durov",
    "title": "Pavel Durov",
    "posts": [
      {
        "id": 531,
        "username": "durov",
        "url": "https://t.me/durov/531",
        "text": "Telegram now has a Rich Text Editor.\n\nIt supports tables, headings, inline media, lists, AI content, formulas, and more.",
        "published_at": "2026-07-16T20:45:25+00:00",
        "edited": false,
        "views": 5840000,
        "author": "Pavel Durov",
        "media": [
          {
            "type": "video",
            "url": "https://t.me/durov/531",
            "thumbnail_url": "https://cdn4.telesco.pe/file/THUMB_ID.jpg"
          }
        ],
        "reactions": [
          {
            "count": 6300,
            "paid": true
          },
          {
            "custom_emoji_id": "5265077361648368841",
            "count": 54600,
            "paid": false
          }
        ]
      }
    ],
    "has_more": true,
    "next_before": 531
  }
}

List posts from a public Telegram channel

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "username": "durov", "title": "Pavel Durov", "posts": [ { "id": 531, "username": "durov", "url": "https://t.me/durov/531", "text": "Telegram now has a Rich Text Editor.\n\nIt supports tables, headings, inline media, lists, AI content, formulas, and more.", "published_at": "2026-07-16T20:45:25+00:00", "edited": false, "views": 5840000, "author": "Pavel Durov", "media": [ { "type": "video", "url": "https://t.me/durov/531", "thumbnail_url": "https://cdn4.telesco.pe/file/THUMB_ID.jpg" } ], "reactions": [ { "count": 6300, "paid": true }, { "custom_emoji_id": "5265077361648368841", "count": 54600, "paid": false } ] } ], "has_more": true, "next_before": 531 } }