> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_telegram_channel

# search_telegram_channel

> Posts in one public Telegram channel that match a keyword: text, date, views and post id. ₹0.20 per call; a result that finds nothing is ₹0.

## What it does

The posts of one public Telegram channel that contain a keyword: give the channel username (without the @) and the query, and get data with the matching posts, each with text, date, views and post id, up to limit per call (default 20).

Use it to find every time a channel mentioned a brand, a product or a price; [`get_telegram_channel_posts`](https://parel.si/docs/tools/get_telegram_channel_posts.md) reads the recent posts without a keyword, [`get_telegram_channel`](https://parel.si/docs/tools/get_telegram_channel.md) gives the channel's numbers; for the whole of X use [`search_x`](https://parel.si/docs/tools/search_x.md). Flat price per call; no matching post, or an unknown or private channel, is free. One to three seconds.

India: any public channel; the keyword is matched as written, so try the Hindi and the English spelling.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | How many hits, up to 50. Default 20.; max 50 |
| `query` | string | yes | The keyword to find in the channel's posts. |
| `channel` | string | yes | The channel's public username ("durov"), without the @. |

## What drives the cost

Flat per call for up to 50 hits; no match is free. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 45 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.20** per call (`cost_paise: 20`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 45 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_telegram_channel"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_telegram_channel"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_telegram_channel","input":{"limit":20,"query":"TON","channel":"durov"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "channel": "durov",
  "query": "TON",
  "scanned": 100,
  "matched": 5,
  "messages": [
    {
      "id": 521,
      "channel": "durov",
      "url": "https://t.me/durov/521",
      "type": "text",
      "date": "2026-06-01T15:40:13+00:00",
      "text": "💎 TON’s native currency is becoming Gram.\n\n🤑 Gram was the original name of TON’s currency in the first white paper.\n\n🌱 We’re returning to our roots — and starting a new chapter.\n\n✈️ This rebranding will pave the way for what comes next.…",
      "views": "6.86M",
      "author": "Pavel Durov",
      "is_forwarded": false,
      "forwarded_from": null,
      "reply_to": null,
      "link_preview": {
        "url": "https://gram.org/",
        "site_name": "GRAM Explorer",
        "title": "GRAM Explorer - TON Blockchain Explorer",
        "description": "Search TON wallet addresses, transactions, tokens and NFTs on GRAM Explorer."
      },
      "media": {
        "photos": [],
        "videos": [],
        "has_unsupported": true
      },
      "reactions": [
        {
          "emoji": "⭐",
          "count": "3.28K",
          "paid": true
        },
        {
          "emoji": "",
          "count": "23.8K",
          "paid": false
        },
        {
          "emoji": "",
          "count": "8.7K",
          "paid": false
        }
      ]
    },
    {
      "id": 517,
      "channel": "durov",
      "url": "https://t.me/durov/517",
      "type": "video",
      "date": "2026-05-18T14:56:21+00:00",
      "text": "🧠 AI devs asked for this — and we delivered.\n\n🤖 Bots can now talk to other bots on Telegram.\n\n💬 Autonomous agents now have a communication layer humans can follow.\n\n🛠 Start building!",
      "views": "10.4M",
      "author": "Pavel Durov",
      "is_forwarded": false,
      "forwarded_from": null,
      "reply_to": null,
      "link_preview": null,
      "media": {
        "photos": [],
        "videos": [
          {
            "url": "https://cdn4.telesco.pe/file/7e945b36d4.mp4",
            "thumb": "https://cdn4.telesco.pe/file/WAobWC7Cq4ZuCpYr-XI6oxIFLRzz4JkDfLH7I5llqr0_Wwe-G_QSY-Gyln0sqyqbgAjEbD_WzYqVnPZze6EST2vVH3I7gUJpD6XrwqFEbuz1gMO7ujSije09xZi3Y75lpiw-wVYDq5cDNvgKW6m2Em93sa1nvJP-lfL0KNsSFYbA4zghYYASztJfCiwyB-aIw2aKZFTzaql63m4K-m2…",
            "duration": "0:06"
          }
        ],
        "has_unsupported": true
      },
      "reactions": [
        {
          "emoji": "⭐",
          "count": "3.6K",
          "paid": true
        },
        {
          "emoji": "",
          "count": "23.3K",
          "paid": false
        },
        {
          "emoji": "",
          "count": "7.56K",
          "paid": false
        }
      ]
    },
    {
      "id": 515,
      "channel": "durov",
      "url": "https://t.me/durov/515",
      "type": "video",
      "date": "2026-05-17T14:44:56+00:00",
      "text": "🏆 We just awarded $52,420 to the winners of the Telegram Art Contest.\n\n🎨 The participants did an amazing job with the MiniDurov collectibles.\n\n💎 Their skills and ideas will enrich Telegram’s TON-based NFT ecosystem.",
      "views": "4.88M",
      "author": "Pavel Durov",
      "is_forwarded": false,
      "forwarded_from": null,
      "reply_to": null,
      "link_preview": null,
      "media": {
        "photos": [],
        "videos": [
          {
            "url": "https://cdn4.telesco.pe/file/c4225d3b52.mp4",
            "thumb": "https://cdn4.telesco.pe/file/bFJobDcDThNlMOl15vEgGfCrYkcqtJydhUNZxrpfG-Gy9PF2zC3HLk7OAW3hWz3CpCUNNZcteglN8k9nSd8XPepVlDtVC9eY9nAgA2I-MN-bSJbSxpGhPjs2-L-G_1VFWsSVlPsZiTQFWMVA3EUy-NtG5goo8y6LrhujODmknVROJezejUhkH2BnLWywQsiLfcKKI9L4ayq5yZi2g4f…",
            "duration": "0:14"
          }
        ],
        "has_unsupported": true
      },
      "reactions": [
        {
          "emoji": "⭐",
          "count": "3.16K",
          "paid": true
        },
        {
          "emoji": "",
          "count": "28.4K",
          "paid": false
        },
        {
          "emoji": "",
          "count": "14.4K",
          "paid": false
        }
      ]
    }
  ]
}
```

## Notes

- Flat per call for up to 50 hits; no match is free.
- Keyword match, not search by meaning: try spellings and the Hindi form too.
- Public channels only.

## Siblings

- [`get_telegram_channel_posts`](https://parel.si/docs/tools/get_telegram_channel_posts.md)
- [`get_telegram_channel`](https://parel.si/docs/tools/get_telegram_channel.md)
- [`search_x`](https://parel.si/docs/tools/search_x.md)
