# Telegram Channel Search

> Telegram Channel Search is a paid API for AI agents from ryumoon-x402-tools.ryumoon.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-19).

Search a public Telegram channel for posts matching keywords, returning up to 200 messages with text, date, views, reactions, links, media, and channel stats.

## Facts

- Endpoint: GET https://ryumoon-x402-tools.ryumoon.workers.dev/telegram/search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telegram-channel-search-fadc95cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6BNb2AkpN_ExhsuAI60fS

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-channel-search-fadc95cf
```

Example prompt: Search the Telegram channel @durov for the most recent 50 posts mentioning 'privacy' or 'encryption' — give me their dates, view counts, and any links included.

## When to prefer this

Use this endpoint when you need to search or retrieve posts from a specific public Telegram channel without authentication, especially for monitoring, research, or news aggregation. It's ideal when you know the channel username and want keyword-filtered results with engagement metrics (views, reactions). Prefer over manual Telegram browsing or scraping when you need structured, LLM-ready data at scale up to 200 posts per query.

## Known failure modes

- Channel is private or doesn't exist — returns error indicating channel not found
- No messages match the keywords — returns empty results set
- Channel username malformed — returns validation error
- Limit parameter out of range (not 1-200) — returns schema validation error
- Telegram API rate limiting or downtime — may return timeout or upstream error

## How this service works

Telegram channel search: find messages in a public Telegram channel by keyword. Returns up to 200 matching posts with date, text, views, reactions, links and media, plus channel title and subscriber count. No login. Charged only on success.

## Output

Returns up to 200 matching posts from the specified public Telegram channel, each including post text, publication date, view count, reactions, any links, and media attachments. Also includes the channel's display title and current subscriber count. Only charged on a successful response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "channel"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 200,
       "minimum": 1,
       "description": "Max messages (default 50)"
      },
      "match": {
       "enum": [
        "any",
        "all"
       ],
       "type": "string"
      },
      "channel": {
       "type": "string",
       "description": "Public channel username or t.me link"
      },
      "keywords": {
       "type": "string",
       "description": "Comma-separated keywords (optional; empty = latest messages)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telegram-channel-search-fadc95cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ryumoon-x402-tools.ryumoon.workers.dev](https://www.zero.xyz/host/ryumoon-x402-tools.ryumoon.workers.dev/llms.txt)
