# DeepTrawler Telegram Search

> DeepTrawler Telegram Search is a paid API for AI agents from deeptrawler.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-16).

Search Telegram messages globally or within specific chats by keyword, time range, message type, and chat filter

## Facts

- Endpoint: GET https://deeptrawler.com/v1/telegram/search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deeptrawler-telegram-search-6496132f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6oMmN9hoQeOYWN-E3QRso

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 deeptrawler-telegram-search-6496132f
```

Example prompt: Search Telegram globally for messages mentioning 'Bitcoin ETF approval' from the last 7 days, limit to 20 results, and only include messages with URLs.

## When to prefer this

Use this endpoint when you need to search Telegram message content at scale — either across all public Telegram chats globally or scoped to a specific channel or group. It is the right choice when you need keyword search with time-range filtering, message-type filtering (photos, videos, documents, polls, etc.), and cursor-based pagination. Prefer this over general web search when the target content is specifically on Telegram.

## Known failure modes

- Missing required 'q' or 'query' parameter returns an error
- Invalid time format for 'from' or 'to' parameters
- Invalid cursor token causes pagination failure
- filter[chat] references a private or non-existent chat, returning empty results
- Exceeding limit maximum of 100 returns a validation error
- Payment failure via x402 protocol blocks the request
- Rate limiting if too many requests are made in quick succession

## How this service works

Live, multi-platform search API for the deep conversation layer. Pay per call with x402 or MPP — no API keys, no signup.

## Output

Returns a paginated list of Telegram messages matching the query, each containing the message text, URL, message ID, timestamp, chat details (id, title, username, verified status), view count, forward count, and message type. Also includes a next_cursor token for pagination and query metadata.

## 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": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Telegram search query (alias: query). Required."
      },
      "to": {
       "type": "string",
       "description": "Upper time bound, default now. ISO-8601 or a relative value such as now-7d."
      },
      "from": {
       "type": "string",
       "description": "Lower time bound. ISO-8601 or a relative value such as now-7d."
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 100,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "description": "Alias of 'q'; provide one of the two."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque continuation token from a previous response's next_cursor."
      },
      "filter[chat]": {
       "type": "string",
       "description": "Shorthand for filter[chat][eq]."
      },
      "filter[message_type]": {
       "enum": [
        "any",
        "photo",
        "video",
        "photo_video",
        "document",
        "url",
        "gif",
        "voice",
        "music",
        "round_video",
        "geo",
        "contact",
        "poll",
        "pinned"
       ],
       "type": "string",
       "description": "Shorthand for filter[message_type][eq]."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "order": "telegram"
  },
  "query": "coffee",
  "results": [
   {
    "id": "-1001234567890:842",
    "url": "https://t.me/somechannel/842",
    "chat": {
     "id": "-1001234567890",
     "title": "Some Channel",
     "username": "somechannel",
     "verified": false
    },
    "text": "Coffee prices are changing...",
    "views": 15200,
    "forwards": 48,
    "timestamp": "2026-07-07T10:30:00Z",
    "message_id": 842,
    "message_type": "photo"
   }
  ],
  "platform": "telegram",
  "next_cursor": "eyJ2Ijox..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deeptrawler-telegram-search-6496132f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from deeptrawler.com](https://www.zero.xyz/host/deeptrawler.com/llms.txt)