ДокументацияAPIСообществоСоздать приложение
Войти
messages

messages.search

Возвращает список найденных личных сообщений текущего пользователя по введенной строке поиска.

Этот метод можно вызвать с ключом доступа пользователя, полученным в Standalone-приложении через Implicit Flow.

Требуются права доступа: messages.

Этот метод можно вызвать с ключом доступа сообщества.

Требуются права доступа: messages.

Параметры

q

string

Подстрока, по которой будет производиться поиск.

peer_id

string

Фильтр по идентификатору назначения для поиска по отдельному диалогу.

Для пользователя:

  • •
    id пользователя.

Для групповой беседы:

  • •
    2000000000 + id беседы.

Для сообщества:

  • •
    -id сообщества.
date

string

Дата в формате DDMMYYYY — если параметр задан, в ответе будут только сообщения, отправленные до указанной даты.

preview_length

string

Количество символов, по которому нужно обрезать сообщение. Укажите 0, если Вы не хотите обрезать сообщение. (по умолчанию сообщения не обрезаются).

offset

string

Смещение, необходимое для выборки определенного подмножества сообщений из списка найденных.

count

string

Количество сообщений, которое необходимо получить.

extended

string

1 — возвращать дополнительные поля для пользователей и сообществ. В ответе будет содержаться массив объектов бесед.

fields

string

Список дополнительных полей для пользователей и сообществ.

group_id

string

Идентификатор сообщества (для сообщений сообщества с ключом доступа пользователя).

Результат

После успешного выполнения возвращает объект, содержащий число результатов в поле count и массив объектов, описывающих личные сообщения, в поле items.

Обратите внимание, даже при использовании параметра offset максимальное число доступных результатов — 10000.

Если extended=1, в поле items возвращается массив объектов бесед. Дополнительно возвращаются массивы profiles и groups, содержащие объекты пользователей и сообществ.

Коды ошибок

В ходе выполнения могут произойти общие ошибки.

Связанные методы

messages.get

Возвращает список входящих личных сообщений текущего пользователя или сообщества.

messages.searchDialogs

Возвращает список найденных диалогов текущего пользователя по введенной строке поиска.

Связанные версии

5.86

Метод messages.search при использовании параметра extended = 1 возвращает массив объектов бесед.

Изменения в методе stats.get:

  • •
    Входные параметры date_from и date_to устарели, вместо них используются timestamp_from и timestamp_to — целые числа, представляющее собой время в Unixtime.
  • •
    Появился входной параметр stats_groups, который позволяет фильтровать по отдельным блокам в статистике. Возможные значения: visitors, reach, activity.
  • •
    В ответе поля period_from и period_to являются целыми числами и так же представляют собой время в Unixtime.