Telegram username → ID
HTTP API: превращает Telegram username в числовой id. Пользователи, боты, каналы, группы.
Получить ключ в ботеapi.idbot.devКак это работает
- Откройте @idbot_api_bot, пополните баланс и выберите тариф. Ключ придёт сразу.
- Передавайте ключ в заголовке
Authorization: Bearer <ключ>. - Запрашивайте
/v1/resolve?username=…, ответ — JSON.
Пример
curl -H "Authorization: Bearer $API_KEY" \
'https://api.idbot.dev/v1/resolve?username=durov'
{
"ok": true,
"id": "1006503122",
"type": "Channel",
"username": "durov",
"title": "Pavel Durov",
"onlineCount": null
}
Для каналов и супергрупп id — без префикса Bot API: в Bot API это -100 + id.
Методы
GET /v1/resolve?username=… | username → id, тип, имя / название. @ можно не писать. |
GET /v1/me | Тариф, дневной лимит, остаток на сегодня, расход за месяц, срок оплаты. |
GET /ping | Проверка, что сервис жив. Без ключа. |
Квота
- Лимит — запросов в сутки, сброс в 00:00 UTC.
- Не списываются: невалидный username, ошибка сервиса (503).
- Списываются: найденные сущности,
NO_USER,PRIVATE_CHANNEL. - При исчерпании —
429 QUOTA_EXCEEDEDс заголовкомRetry-After. - Скорость — до 5 запросов в секунду на ключ, сверх этого
429 RATE_LIMITED.
Тарифы
Mini
30
в сутки
4 USDT · 320 ⭐
за 30 дней
Start
100
в сутки
10 USDT · 800 ⭐
за 30 дней
Mid
500
в сутки
25 USDT · 2000 ⭐
за 30 дней
Scale
1000
в сутки
49 USDT · 3920 ⭐
за 30 дней
Предоплата за 30 дней. Оплата — USDT TRC-20 или Telegram Stars. Автопродление с баланса, переход на тариф выше — сразу, с возвратом неиспользованных дней.
Ошибки
{"ok": false, "error": "…"}
| HTTP | error | |
|---|---|---|
| 401 | UNAUTHORIZED | нет ключа или ключ неверный |
| 403 | KEY_DISABLED | ключ выключен (тариф не оплачен) |
| 400 | INVALID_USERNAME | недопустимый username |
| 429 | QUOTA_EXCEEDED | дневной лимит исчерпан |
| 429 | RATE_LIMITED | больше 5 запросов в секунду |
| 503 | UPSTREAM_UNAVAILABLE | временно недоступно, повторите позже |
| 200 | NO_USER | такого username нет |
| 200 | PRIVATE_CHANNEL | канал есть, но закрытый |