JustJuice55/tgden-api

# Telegram Search API — 免费、公开、无需密钥 一个免费的 HTTP API，用于**搜索 Telegram** —— 包含频道、群聊和机器人，覆盖 包含 **875,000+** 个实体的公开目录。无需注册，无需 API 密钥，无需 OAuth。仅需一个 `GET` 请求。 由 [**tgden.com**](https://tgden.com) 提供支持 —— 这是一个针对 开放 Telegram 网络 (`t.me/s/…`) 的搜索引擎和目录。我们仅索引公开链接；不在此处托管任何内容。 ## 为什么会有这个项目 Telegram 没有官方的公开搜索功能。按主题查找频道、活跃的讨论组或机器人，往往意味着需要猜测用户名或依赖封闭的目录。tgden 索引了公开的 Telegram 网络，并将其作为一个整洁的 JSON API 公开，供任何人 —— 开发者、LLM 智能体、研究人员 —— 免费查询。本仓库是开发者的门户：端点、示例和限制，全部集中在一处。 ## 端点 Base URL: `https://tgden.com` ### `GET /api/catalog` — 搜索目录 | 参数 | 类型 | 默认值 | 备注 | |---------|--------|---------|---------------------------------------------------| | `q` | string | — | 自由文本查询（标题、用户名、主题） | | `limit` | int | `20` | 返回的最大结果数 | | `type` | string | all | `channel` · `chat` · `bot`（省略则查询全部） | ``` curl "https://tgden.com/api/catalog?q=crypto&type=channel&limit=3" ``` ``` { "items": [ { "id": "6ec0407a-4f5e-4a86-9154-f42481bc9413", "telegram_id": 2075341442, "username": "hamster_kombat", "title": "Hamster Kombat Announcement", "is_private": false, "avatar_url": "https://cdn4.telesco.pe/file/…" } ] } ``` ### `GET /api/suggest` — 即时自动补全 输入时即可提供分组、排序的建议。非常适合搜索框和智能体工具调用。 ``` curl "https://tgden.com/api/suggest?q=btc" ``` ``` { "groups": [ { "key": "chats", "label": { "en": "live chats", "ru": "живые чаты" }, "items": [ { "label": "BTC Times Discussion", "sub": "221 members", "href": "/en/chat/thebtctimes", "kind": "chat", "username": "thebtctimes" } ] } ] } ``` ## 限制（公开透明） - **无需 API 密钥，目前也没有严格的单密钥配额。** 请合理使用 —— 这是一个共享的免费服务。 - 共享的 IP 速率限制用于保护源站（每个 IP 约 200 次请求 / 10 秒）。经过验证的搜索引擎 和 AI 爬虫不受此限制。 - 需要更高、有保障的吞吐量或批量导出？请提交 issue 或通过 [@tgden_bot](https://t.me/tgden_bot) 联系我们 —— 我们非常乐意与真实项目合作。 我们将这些限制视为一项契约：当它们发生改变时，我们会在此处及 [文档](https://tgden.com/en/api-docs)中发布公告。绝不进行静默限流。 ## 快速开始 - [`examples/search.sh`](examples/search.sh) — curl 单行命令 - [`examples/search.py`](examples/search.py) — Python（仅使用标准库） - [`examples/search.js`](examples/search.js) — Node.js (fetch) ## 用例 - **LLM / 智能体工具调用** —— 通过一次 HTTP 调用，为你的智能体提供一个 `telegram_search(query)` 工具。 - **发现机器人** —— 根据主题推荐频道/群聊。 - **研究** —— 映射社区，追踪垂直领域，研究开放的 Telegram 拓扑图。 ## 许可证 [MIT](LICENSE) — 随意使用，不提供任何担保。数据为公开的 Telegram 元数据。 _{由 [tgden.com](https://tgden.com) 维护。不隶属于 Telegram FZ-LLC。 仅索引公开的 `t.me` 链接。}

标签：API, Homebrew安装, MITM代理, Python脚本, Telegram, 公开数据, 搜索API, 搜索引擎, 数据检索, 逆向工具