API tg-store
Публичный REST API каталога: получайте каналы, боты, категории и результаты поиска в JSON. Только опубликованные и прошедшие модерацию данные. Идеально для ботов, дашбордов и интеграций.
Base URLhttps://tg-store.ru/api/v1ФорматJSON · UTF-8Лимит120/минCORS*
Без ключей и регистрации
К эндпоинтам ↓Свободный доступ, 120 запросов/мин по IP, CORS разрешён — можно дёргать прямо из браузера.
Формат ответа
Успех — объект с полем data (и опционально meta для списков). Ошибка — поле error и соответствующий HTTP-статус (400 / 404 / 429).
{
"data": [ /* … */ ],
"meta": { "count": 50, "limit": 50, "offset": 0, "sort": "top" }
}
Список каналов
GET/entitiesкаталог с фильтрами и сортировкой
Query-параметры
| type | string | опц. | channel · bot · miniapp |
| category | string | опц. | Слаг категории (см. /categories) |
| sort | string | опц. | top (по умолч.), growth, new |
| q | string | опц. | Поиск по названию/username |
| limit | integer | опц. | 1–100, по умолчанию 50 |
| offset | integer | опц. | Смещение для пагинации |
Пример
curl "https://tg-store.ru/api/v1/entities?type=channel&sort=growth&limit=10"
Ответ
{
"data": [
{
"username": "durov",
"title": "Pavel Durov",
"category": null,
"subscribers": 11155246,
"growth_7d": -0.6,
"verified": true,
"url": "https://t.me/durov"
}
],
"meta": { "count": 10, "limit": 10, "offset": 0, "sort": "growth" }
}
Проект по username
GET/entities/{username}карточка + последние посты
curl "https://tg-store.ru/api/v1/entities/durov"
{
"data": {
"username": "durov",
"subscribers": 11155246,
"category": null,
"posts": [
{ "date": "2026-08-18T10:24:00Z",
"text": "Telegram has applied for the .gram domain…" }
]
}
}
Поиск
GET/searchполнотекстовый по названию и @username
| q | string | обяз. | Поисковый запрос, ≥ 2 символов |
| limit | integer | опц. | 1–100, по умолчанию 40 |
curl "https://tg-store.ru/api/v1/search?q=новости&limit=5"
Категории
GET/categoriesсписок разделов с количеством
curl "https://tg-store.ru/api/v1/categories"
{
"data": [
{ "slug": "news", "title": "Новости", "count": 7 },
{ "slug": "dev", "title": "Разработка", "count": 1 }
]
}
Объект проекта
| username | string | опц. | @username в Telegram |
| type | string | опц. | channel · bot · miniapp |
| title | string | опц. | Название |
| description | string | null | опц. | Описание |
| avatar_url | string | null | опц. | Аватар (Telegram-CDN) |
| category | string | null | опц. | Slug категории |
| subscribers | integer | опц. | Подписчиков/пользователей |
| growth_7d | float | null | опц. | Рост за 7 дней, % |
| verified | boolean | опц. | Верифицирован в Telegram |
| url | string | опц. | Ссылка t.me/… |
Лимиты и ошибки
Ответы с ошибкой — JSON с полями error и message. Коды: 400 — неверный запрос, 404 — не найдено, 429 — превышен лимит (смотрите заголовки X-RateLimit-*).
{ "error": "rate_limited", "message": "Превышен лимит запросов" }
Нужен повышенный лимит, вебхуки или партнёрская интеграция? support@tg-store.ru