Fetch a list of podcast genres

GET {{baseUrl}}/genres?top_level_only=0

Get a list of podcast genres that are supported in Listen Notes. The genre id can be passed to other endpoints as a parameter to get podcasts in a specific genre, e.g., GET /best_podcasts, GET /search... You may want to cache the list of genres on the client side.

Request Params

KeyDatatypeRequiredDescription
top_level_onlynumberJust show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres.

HEADERS

KeyDatatypeRequiredDescription
X-ListenAPI-Keystring(Required) Get API Key on listennotes.com/api
Acceptstring

RESPONSES

status: OK

{"genres":[{"id":"\u003cinteger\u003e","name":"\u003cstring\u003e","parent_id":"\u003cinteger\u003e"},{"id":"\u003cinteger\u003e","name":"\u003cstring\u003e","parent_id":"\u003cinteger\u003e"}]}