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 reads the recent posts without a keyword, get_telegram_channel gives the channel's numbers; for the whole of X use search_x. 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.

FieldTypeRequiredDescription
limitintegernoHow many hits, up to 50. Default 20.; max 50
querystringyesThe keyword to find in the channel's posts.
channelstringyesThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout45 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_telegram_channel"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_telegram_channel"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

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:

{
  "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

This page as Markdown: /docs/tools/search_telegram_channel.md. Something wrong or missing: hello@parel.si.