# Упоминания ключевого слова в разрезе каналов
Описание
Метод для получения данных об упоминаниях ключевого слова / фразы с группировкой по каналам. Подойдет для отслеживания каналов, которые чаще пишут на заданную тему, упоминают бренд или персону в Telegram-публикациях. Возвращает информацию о канале, количество упоминаний, охват и дату последнего упоминания ключевого слова в канале.
Метод доступен в "API Search" (на тарифах S и выше)
# Запрос
# URL запроса
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 | Нет |
Если параметр startDate не передан, то в качестве startDate будет установлена дата, полученная вычитанием 10 дней от текущей даты.
# Ответ
# Структура
{
"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,
"tg_id": 1095068013,
"link": "t.me/newchans",
"peer_type": "channel",
"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,
"ci_index": 1301.53,
"tgstat_restrictions": [],
"created_at": 1476909773
},
{
"id": 55422,
"tg_id": 1035068027,
"link": "t.me/raskruti",
"peer_type": "channel",
"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,
"ci_index": 2109.15,
"tgstat_restrictions": [],
"created_at": 1436909736
},
{
"id": 63694,
"tg_id": 1219068092,
"link": "t.me/pltrk",
"peer_type": "channel",
"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,
"ci_index": 504.94,
"tgstat_restrictions": [],
"created_at": 1476909295
},
...
]
}
}
По умолчанию вернется результат за 10 последних дней.
Однако, вы можете указать необходимый период с помощью параметров startDate и endDate, соблюдая при этом ограничения на вашем тарифе.