# Получение списка упоминаний

Описание

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

Метод доступен в "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'