[Integrations](https://spiral.ai/integrations) › [Grok](https://spiral.ai/integrations/grok) › [Telegram channel post search](https://spiral.ai/integrations/grok/telegram-channel-post-search)

# How to Use Telegram channel post search in Grok

Find keyword matches inside one Telegram channel. Use it for a specific topic, checking whether results came from full-history server search or recent-history filtering.

|  |  |
| --- | --- |
| Model | Telegram channel post search |
| Available through | TikHub |
| Category | Social Media |
| Price | $0.0013 per request. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Telegram channel post search in Grok

- Use Telegram channel post search to find 'privacy' in telegram and summarize the matching announcements, stating whether the search covered full history or only recent posts.
- Use Telegram channel post search to look this up and give me the result as a table.
- Pull the latest numbers from Telegram channel post search and tell me what changed since last week.
- Check Telegram channel post search and summarize what you find in three bullet points.
- Pull the newest data from Telegram channel post search and give me the result as a table.

## How to set up Telegram channel post search in Grok

Pick the way that suits you. Each takes about two minutes.

### Use the Grok connector

1. **Add a custom connector**: In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

3. **Check that it is connected**: Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

### Use the Spiral skill

1. **Send Grok this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Telegram channel post search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "tikhub",
    "model": "tikhub/telegram-web-fetch-channel-search",
    "input": {
      "query": "TON",
      "channel": "durov"
    }
  }'
```

Then paste one of the prompts above: Grok finds Telegram channel post search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/grok

## Telegram channel post search tools and prices

- [Telegram Web · Search posts in a channel](https://spiral.ai/tools/tikhub/tikhub/telegram-web-fetch-channel-search) (TikHub): $0.0013 per request.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | 20 | Number of hits |

## What can you do with Telegram channel post search in Grok?

Prepare a source-based briefing on a public Telegram publisher or announcement. Use channel descriptions for publisher context and the available posts, recommendations, or discussions for the specific question.

### Assess public publishers for a campaign

Discover related channels, compare their profiles, inspect recent posts and relevant keyword matches, then review selected announcements and their discussion threads. Use the evidence to assess subject fit before approaching a publisher.

### Prepare a product announcement review

Identify public channels covering a product category, establish publisher context, find announcement coverage, and inspect individual posts and discussion questions. Separate what publishers announced from what readers asked.

### Build a release announcement reading list

Read recent channel posts, search for a named feature, and inspect the selected announcements individually. Produce a dated list of source posts for an editor to review.

### Find gaps in product explanations

Find posts about a feature and review their linked discussion comments for recurring product questions. Compare those questions with the published explanations without creating profiles of commenters.

### Plan a specialist publication's coverage

Discover related publishers, compare channel descriptions, search for coverage of a specific topic, and inspect representative posts. Identify subjects that deserve an original explanation or follow-up.

## Overview

- [TikHub](https://spiral.ai/providers/tikhub)
- [All Grok guides](https://spiral.ai/integrations/grok)

## Telegram channel post search in other agents

- [Amp](https://spiral.ai/integrations/amp/telegram-channel-post-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/telegram-channel-post-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/telegram-channel-post-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/telegram-channel-post-search)
- [Cline](https://spiral.ai/integrations/cline/telegram-channel-post-search)
- [Codex](https://spiral.ai/integrations/codex/telegram-channel-post-search)
- [Cursor](https://spiral.ai/integrations/cursor/telegram-channel-post-search)
- [Devin](https://spiral.ai/integrations/devin/telegram-channel-post-search)
- [dots](https://spiral.ai/integrations/dots/telegram-channel-post-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/telegram-channel-post-search)
- [Gemini](https://spiral.ai/integrations/gemini/telegram-channel-post-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/telegram-channel-post-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/telegram-channel-post-search)
- [goose](https://spiral.ai/integrations/goose/telegram-channel-post-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/telegram-channel-post-search)
- [Hermes](https://spiral.ai/integrations/hermes/telegram-channel-post-search)
- [Instinct](https://spiral.ai/integrations/instinct/telegram-channel-post-search)
- [Manus](https://spiral.ai/integrations/manus/telegram-channel-post-search)
- [Muse](https://spiral.ai/integrations/muse/telegram-channel-post-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/telegram-channel-post-search)
- [n8n](https://spiral.ai/integrations/n8n/telegram-channel-post-search)
- [Notion](https://spiral.ai/integrations/notion/telegram-channel-post-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/telegram-channel-post-search)
- [opencode](https://spiral.ai/integrations/opencode/telegram-channel-post-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/telegram-channel-post-search)
- [Raycast](https://spiral.ai/integrations/raycast/telegram-channel-post-search)
- [VS Code](https://spiral.ai/integrations/vscode/telegram-channel-post-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/telegram-channel-post-search)
- [Zapier](https://spiral.ai/integrations/zapier/telegram-channel-post-search)

## More Grok guides

- [Telegram Post Details ScrapeCreators](https://spiral.ai/integrations/grok/telegram-post-details-scrapecreators)
- [Telegram channel posts](https://spiral.ai/integrations/grok/telegram-channel-posts)
- [Telegram Channel Posts ScrapeCreators](https://spiral.ai/integrations/grok/telegram-channel-posts-scrapecreators)
- [Telegram channel profile](https://spiral.ai/integrations/grok/telegram-channel-profile)
- [Telegram Channel Details](https://spiral.ai/integrations/grok/telegram-channel-details)
- [Telegram channel profiles in bulk](https://spiral.ai/integrations/grok/telegram-channel-profiles-in-bulk)

## Questions about Telegram channel post search in Grok

**Can Grok use Telegram channel post search?**

Yes. Add Spiral to Grok as an MCP server, and Grok can find and run Telegram channel post search like any built-in tool.

**How much does Telegram channel post search cost in Grok?**

$0.0013 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Grok plan is separate.

**Do I need a TikHub account to use Telegram channel post search in Grok?**

No. Spiral runs Telegram channel post search on its own TikHub account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Telegram channel post search in Grok?**

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

**Does Grok wait while Telegram channel post search runs?**

Telegram channel post search runs in the background. Grok starts the run, checks on it and gives you the json when it's ready.

**Which Telegram channels are covered?**

These lookups target public channels. Profile and post retrieval depend on public t.me previews, and a public channel can disable its web preview.

**Can previously available posts disappear?**

Yes. Telegram removes a deleted channel message for all subscribers, so previously retrieved content may no longer be available at its original source.

**Does a keyword search cover the entire channel history?**

Only the MTProto search backend searches full channel history. The web fallback performs best-effort filtering over recent history, so an empty result does not establish that a topic was never mentioned.

**Why might an announcement have no returned comments?**

Comments come from the channel's linked discussion group. TikHub returns an empty list when comments are disabled or no discussion group is linked, and reports a backend requirement when MTProto is inactive.

**How does Telegram choose similar channels?**

Telegram automatically selects public channels using similarities between their subscriber bases. The recommendations therefore reflect audience overlap rather than a keyword match alone.

