Telegram Channel Post Search

Name: Telegram Channel Post Search
Price: 0.0015 USD
Availability: InStock
Author: Telegram

https://api.sandbase.ai/v1/api/telegram/web/channel-search

Returns messages matching a search keyword from a specific Telegram channel. Filter results using channel username, query term, and result limit.

Try this API Get API key

Price: $0.0015USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 2 required · 1 optional

Production route

Try the model

Playground

Open playground

Input

Channel(string)

Channel username (required).

Limit(integer)

1100

Number of hits (1-100, default 20). Range: 1 to 100.

Query(string)

Keyword (required).

OutputExample

Responseoutputs · 8.4 KB · 94 lines

[
  {
    "data": {
      "backend": "web",
      "channel": "telegram",
      "matched": 3,
      "messages": [
        {
          "author": "Telegram News",
          "channel": "telegram",
          "date": "2026-07-19T17:57:15+00:00",
          "forwarded_from": null,
          "id": 450,
          "is_forwarded": false,
          "link_preview": null,
          "media": {
            "has_unsupported": true,
            "photos": [],
            "videos": [
              {
                "duration": "0:14",
                "thumb": "https://cdn1.telesco.pe/file/XKRY6qR5SfrtXQ5AYuJ_eqq3Xdp15_X-5xmDozNhQrVplm9BF1upUGc_aENpwCJsftJMbCv_ntEJSvBNGUBLSt_bMWA-asFIfdXcwRqgZ17e0vUPqV_cXAO5o8NaRMBGFbNBnvgd1fmUYTTJ7dCKg8RTa4SM-ysNwkeUoQe7P2tQragKkY0EP9V2UUqIyigUSK6Zb8vOVCNoEhZw5EFV6CoOabMVQ3h-CvD0i22dRhC0oJRDB4mYbaAqw6mPOTLGqlJtMQj2-7bNrOVgmj6TI2f9HADZRSkLSovMYGkRYjMnCAi2csl5u6WavBpEgqIt73VCjo8ExXO-cel6nMDmPg",
                "url": "https://cdn1.telesco.pe/file/9998a6a814.mp4?token=D3EGEoodYLO8iHY9DBJzfm7rrV0E8OfAkONlHEl7Xug_CMtQLzZz854yjRaxU7-NwZFDBUH2qUnHQz73Zg1Fc-2mzGIDNA_IXE-QzW5Q6duMQbsrQ15fT2B9nGJahl7kp3gK8Km0UY6x_Zfd5yx6_5OdHJ-Zi-vbgDq-Yj6l8M_1RgZw-_30Z91nf8n5KSLpXUv6BaIp5IcFJ2_BvEN_dM_fem0rsDrV03JL3WzwItnKs0WOCwI_QY6_AM2ICe31SnSTZF8mMBX9C3t6XyxJ3IxRiR-079qN7tX46T5A1sVPJWixbdCjRZYmAMKWi-8nyRS08CFVtR6e3-qkdJFGpA"
              }
            ]
          },
          "reactions": [],
          "reply_to": null,
          "text": "⭐️ Rich Text Editor. You can now create articles and long posts in a visual editor that supports dozens of formatting options and allows you to generate text with privacy-conscious AI tools.\n\nJuly Features\n1 • 2 • 3 • 4 • More",
          "text_html": "⭐️ <b>Rich Text Editor.</b> You can now create articles and long posts in a <b>visual editor</b> that supports <b>dozens of formatting options</b> and allows you to <b>generate text</b> with privacy-conscious AI tools.<br><br>July Features<br><b>1</b> • <a href=\"https://t.me/telegram/451\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">2</a> •&nbsp;<a href=\"https://t.me/telegram/452\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">3</a> •&nbsp;<a href=\"https://t.me/telegram/453\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">4</a> •&nbsp;<a href=\"https://t.me/telegram/454\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">More</a>",
          "type": "video",
          "url": "https://t.me/telegram/450",
          "views": "1.25M"
        },
        {
          "author": "Telegram News",
          "channel": "telegram",
          "date": "2026-04-09T07:02:48+00:00",
          "forwarded_from": null,
          "id": 439,
          "is_forwarded": false,
          "link_preview": {
            "description": "In today's update we introduce an AI Editor that can translate, transform, or fix your text in just two taps, new features for Polls like attaching media and suggesting new responses for active polls, support for Live and Motion Photos in all apps, bots that…",
            "site_name": "Telegram",
            "title": "AI Editor, Mighty Polls, Live Photos, Bots Managed by Bots, and More",
            "url": "https://telegram.org/blog/ai-editor-mighty-polls-and-more"
          },
          "media": {
            "has_unsupported": false,
            "photos": [],
            "videos": []
          },
          "reactions": [],
          "reply_to": null,
          "text": "For all the features from this update, like scanning documents on iOS, extra security alerts to protect user privacy, and even more options for polls – check out our blog:\nhttps://telegram.org/blog/ai-editor-mighty-polls-and-more\n\nMarch Features\n1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • More",
          "text_html": "For all the features from this update, like <b>scanning documents</b> on iOS, extra <b>security alerts</b> to protect user privacy, and even more options for polls – check out our blog:<br><a href=\"https://telegram.org/blog/ai-editor-mighty-polls-and-more\" target=\"_blank\" rel=\"noopener\">https://telegram.org/blog/ai-editor-mighty-polls-and-more</a><br><br>March Features<br><a href=\"https://t.me/telegram/429\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">1</a> • <a href=\"https://t.me/telegram/430\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">2</a> •&nbsp;<a href=\"https://t.me/telegram/431\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">3</a> •&nbsp;<a href=\"https://t.me/telegram/432\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">4</a> •&nbsp;<a href=\"https://t.me/telegram/433\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">5</a> • <a href=\"https://t.me/telegram/434\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">6</a> • <a href=\"https://t.me/telegram/435\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">7</a> • <a href=\"https://t.me/telegram/436\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">8</a> • <a href=\"https://t.me/telegram/437\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">9</a> • <b>More</b>",
          "type": "text",
          "url": "https://t.me/telegram/439",
          "views": "3.01M"
        },
        {
          "author": "Telegram News",
          "channel": "telegram",
          "date": "2026-01-07T18:17:14+00:00",
          "forwarded_from": null,
          "id": 421,
          "is_forwarded": false,
          "link_preview": null,
          "media": {
            "has_unsupported": true,
            "photos": [],
            "videos": [
              {
                "duration": "0:06",
                "thumb": "https://cdn1.telesco.pe/file/qe5GGy7aw2nxTfzF0neoh9J7LEh9ucW2rFEMr_xLvdMaW3Nn7coSWXqzBSpLsv867V4e_XrCk0JhG80mVPfv6d8PioQpQmxlNn3BDMD8HcpU7iIYULjJAQRRGhsJiPTpYd6Egfl8wIzXOz2sTzEXs0Gmjv_UKEGbpB0kBR1LbPIRbpSQ789JhOkhhtZ1nUJMxNOYHrTrF_654yg0DoDc_52grBklRO8KVZskocQ2RDl8TgKo8pc67ey044SqcpLmvCKfUJ0XJwSDcZGVdPfWr1prNLLml90QhMPp6j4kpEE_lDA6wogOQzUIwYbsaxJGe9rKu7Q4HemoBTUAR2jSMA",
                "url": "https://cdn1.telesco.pe/file/042af6c2a6.mp4?token=Hltkrr43lCkAS-vJkzp061vat1eIC8SZeamlPbiM2YXCRZ87ekBxlXBEV94o-SEBt5yJASplA8w_brRts8IvbYBvfS_7Bkwt_4_pITg0N9tfGBRU5fKRbTuINUjmztX1Hu2KydvHndhOwo7ntj83lHhe14KGm2cvnIDz6f55g2z9KF8Mv1PDOHY_A3uf1kjtilEQJ_XllF4yaVmvCfOGbekpS6g7Wqs5p779sWfj-cw3w9kAtFQ6VIEf3x739OI1gYbzlq-PmcpEIp4FdhUo6L_oCSVVT-AwAHb8AAeidR44n1A-cJcBd5t8alw5Lxke1iT9zG_4YsLztMIMwYmDXA"
              }
            ]
          },
          "reactions": [],
          "reply_to": null,
          "text": "AI Summaries. Long posts in channels can now be instantly summarized – and Instant View articles (like our blog) show an AI summary at the top.\n\nThese summaries use open-source AI models running on Cocoon – a decentralized network built by Telegram to maximize privacy.\n\nJanuary Features\n1 • 2 • 3 • More",
          "text_html": "<b>AI Summaries.</b> Long posts in channels can now be <b>instantly summarized</b> –&nbsp;and Instant View articles <i>(like our blog)</i> <b>show an AI summary</b> at the top.<br><br>These summaries use <b>open-source AI models</b> running on <a href=\"https://t.me/durov/462\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">Cocoon</a> –&nbsp;a <b>decentralized network</b> built by Telegram to <b>maximize privacy</b>.<br><br>January Features<br><b>1</b> •&nbsp;<a href=\"https://t.me/telegram/422\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">2</a> •&nbsp;<a href=\"https://t.me/telegram/423\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">3</a> •&nbsp;<a href=\"https://t.me/telegram/424\" target=\"_blank\" rel=\"noopener\" onclick=\"return confirm('Open this link?\\n\\n'+this.href);\">More</a>",
          "type": "video",
          "url": "https://t.me/telegram/421",
          "views": "1.88M"
        }
      ],
      "note": "网页预览无原生搜索，此为近期历史的尽力过滤；完整搜索需启用 MTProto 后端",
      "query": "privacy",
      "scanned": 100
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price: $0.0015 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

channel: string · required
query: string · required
limit: integer · optional

Access

Provider: Telegram
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/telegram/web/channel-search
Authentication: Bearer API key

API README

Telegram Channel Post Search API

Search for messages within a target Telegram channel matching a query string using the channel username in channel.

Use cases

Search channel history for specific topic mentions or announcements.
Locate media posts matching specific keyword queries within a channel.
Track historical coverage of particular terms across a channel feed.

Request

curl -X POST "https://api.sandbase.ai/v1/api/telegram/web/channel-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel": "telegram", "query": "privacy"}'

Parameters

Name	Type	Required	Description
`query`	string	Yes	Keyword (required).
`channel`	string	Yes	Channel username (required).
`limit`	integer	No	Number of hits (1-100, default 20).

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "messages": [
    {
      "author": "Telegram News",
      "date": "2026-07-19T17:57:15+00:00",
      "id": 450,
      "text": "⭐️ Rich Text Editor. You can now create articles and long posts in a visual editor that s…",
      "text_html": "⭐️ Rich Text Editor. You can now create articles and long posts in a visual editor that s…",
      "type": "video",
      "url": "https://t.me/telegram/450",
      "views": "1.25M"
    }
  ]
}

Notes

Accepts a limit between 1 and 100 hits, with a default of 20.
Keyword matching through query is case-insensitive.

Related APIs

Telegram Batch Channel Info: Returns basic channel profile details including title, description, and verified status for multiple public Telegram channels at once.
Telegram Channel Info: Returns public metadata for a Telegram channel, including title, description, verified status, and username, using the public web preview.
Telegram Channel Posts: Get a public Telegram channel's recent posts: text, media, forwards, replies, link previews, reactions, views and time, with cursor pagination.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/telegram/web/channel-search

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/telegram/web/channel-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "limit": 20,
  "query": "privacy",
  "channel": "telegram"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Telegram Channel Post SearchThis API `Telegram`	$0.0015 per call	JSON	Jul 31, 2026
Telegram Batch Channel Info `Telegram`	$0.01 per call	JSON	Jul 31, 2026
Telegram Channel Info `Telegram`	$0.0015 per call	JSON	Jul 31, 2026
Telegram Channel Posts `Telegram`	$0.0015 per call	JSON	Jul 31, 2026
Telegram Post Comments `Telegram`	$0.0015 per call	JSON	Jul 31, 2026
Telegram Channel Post Details `Telegram`	$0.0015 per call	JSON	Jul 31, 2026

Questions

FAQ

How do I use the Telegram Channel Post Search API?

Send a POST request to https://api.sandbase.ai/v1/api/telegram/web/channel-search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Telegram Channel Post Search API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Telegram Channel Post Search API accept?

Required: channel (string) and query (string). Optional: limit (integer). The Parameters table and the Playground on this page list every field.

What does the Telegram Channel Post Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Telegram developer account or API key?

No. Telegram Channel Post Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Telegram API access separately.