buzz.bookhive.listGenres Documentation (EN)

main query

List genres with book counts. Does not require authentication.

Parameters

limit integer Optional

Maximum number of genres to return

minBooks integer Optional

Only return genres with at least this many books

offset integer Optional

Offset for pagination

Output

Encodingapplication/json

genres array Required

No description available.

offset integer Optional

Next offset for pagination

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

limit Maximum number of genres to return

minBooks Only return genres with at least this many books

offset Offset for pagination

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "genres"
      ],
      "properties": {
        "genres": {
          "type": "array",
          "items": {
            "ref": "#genreWithCount",
            "type": "ref"
          }
        },
        "offset": {
          "type": "integer",
          "description": "Next offset for pagination"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of genres to return"
      },
      "offset": {
        "type": "integer",
        "description": "Offset for pagination"
      },
      "minBooks": {
        "type": "integer",
        "default": 0,
        "minimum": 0,
        "description": "Only return genres with at least this many books"
      }
    }
  },
  "description": "List genres with book counts. Does not require authentication."
}

genreWithCount object

No description available.

Properties

count integer Required

Number of books in this genre

genre string Required

Genre name

View raw schema

{
  "type": "object",
  "required": [
    "genre",
    "count"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "description": "Number of books in this genre"
    },
    "genre": {
      "type": "string",
      "description": "Genre name"
    }
  }
}