Protocol Specs

Example command to play all tracked,
searched with string 'earth':
heos://browse/add_to_queue?
pid=<playerid>&sid=2&cid=SEARCHED_T
&aid=1RACKS-earth
: the following response provides examples of the various search criteria types. The actual response will depend on the source and Note
the search types supported by that source.
Response:
{
"heos": {
"command": "browse/ get_search_criteria ",
"result": "success",
"message": "sid='source_id "
},
"payload": [
{
"name": "Artist",
"scid": "'search_criteria_id'",
"wildcard": "yes_or_no",
},
{
"name": "Album",
"scid": "'search_criteria_id'",
"wildcard": "yes_or_no",
},
{
"name": "Track",
"scid": "'search_criteria_id'",
"wildcard": "yes_or_no",
"playable": "yes_or_no",
"cid": "Prefix to search string",
},
{
"name": "Station",
"scid": "'search_criteria_id'",
"wildcard": "yes_or_no",
}
]
}
Example: heos://browse/get_search_criteria?sid=3
Supported Sources: Local Media Servers, TuneIn, Rhapsody, Deezer, SiriusXM, Napster, Tidal, SoundCloud
4.4.6 Search
Command: heos://browse/search?sid=source_id&search=search_string&scid=search_criteria&range=start#, end#
Attribute Description Enumeration
sid Source id returned by 'get_music_sources'
command
N/A
search String for search limited to 128 unicode
characters and may contain '*' for
wildcard if supported by search criteria id
N/A
scid Search criteria id returned by
'get_search_criteria' command
artist, album, song, station
count Total number of items available in the
container.
NOTE: count value of '0' indicates
unknown container size. Controllers
needs to query until the return payload
is empty (returned attribute is 0).
0 - unknown
>1 - valid count