# Telegram API: List channel posts

> Lists the latest posts from a public Telegram channel preview, with text, posting time, approximate views, edit flag, forwarded source, thumbnails and post links.

Unofficial. Not affiliated with or endorsed by Telegram.

- Page: https://fous.com/methods/t.me/list-channel-posts
- Method: `t.me/list_channel_posts`, version 1
- Website: t.me
- Returns: text, posted_at, views, edited, forwarded_from_channel, thumbnail links, post_link, post_number
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `channel` | string | yes | `"https://t.me/TelegramTips"` | Public channel username with or without @, or its t.me link, for example durov. |
| `max_results` | integer | no | `45` | Maximum number of recent posts to return, for example 40. Up to 100. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "channel": "https://t.me/TelegramTips",
  "max_results": 45
}
```

Its output:

```json
{
  "posts": [
    {
      "text": "Buttons Inside Messages. Developers are able to put multiple buttons inside any message.\n\nWith ephemeral messages, this allows for automated flows that can run entire apps in one message.\n\nMore information for developers is available here.",
      "views": 1280000,
      "edited": false,
      "post_link": "https://t.me/TelegramTips/576",
      "posted_at": "2026-10-16T16:47:51+00:00",
      "post_number": 576,
      "photo_thumbnail_links": [],
      "video_thumbnail_links": [
        "https://cdn1.telesco.pe/file/aUIHQwn8GPF_LRNxPwSSXdBtBd9BBrScp_l_ebOBy8JrYclghi3Tl6iuegdn3cJtTng0kM75ScpH4feNG7TNKj21b5SfiJzcjcrpvCIVIc3vB91b67FEA64_Q3hnrrnba9L1ZCZLn0GLQF_bgto98_JVDF3HgQf26iY0avlu-PQNn0pAQcVDva5PvXOWCpoiMsdn-XxTEVeF8CzRhR1ZVQ3YL_AXZwi7oBUkhdBpr2Qyuk8IeMInQtouZ3CqXTxCU7QsHcPSCM5syjd…"
      ],
      "forwarded_from_channel": null
    },
    {
      "text": "Welcome Messages. Group and channel owners can create messages to greet new members and give them extra info.\n\nWelcome messages are only visible to each new member – and can include media, rich formatting and more.\n\nTo add a welcome message in your group or channel, open its profile and select Edit …",
      "views": 7560000,
      "edited": false,
      "post_link": "https://t.me/TelegramTips/575",
      "posted_at": "2026-08-27T22:11:03+00:00",
      "post_number": 575,
      "photo_thumbnail_links": [],
      "video_thumbnail_links": [
        "https://cdn1.telesco.pe/file/NGmNxtNS2xEOeEq-mEImzZhz_xruCBvJvXvHDmwJIMpi2TjY2-NSGp4PL-Ihj63PNBxJfINS40C5_aSYmE2J6wcSCwkQRKzuWRvpF-xsgGTLcn1Mni_pqMGSIVGszKLoyYbaxxI8swO3g5y-upSh4ZcZrDS3GsWq0on_sexAHfKx7dlPpvB0TBuGn3lWfZTju-Rns5s3pH_okTNTm29Yq8Fs8jcn8mIv0joCMivW6imGlUM1qWS-rYoLYnQi8D_SJxvaUuu47JfdzI-…"
      ],
      "forwarded_from_channel": null
    },
    {
      "text": "Telegram Communities. Several groups, channels and bots can be linked together in a single community, where members can view and join other chats instantly.\n\nAdmins in communities have granular privacy controls that allow them to hide certain chats and control whether members can add new chats or on…",
      "views": 10500000,
      "edited": false,
      "post_link": "https://t.me/TelegramTips/574",
      "posted_at": "2026-07-22T21:06:21+00:00",
      "post_number": 574,
      "photo_thumbnail_links": [],
      "video_thumbnail_links": [
        "https://cdn1.telesco.pe/file/eE6PBgH68wpuqeeZEI5WkoZ6BdWF5IjsGDiMYQ_id74iaRI6UGH0i5Soh7V54eiUTnGv_pPEcvGBD98-TFuHciJCr76HTu6b-hq1LtWv0mAwKJR3KiqSp1gCExp7AGp_HQx61oRSZLcA_lZV5-x9Y0Sa5Ks5gv8ZZjPrqd5MaJoD5ueFBHksTE4kpylTuf4VvYvOB5Qs5kxleeOkr2_99H0jL-r0eEsN0N61SHi8qI0MjN2CU0pmJU0VI_SfJgVeIMZ5jge73DpS9sm…"
      ],
      "forwarded_from_channel": null
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"t.me/list_channel_posts","input":{"channel":"https://t.me/TelegramTips","max_results":45}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the latest 40 posts from the durov channel with their view counts and post times
- Pull the 15 most recent posts from @techdigest_news including which ones were edited
- List recent posts from the t.me/markets_daily channel with links and any forwarded sources
- I need the last 60 messages from the public channel newsroom_alpha, with thumbnails and post numbers
- Get up to 25 recent posts from the travel_deals_eu channel on Telegram, showing text and approximate views

## Input schema

```json
{
  "type": "object",
  "required": [
    "channel"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Public channel username with or without @, or its t.me link, for example durov."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of recent posts to return, for example 40. Up to 100."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "posts"
  ],
  "properties": {
    "posts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "text",
          "posted_at",
          "views",
          "edited",
          "forwarded_from_channel",
          "photo_thumbnail_links",
          "video_thumbnail_links",
          "post_link",
          "post_number"
        ],
        "properties": {
          "text": {
            "type": "string",
            "description": "Plain text of the post, including link labels."
          },
          "views": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Displayed view count converted to an approximate whole number, or null when unavailable."
          },
          "edited": {
            "type": "boolean",
            "description": "Whether the preview marks this post as edited."
          },
          "post_link": {
            "type": "string",
            "description": "Link to the post."
          },
          "posted_at": {
            "type": "string",
            "format": "date-time",
            "description": "Post date and time in UTC, ISO 8601."
          },
          "post_number": {
            "type": "integer",
            "description": "Channel post number."
          },
          "photo_thumbnail_links": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Links to photo thumbnails."
          },
          "video_thumbnail_links": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Links to video thumbnails."
          },
          "forwarded_from_channel": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name shown as the forwarded source, or null."
          }
        }
      },
      "description": "Channel posts in newest-first order."
    }
  }
}
```

## See more

- [Telegram API: Get public channel](https://fous.com/methods/t.me/get-channel.md): Gets the title, username, description, subscriber total, verification, photo and public media totals of a public Telegram channel.
- [Threads API: List recent posts](https://fous.com/methods/threads.com/list-recent-posts.md): Lists an account's latest public Threads posts, newest first, with text, engagement counts, thumbnails and links. Only posts shown without logging in are returned.
- [Instagram API: List recent posts](https://fous.com/methods/instagram.com/list-recent-posts.md): Lists the latest publicly embeddable posts and reels from an Instagram account, newest first. Without login Instagram may show fewer posts than requested. View counts that are not available are null.
- [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate.
- [Mastodon API: List recent posts](https://fous.com/methods/mastodon.social/list-recent-posts.md): Lists a Mastodon account's latest public posts, newest first. Replies and boosts are optional. Private and unlisted posts are left out.
- [Bluesky API: List recent posts](https://fous.com/methods/bsky.app/list-recent-posts.md): Lists an account's latest public Bluesky posts, newest first. Replies and reposts are left out unless requested; a repost's time is when the account reposted it.
- [Medium API: List a writer's or publication's latest articles](https://fous.com/methods/medium.com/list-author-articles.md): Lists the latest public articles by a Medium writer or publication (by username, publication name or Medium link), with dates, reading times, claps, member-only labels and tags.
- [Substack API: List newsletter posts](https://fous.com/methods/substack.com/list-newsletter-posts.md): Finds a Substack newsletter by name or web address and returns its latest public posts with dates, authors, access level and engagement counts.
- [All Telegram methods](https://fous.com/methods/t.me.md)
