TGStat API Docs

# Поиск каналов / чатов

Описание

Метод позволяет осуществить поиск каналов/чатов по ключевому слову или получить список каналов/чатов в категории.

Метод доступен в "API Stat" (на тарифах S и выше)

# Запрос

# URL запроса

GET

https://api.tgstat.ru/channels/search

# Параметры

Параметр Описание Значение по умолчанию Обязательно
token Ваш токен Не задан Да
q Ключевое слово для поиска Не задан Нет
search_by_description Искать в описании канала? 0 Нет
peer_type Искать каналы или чаты (channel,chat,all) channel Нет
country География канала (страна) Не задан Да
language Язык контента канала russian Нет
category Категория канала Не задан Нет
limit Максимальное количество каналов в ответе 20 (макс. 100) Нет

Хотя бы один из параметров q или category должен быть передан.

# Ответ

# Структура

{
    "status": "ok",
    "response": {
        "count": 14,            # Кол-во возвращенных записей в массиве items
        "items": [              # Массив объектов найденных каналов Channel
            ...
        ],
    }
}

# Пример ответа

{
    "status": "ok",
    "response": {
        "count": 3,
        "items": [
            {
                "id": 53248,
                "link": "t.me/tg_analytics",
                "peer_type": "channel",
                "username": "@tg_analytics",
                "title": "Telegram Analytics",
                "about": "Канал проекта Telegram Analytics. \nЗдесь будут появляться последние новости проекта https://tgstat.ru \n\nЧат: @tg_analytics_chat - вопросы, предложения, замечания - всё сюда.\nСтраница проекта в ВК: https://vk.com/tg_analytics",
                "image100": "//static10.tgstat.ru/channels/_100/1b/1ba75ef1c643f82ac4a09c7aa43bd3ff.jpg",
                "image640": "//static10.tgstat.ru/channels/_0/1b/1ba75ef1c643f82ac4a09c7aa43bd3ff.jpg",
                "participants_count": 21905
            },
            {
                "id": 123357,
                "link": "t.me/AnalyticsFree",
                "peer_type": "chat",
                "username": "@AnalyticsFree",
                "title": "Бесплатные разборы каналов Telegram",
                "about": "Я делаю разборы Telegram-каналов.\n\nЕсли вы хотите, чтоб я сделал разбор вашего канала напишите мне @LoikoR ссылку на ваш канал с меткой «на разбор».\n\nРазбираю все по пунктам и бесплатно.",
                "image100": "//static10.tgstat.ru/channels/_100/b6/b6a1d5de6e0101f3886464727fc6fb22.jpg",
                "image640": "//static10.tgstat.ru/channels/_0/b6/b6a1d5de6e0101f3886464727fc6fb22.jpg",
                "participants_count": 21
            },
            {
                "id": 798202,
                "link": "t.me/telega_analytics",
                "peer_type": "channel",
                "username": "@telega_analytics",
                "title": "Telegram Analytics",
                "about": "Привет, мы поможем тебе прокачать свой канал, разместим его на всех популярных сайтах рекламы телеграмм бесплатно, слишком много интересных идей которые никто не видит!",
                "image100": "//static10.tgstat.ru/channels/_100/32/322f3e36cdffba89c2168fd1244ca1ff.jpg",
                "image640": "//static10.tgstat.ru/channels/_0/32/322f3e36cdffba89c2168fd1244ca1ff.jpg",
                "participants_count": 3
            }
        ]
    }
}

# Ошибки

# Должен быть передан хотя бы один из параметров q или category

{
    "status": "error",
    "error": "at least one parameters q or category required"
}

# Ключевое слово для поиска слишком короткое. Необходимо передать минимум 3 символа.

{
    "status": "error",
    "error": "param q is too short"
}

← Получение статистики канала →