# Поиск каналов

Описание

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

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

# Запрос


# URL запроса

GET

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

# Параметры

Параметр Описание Значение по умолчанию Обязательно
token Ваш токен Не задан Да
q Ключевое слово для поиска Не задан Нет
search_by_description Искать в описании канала? 0 Нет
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",
                "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",
                "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",
                "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"
}