vk-audio-api-docs

audio.search

Returns a list of audio files.

This method can be called with a user token. Access rights required: audio.

Parameters

q Search query string, (e.g. The Beatles)
string
auto_complete 1 — to correct for mistakes in the search query (e.g., if you enter Beetles, the system will search for Beatles)
flag, either 1 or 0
lyrics 1 — to return only audio files that have associated lyrics
flag, either 1 or 0
performer_only 1 — to search only by artist name
flag, either 1 or 0
sort Sort order:
  • 1 — by duration
  • 2 — by popularity
  • 0 — by date added
int (number)
search_own
flag, either 1 or 0
offset Offset needed to return a specific subset of audio files
positive number
count Number of audio files to return.
positive number, default 30, maximum value 300

Result

Returns the total results number in count field and an array of objects describing audio in items field.

NOTE: Links to .mp3 files are bound to an IP address.

Errors

Global errors can occur while running. See their descriptions on this page.