Fetch a list of podcast genres

v1.0.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.

Input

{
  "type": "object",
  "properties": {
    "X-ListenAPI-Key": {
      "type": "string"
    },
    "top_level_only": {
      "type": "integer",
      "enum": [
        0,
        1
      ]
    }
  },
  "required": [
    "X-ListenAPI-Key"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "required": [
    "genres"
  ],
  "properties": {
    "genres": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Genre id"
          },
          "name": {
            "type": "string",
            "description": "Genre name."
          },
          "parent_id": {
            "type": "integer",
            "description": "Parent genre id."
          }
        }
      }
    }
  }
}