# Telegram Multi-Channel Keyword Scanner

> Telegram Multi-Channel Keyword Scanner is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11, last successful call 2026-07-10).

Scans a watchlist of public Telegram channels for keyword mentions, returning matching posts with metadata and per-channel hit counts.

## Facts

- Endpoint: GET https://api.cn402.com/tg/scan?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-07-10
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 3
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telegram-multi-channel-keyword-scanner-e746a55e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eXH48KwtEBxWTHOd_752w

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability telegram-multi-channel-keyword-scanner-e746a55e
```

Example prompt: Scan these Telegram channels — @whale_alert, @lookonchain, and @CryptoNewsIO — for any mentions of 'ARB airdrop' in the last 24 hours, and show me the matching posts with their view counts and links.

## When to prefer this

Use this endpoint when you need to monitor multiple public Telegram channels simultaneously for specific keyword mentions, especially for crypto market intelligence, narrative tracking, KOL signals, airdrop alerts, or token listing news. Prefer it over manual channel browsing or single-channel scraping when cross-channel aggregation and hit-count comparison are needed.

## Known failure modes

- Channel is private or restricted — returns error entry in the errors array for that channel
- Invalid or non-existent channel handle — error returned per channel
- Query returns zero matches — empty matches array with matchCount 0
- Network timeout fetching a channel — partial results returned with error logged
- Rate limit exceeded — HTTP 402 or similar payment/quota error

## How this service works

在一批公开 Telegram 频道里按关键词扫描并给出热度信号。传 preset 一键选内置币圈频道库(news 英文快讯/whale 链上鲸鱼/cn 中文媒体/all),或自传频道。返回命中帖子、按频道聚合命中数、signal 热度(high/medium/low/quiet + 最热频道)。用于叙事追踪、舆情情绪、聪明钱信号、空投上新。Scan public Telegram channels for keyword mentions with a heat signal. Use preset for a curated crypto channel list or pass your own. Returns matches, per-channel counts, and a snapshot heat signal. For narrative tracking, sentiment and smart-money signals. Accepts payment on Base or Solana — either network works.

## Output

Returns an array of matching posts across all scanned channels (newest first), each with channel name, post ID, datetime, full text, view count, and direct link. Also includes a per-channel breakdown of hit counts, total match count, the query used, the time window applied, and any channels that couldn't be fetched due to errors.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Keyword(s) to match in post text, case-insensitive. Comma-separated terms are OR-matched (e.g. pepe,airdrop). If omitted, returns a merged newest-first feed of all channels with no filter."
  },
  "channels": {
   "type": "string",
   "description": "Comma-separated list of public Telegram channel usernames to scan, e.g. durov,telegram (required, max 15). Leading @ and full t.me URLs are accepted. JSON arrays are also accepted in a POST body."
  },
  "windowHours": {
   "type": "string",
   "description": "Optional. Only return posts published within the last N hours (1-720)."
  },
  "limitPerChannel": {
   "type": "string",
   "description": "Recent messages to scan per channel, 1-50 (default 20)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telegram-multi-channel-keyword-scanner-e746a55e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cn402.com](https://www.zero.xyz/host/api.cn402.com/llms.txt)