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

Описание

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

Метод доступен в "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) Не задан Нет
country География канала (страна) Не задан Нет
language Язык контента канала Не задан Нет
category Категория канала Не задан Нет
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
            },
            {...},
            ...
        ]
    }
}