Skip to main content

Genre Browse

Genre Browse

This page lists the filters and sorts the tag browse accepts. Refer to the main Api Browse methods page for how to send them.

NOTE Genres are stored as tags, so the browse type is tag and the tag filters and sorts are aliases of the genre ones.

API methods using this browse

genres

Available browse filters

Send filters in the cond parameter as filter,value pairs, separated by ;

e.g. cond=starts_with,a

FilterValueDescription
alpha_matchstringAlias of like.
equalstringThe genre name is exactly this value. Matching is case insensitive.
exact_matchstringAlias of equal.
genregenre idOnly this genre id.
hidden0 or 1Send 1 for hidden genres, 0 for visible ones.
idarrayOnly these genre ids. It takes a list, which cond cannot send, so cond=id,1 builds an empty list and the browse returns nothing.
likestringThe genre name contains this value.
not_likestringThe genre name does not contain this value.
not_starts_withstringThe genre name does not start with this value.
object_typestringOnly genres applied to this object type: song, album, artist or video. The tag map join is not deduplicated, so a genre comes back once per object carrying it.
regex_matchregexThe genre name matches this MySQL regular expression. Setting it clears any regex_not_match filter.
regex_not_matchregexThe genre name does not match this MySQL regular expression. Setting it clears any regex_match filter.
starts_withstringThe genre name starts with this value.
taggenre idAlias of genre.

Available browse sorts

Send a single sort in the sort parameter as name,order, where order is ASC or DESC.

e.g. sort=name,DESC

SortDescription
albumHow many albums carry this genre.
artistHow many artists carry this genre.
idThe genre id, which is the order they were first seen in.
nameGenre name.
randRandom order, applied per request. Paging through it repeats and skips genres, so ask for everything in one call.
ratingYour own rating, then when you set it. Genres you have not rated group together.
songHow many songs carry this genre.
tagAlias of id.
user_flagWhen you added it to your favourites. This is a date, not a flag, so everything you have not favourited groups together.
user_flag_ratingWhen you added it to your favourites, then your rating.
userflagAlias of user_flag.
videoHow many videos carry this genre.