# Получение списка упоминаний
Описание
Метод позволяет получить список упоминаний канала в других каналах.
Метод доступен в "API Stat" (на всех тарифах)
Метод поддерживает работу как с каналами, так и с чатами
Упоминанием считается публикация, в которой встречается ссылка на канал вида @username, t.me/username, t.me/username/1234.
# Запрос
# URL запроса
GET
https://api.tgstat.ru/channels/mentions
# Параметры
| Параметр | Описание | Значение по умолчанию | Обязательно |
|---|---|---|---|
| token | Ваш токен | Не задан | Да |
| channelId | Идентификатор канала/чата (@username, t.me/username, t.me/joinchat/AAAAABbbbbcccc... или ID канала в TGStat) | Не задан | Да |
| startDate | Дата упоминания с (timestamp) | Не задан | Нет |
| endDate | Дата упоминания по (timestamp) | Не задан | Нет |
| limit | Количество упоминаний, которое необходимо вернуть | 20 (макс. 50) | Нет |
| offset | Смещение, необходимое для выборки определённого подмножества результатов | 0 | Нет |
| extended | 1 - В ответе будет возвращен массив объектов Channel с информацией о каналах, которые упоминали данный канал | 0 | Нет |
# Ответ
# Структура
{
"status": "ok",
"response": {
"items": [ # Массив упоминаний
{
"mentionId", # Внутренний идентификатор упоминания в TGStat
"mentionType", # Тип упоминания ('channel' | 'post')
"postId", # Внутренний идентификатор публикации в TGStat (в которой было найдено упоминание)
"postLink", # Ссылка на публикацию, в которой найдено упоминание
"postDate", # Дата публикации (timestamp)
"channelId" # Внутренний идентификатор упоминающего канала в TGStat
},
...
],
"channels": [ # Массив объектов Channel - каналов, которые упоминают данный канал
... # (доступен при передаче параметра extended = 1)
]
}
}
# Пример ответа
{
"status": "ok",
"response": {
"items": [
{
"mentionId": 48258272,
"mentionType": "channel",
"postId": 4375814870,
"postLink": "https://t.me/Heath_Ledger_media/51932",
"postDate": 1543487975,
"channelId": 197080
},
{
"mentionId": 48254456,
"mentionType": "channel",
"postId": 4375344988,
"postLink": "https://t.me/zradaperemoga/2865",
"postDate": 1543487209,
"channelId": 79853
}
],
"channels": [
{
"id": 79853,
"link": "t.me/zradaperemoga",
"username": "@zradaperemoga",
"title": "Зрада чи Перемога",
"about": "Реальные новости из украинского зазеркалья. Телеграмируем из матери городов русских (Киев - не без ватников).\nДля связи: zperemoga78@mail.ru",
"image100": "//static2.tgstat.com/public/images/channels/_100/ac/ac2c1fd09bc875e9e64d78c947c38128.jpg",
"image640": "//static2.tgstat.com/public/images/channels/_0/ac/ac2c1fd09bc875e9e64d78c947c38128.jpg",
"participants_count": 12921
},
{
"id": 197080,
"link": "t.me/Heath_Ledger_media",
"username": "@Heath_Ledger_media",
"title": "Хит Леджер",
"about": "Новости, которые мы заслужили.\nВсе самое свежее про вільну і незалежну тут!\nДля связи - @nika_toy",
"image100": "//static2.tgstat.com/public/images/channels/_100/97/97f0a0d896218504dc12fc312a433fe0.jpg",
"image640": "//static2.tgstat.com/public/images/channels/_0/97/97f0a0d896218504dc12fc312a433fe0.jpg",
"participants_count": 3306
},
]
}
}
В случае упоминания канала, параметр mentionType будет содержать значение 'channel'. Если же упоминается конкретная публикация канала, то параметр будет содержать значение 'post'