Skip to main content

Podcast Browse

Podcast Browse

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

API methods using this browse

browse, podcasts

Available browse filters

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

e.g. cond=starts_with,a;catalog,2

FilterValueDescription
alpha_matchstringAlias of like.
catalogcatalog idOnly podcasts in this catalog. 0 is ignored rather than matching catalog zero, so it means every catalog.
catalog_enablednoneOnly podcasts in an enabled catalog. Needs no value.
equalstringThe podcast title is exactly this value. Matching is case insensitive.
exact_matchstringAlias of equal.
idarrayOnly these podcast ids. It takes a list, which cond cannot send, so cond=id,1 builds an empty list and the browse returns nothing.
likestringThe podcast title contains this value.
not_likestringThe podcast title does not contain this value.
not_starts_withstringThe podcast title does not start with this value.
regex_matchregexThe podcast title matches this MySQL regular expression. Setting it clears any regex_not_match filter.
regex_not_matchregexThe podcast title does not match this MySQL regular expression. Setting it clears any regex_match filter.
starts_withstringThe podcast title starts with this value.
unplayed1Only podcasts that have never been played. The value must be 1; anything else, including an empty value, is ignored.
user_catalognoneOnly podcasts in a catalog the current user is allowed to see. Needs no value.
user_flag0 or 1Send 1 for podcasts the current user has favourited, 0 for the ones they have not.
user_rating0 to 5Only podcasts the current user rated this value. Send 0 for podcasts they have not rated at all.

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
catalogThe catalog id it belongs to.
episodesHow many episodes the podcast has.
idThe podcast id, which is the order they were created in.
namePodcast title.
randRandom order, applied per request. Paging through it repeats and skips podcasts, so ask for everything in one call.
ratingYour own rating, then when you set it. Podcasts you have not rated group together.
titleAlias of name.
total_countHow many times the podcast's episodes have been played.
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.
websiteWebsite address.