---
title: "Search Telegram channels and indexed public posts"
method: POST
path: "/api/v1/telegram/search"
tags: ["Telegram"]
---

# Search Telegram channels and indexed public posts

`POST /api/v1/telegram/search`

## Request

- Base URL: `https://glim.sh`
- URL: `https://glim.sh/api/v1/telegram/search`
- Auth: one of:
  - none
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in query parameter `apiKey`

Discover public Telegram channels by name/topic (directory lookup) plus indexed public post/channel pages (semantic web index scoped to t.me). Telegram has no global full-text search - use this for discovery, then /api/v1/telegram/get for a channel's live posts or in-channel history search.

## Request body

- object
  - `query` string, required: Search query
  - `kind` 'all' | 'channels' | 'posts': 'channels': directory lookup of channels by name/topic. 'posts': indexed t.me post pages. 'all': both.

## Response `200`

Search results

- object

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `502`: Upstream Error

---

[API](https://skmtc.dev/glim/apis/glim-sh.md) · [All operations](https://skmtc.dev/glim/apis/glim-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/glim/apis/glim-sh/revisions/0094e5226d73?raw)