# Поиск публикаций

Описание

Метод для поиска публикаций по ключевому слову. Возвращает публикации, отсортированные в обратном хронологическом порядке (последние сверху), в которых был найден искомый текст.

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

# Запрос


# URL запроса

GET

https://api.tgstat.ru/posts/search

# Параметры

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

# Ответ


# Структура

{
    "status": "ok",
    "response": {
        "count": 50,            # Кол-во возвращенных записей в массиве items
        "total_count": 27518,   # Общее кол-во найденных по запросу публикаций
        "items": [              # Массив объектов публикаций Post
            ...
        ],
        "channels": [           # Массив объектов каналов Channel, в которых были найдены публикации
            ...                 # доступен при передаче параметра extended = 1
        ]
    }
}

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

{
    "status": "ok",
    "response": {
        "count": 50, 
        "total_count": 27518, 
        "items": [ 
            {
                "id": 3584651917, 
                "date": 1540057519, 
                "views": 3139, 
                "link": "t.me/orfosvinstvo/6325", 
                "channel_id": 14069, 
                "forwarded_from": null,  
                "is_deleted": 0, 
                "text": "Друзья! Я уверен, что вы ведёте свои телеграм-каналы ...",
                "snippet": "Друзья! Я уверен, что вы ведёте свои телеграм-каналы ...", 
                "media": {
                    "media_type": "mediaDocument",
                    "mime_type": "video/mp4",
                    "size": 5085138
                }
            },
            {...},
            ...
        ],
        "channels": [ 
            {
                "id": 14069, 
                "link": "t.me/orfosvinstvo", 
                "username": "@orfosvinstvo", 
                "title": "Орфосвинство и идиомаркетинг", 
                "about": "Исправляем ошибки ...", 
                "image100": "//static.tgstat.ru/...", 
                "image640": "//static.tgstat.ru/...", 
                "participants_count": 9097
            },
            {...},
            ...
        ]
    }
}