groups

groups.search

Осуществляет поиск сообществ по заданной подстроке.

Для вызова метода можно использовать:

Параметры

q

string

Текст поискового запроса.

Обязательный параметр

type

string

Тип сообщества. Возможные значения: group, page, event.

country_id

positive

Идентификатор страны.

city_id

positive

Идентификатор города. При передаче этого параметра поле country_id игнорируется.

future

checkbox

При передаче значения 1 будут выведены предстоящие события. Учитывается только при передаче в качестве type значения event.

market

checkbox

При передаче значения 1 будут выведены сообщества с включёнными товарами.

sort

integer

  • •
    0 — сортировать по умолчанию (аналогично результатам поиска в полной версии сайта);
  • •
    6 — сортировать по количеству пользователей.
offset

positive

Смещение, необходимое для выборки определённого подмножества результатов поиска. По умолчанию — 0.

count

positive

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

Обратите внимание, даже при использовании параметра offset для получения информации доступны только первые 1000 результатов.

Результат

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

Коды ошибок

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

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

Перейти на страницу версий API
5.54

Если в параметрах вызова метода не была указана дата окончания, возвращаемые объекты, которые описывают сообщество, теперь не содержат поле finish_data. Ранее это поле присутствовало в ответе и содержало по умолчанию, равное start_date + 2 часа.

5.53

В объектах, описывающих сообщества, следующие поля возвращаются только запросами с передачей access_token:

  • •
    can_message
  • •
    ban_info
  • •
    can_post
  • •
    can_upload_doc
  • •
    can_upload_video
  • •
    can_see_all_posts
  • •
    can_create_topic
  • •
    is_favorite
  • •
    is_hidden_from_feed
5.19
  • •

    В объекте, описывающем сообщество, изменился тип полей start_date и finish_date со строкового на числовой.

  • •

    Методы, работающие с новостями, при установленном фильтре friend возвращают поле user_id вместо uid.

  • •

    В методе fave.getLinks изображения возвращаются в полях photo_50 и photo_100 вместо image_src и image_middle.