# Поиск публикаций
Описание
Метод для поиска публикаций по ключевому слову. Возвращает публикации, отсортированные в обратном хронологическом порядке (последние сверху), в которых был найден искомый текст.
Метод доступен в "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 | Нет |
Если параметр startDate не передан, то в качестве startDate будет установлена дата, полученная вычитанием 10 дней от текущей даты.
# Ответ
# Структура
{
"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,
"shares_count": 12,
"comments_count": 0,
"reactions_count": 42,
"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
},
{...},
...
]
}
}