API для партнёров

Публичный REST API каталога — каналы, боты, категории и поиск в JSON. Только опубликованные и прошедшие модерацию данные. Без ключей, свободный доступ, CORS разрешён. Идеально для виджетов, ботов и интеграций.

Базовый URL: https://tg-store.ru/api/v1Формат: JSONЛимит: 120 запросов/мин на IPCORS: *

Формат ответа

Успех — объект с полем data (и опционально meta). Ошибка — поле error и соответствующий HTTP-статус (400 / 404 / 429).

{
  "data": [ /* … */ ],
  "meta": { "count": 50, "limit": 50, "offset": 0, "sort": "top" }
}

Эндпоинты

GET/entities

Список каналов и ботов с фильтрами и пагинацией.

type	channel \| bot	Фильтр по типу (по умолчанию — все).
category	string	Slug категории (см. /categories).
sort	top \| growth \| new	Сортировка. По умолчанию top (по подписчикам).
q	string	Поиск по названию/username.
limit	1–100	Размер страницы (по умолчанию 50).
offset	int	Смещение для пагинации.

curl "https://tg-store.ru/api/v1/entities?type=channel&sort=growth&limit=10"

GET/entities/{username}

Детали одного проекта + последние посты.

curl "https://tg-store.ru/api/v1/entities/durov"

GET/search

Поиск (опечаткоустойчивый, кириллица↔латиница).

q	string (обяз.)	Поисковый запрос.
limit	1–100	Число результатов (по умолчанию 40).

curl "https://tg-store.ru/api/v1/search?q=новости"

GET/categories

Список категорий с числом проектов.

curl "https://tg-store.ru/api/v1/categories"

Объект проекта

username	string	@username в Telegram.
type	channel \| bot	Тип проекта.
title	string	Название.
description	string \| null	Описание.
avatar_url	string \| null	Аватар (ссылка Telegram-CDN).
category	string \| null	Slug категории.
subscribers	int	Подписчиков/пользователей.
growth_7d	float \| null	Рост за 7 дней, %.
rank	int \| null	Позиция в общем рейтинге.
rank_delta	int \| null	Движение позиции (▲▼).
verified	bool	Верифицирован в Telegram.
scam_suspect	bool	Подозрение на накрутку.
last_post_at	datetime \| null	Последний пост.
telegram_url	string	Ссылка t.me/…
catalog_url	string	Страница в каталоге.

Нужен повышенный лимит, вебхуки или партнёрская интеграция? api@tg-store.ru