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
Key | Datatype | Required | Description |
---|---|---|---|
top_level_only | number | Just show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres. | |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Accept | string |
RESPONSES
status: OK
{"genres":[{"id":"\u003cinteger\u003e","name":"\u003cstring\u003e","parent_id":"\u003cinteger\u003e"},{"id":"\u003cinteger\u003e","name":"\u003cstring\u003e","parent_id":"\u003cinteger\u003e"}]}