[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Telegram channel profile](https://spiral.ai/integrations/codex/telegram-channel-profile)

# How to Use Telegram channel profile in Codex

Fetch one public Telegram channel's description, avatar, subscriber count, verification status, and media counters from its t.me preview. Use it to check a publisher's profile or identify an unavailable web preview.

|  |  |
| --- | --- |
| Model | Telegram channel profile |
| 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 profile in Codex

- Use Telegram channel profile to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Telegram channel profile and tell me what changed since last week.
- Check Telegram channel profile and summarize what you find in three bullet points.
- Pull the newest data from Telegram channel profile and give me the result as a table.
- Check Telegram channel profile every morning and tell me only when something changed.

## How to set up Telegram channel profile in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 profile**: 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-info",
    "input": {
      "channel": "durov"
    }
  }'
```

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

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

## Telegram channel profile tools and prices

- [Telegram Web · Get channel info](https://spiral.ai/tools/tikhub/tikhub/telegram-web-fetch-channel-info) (TikHub): $0.0013 per request.

## What can you do with Telegram channel profile in Codex?

Build a Telegram publisher review into your project using public channel profiles, posts, or recommendations. Keep channel records, individual posts, and discussion comments distinct so the interface preserves their context.

### 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.

### Maintain a public publisher directory

Start with known channels, discover Telegram's recommendations, and compare profile descriptions and subscriber displays. Refresh individual entries when a publisher changes its public presentation.

### 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 Codex guides](https://spiral.ai/integrations/codex)

## Telegram channel profile in other agents

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

## More Codex guides

- [Telegram channel posts](https://spiral.ai/integrations/codex/telegram-channel-posts)
- [Telegram channel profiles in bulk](https://spiral.ai/integrations/codex/telegram-channel-profiles-in-bulk)
- [Telegram channel post search](https://spiral.ai/integrations/codex/telegram-channel-post-search)
- [Telegram post comments](https://spiral.ai/integrations/codex/telegram-post-comments)
- [Telegram Post Details ScrapeCreators](https://spiral.ai/integrations/codex/telegram-post-details-scrapecreators)
- [Telegram post details](https://spiral.ai/integrations/codex/telegram-post-details)

## Questions about Telegram channel profile in Codex

**Can Codex use Telegram channel profile?**

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

**How much does Telegram channel profile cost in Codex?**

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

**Do I need a TikHub account to use Telegram channel profile in Codex?**

No. Spiral runs Telegram channel profile 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 profile in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Telegram channel profile runs?**

Telegram channel profile runs in the background. Codex 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.

