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

video.search

Возвращает список видеозаписей в соответствии с заданным критерием поиска.

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

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

Параметры

q

string

Строка поискового запроса. Например, The Beatles. Поиск по пустому запросу возможен только при наличии owner_id.

sort

string

Сортировка результатов. Возможные значения:

  • •
    0 — по дате добавления видеозаписи,
  • •
    1 — по длительности,
  • •
    2 — по релевантности,
  • •
    3 — по количеству просмотров.
hd

string

Если не равен нулю, то поиск производится только по видеозаписям высокого качества.

adult

string

Фильтр «Безопасный поиск». Возможные значения:

  • •
    1 — выключен,
  • •
    0 — включен.
live

string

filters

string

Список критериев, по которым требуется отфильтровать видео:

  • •
    mp4 — искать только видео в формате .mp4 (воспроизводимое на iOS),
  • •
    youtube — возвращать только YouTube видео,
  • •
    vimeo — возвращать только Vimeo видео,
  • •
    short — возвращать только короткие видеозаписи,
  • •
    long — возвращать только длинные видеозаписи.
search_own

string

1 — искать по видеозаписям пользователя, 0 — не искать по видеозаписям пользователя. По умолчанию: 0.

offset

string

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

longer

string

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

shorter

string

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

count

string

Количество возвращаемых видеозаписей.

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

extended

string

1 — в ответе будут возвращены дополнительные поля profiles и groups, содержащие информацию о пользователях и сообществах. По умолчанию: 0.

owner_id

string

идентификатор овнера, по которому необходимо отфильтровать видео.

fields

string

Результат

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

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

Если в вашем приложении используется прямая авторизация, возвращается дополнительное поле files, содержащее ссылку на файл с видео (если ролик размещен на сервере ВКонтакте) или ссылку на внешний ресурс (если ролик встроен с какого-либо видеохостинга).

Коды ошибок

106
Unable to process action

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