# Динамика упоминания ключевого слова по периодам
Описание
Метод для отслеживания динамики упоминаний и охвата ключевых слов или фраз. Подойдет для мониторинга упоминания бренда или персоны в Telegram-публикациях. Возвращает количество упоминаний и охват ключевого слова за каждый день запрошенного периода.
Метод доступен в "API Search" (на тарифах S и выше)
# Запрос
# URL запроса
https://api.tgstat.ru/words/mentions-by-period
# Параметры
| Параметр | Описание | Значение по умолчанию | Обязательно |
|---|---|---|---|
| token | Ваш токен | Не задан | Да |
| q | Ключевое слово | Не задан | Да |
| peerType | Тип источника (channel,chat,all) | all | Нет |
| startDate | Период упоминания с (timestamp) | Не задан | Нет |
| endDate | Период упоминания по (timestamp) | Не задан | Нет |
| hideForwards | Исключить упоминания в публикациях, являющихся репостами | 0 | Нет |
| strongSearch | Включить строгий поиск (отключает морфологию и поиск по части слова) | 0 | Нет |
| minusWords | Список минус слов (разделитель - пробел) | Не задан | Нет |
| group | Группировка результатов (day, week, month) | day | Нет |
| extendedSyntax | Используется ли в запросе расширенный синтаксис запроса | 0 | Нет |
Если параметр startDate не передан, то в качестве startDate будет установлена дата, полученная вычитанием 10 дней от текущей даты.
# Ответ
# Структура
{
"status": "ok",
"response": {
"items": [ # Массив данных по дням, неделям или месяцам
...
]
}
}
# Пример ответа
{
"status": "ok",
"response": {
"items": [
{
"period": "2018-11-04",
"mentions_count": 11,
"views_count": 6781
},
{
"period": "2018-11-03",
"mentions_count": 27,
"views_count": 13097
},
{
"period": "2018-11-02",
"mentions_count": 38,
"views_count": 19091
},
...
]
}
}
По умолчанию вернется результат за 10 последних дней.
Однако, вы можете указать необходимый период с помощью параметров startDate и endDate, соблюдая при этом ограничения на вашем тарифе.
В зависимости от запрошенного типа группировки group - поле period будет принимать один из форматов:
"Y-m-d" # для group=day
"Y-W" # для group=week
"Y-m" # для group=month
Y - Порядковый номер года, 4 цифры
m - Порядковый номер месяца с ведущим нулём
d - День месяца, 2 цифры с ведущим нулём
W - Порядковый номер недели года в соответствии со стандартом ISO-8601; недели начинаются с понедельника
# Подробнее о форматах даты http://php.net/manual/ru/function.date.php