# Упоминания ключевого слова в разрезе каналов

Описание

Метод для получения данных об упоминаниях ключевого слова / фразы с группировкой по каналам. Подойдет для отслеживания каналов, которые чаще пишут на заданную тему, упоминают бренд или персону в Telegram-публикациях. Возвращает информацию о канале, количество упоминаний, охват и дату последнего упоминания ключевого слова в канале.

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

# Запрос


# URL запроса

GET

https://api.tgstat.ru/words/mentions-by-channels

# Параметры

Параметр Описание Значение по умолчанию Обязательно
token Ваш токен Не задан Да
q Ключевое слово Не задан Да
peerType Тип источника (channel,chat,all) all Нет
startDate Период упоминания с (timestamp) Не задан Нет
endDate Период упоминания по (timestamp) Не задан Нет
hideForwards Исключить упоминания в публикациях, являющихся репостами 0 Нет
strongSearch Включить строгий поиск (отключает морфологию и поиск по части слова) 0 Нет
minusWords Список минус слов (разделитель - пробел) Не задан Нет
extendedSyntax Используется ли в запросе расширенный синтаксис запроса 0 Нет

# Ответ


# Структура

{ 
    "status": "ok",
    "response": {
        "items": [          # Массив данных об упоминаниях в каналах
            ...
        ],
        "channels": [       # Массив объектов каналов Channel
            ...                 
        ]
    }
}

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

{
    "status": "ok",
    "response": {
        "items": [
            {
                "channel_id": 74647,
                "mentions_count": 4544,
                "views_count": 78710,
                "last_mention_date": 1572539401
            },
            {
                "channel_id": 55422,
                "mentions_count": 1,
                "views_count": 900,
                "last_mention_date": 1572204557
            },
            {
                "channel_id": 63694,
                "mentions_count": 1,
                "views_count": 1053,
                "last_mention_date": 1570826223
            },
            ...
        ],
        "channels": [
            {
                "id": 74647,
                "link": "t.me/newchans",
                "username": "@newchans",
                "title": "Новые каналы",
                "about": "Здесь автоматически публикуются новые каналы, зарегистрированные в Telegram и попавшие в индекс TGStat.",
                "image100": "//static10.tgstat.ru/channels/_100/a8/a82c47f8c5d7d1259ee13ed84a4be346.jpg",
                "image640": "//static10.tgstat.ru/channels/_0/a8/a82c47f8c5d7d1259ee13ed84a4be346.jpg",
                "participants_count": 259
            },
            {
                "id": 55422,
                "link": "t.me/raskruti",
                "username": "@raskruti",
                "title": "Раскрути канал",
                "about": "Если вам нехрен делать - пишите сюда @neznayca \nА лучше не пишите, а то я добрый, добрый, а могу и на хер послать",
                "image100": "//static10.tgstat.ru/channels/_100/2e/2e72ed76b7b3b9ce2f15fce64178dfaf.jpg",
                "image640": "//static10.tgstat.ru/channels/_0/2e/2e72ed76b7b3b9ce2f15fce64178dfaf.jpg",
                "participants_count": 6521
            },
            {
                "id": 63694,
                "link": "t.me/pltrk",
                "username": "@pltrk",
                "title": "Политрук 2.0",
                "about": "Подкрепление? Ты и есть подкрепление.\n\nПоддержать: 4432 7300 1577 4617",
                "image100": "//static10.tgstat.ru/channels/_100/0c/0c3f40425314745073e174541ba5e6ad.jpg",
                "image640": "//static10.tgstat.ru/channels/_0/0c/0c3f40425314745073e174541ba5e6ad.jpg",
                "participants_count": 2823
            },
            ...
        ]
    }
}

По умолчанию вернется результат за 10 последних дней. Однако, вы можете указать необходимый период с помощью параметров startDate и endDate, соблюдая при этом ограничения на вашем тарифе.