buzz.bookhive.getExplore Documentation (EN)

main query

Get featured genres and top authors for the explore hub.

Output

Encodingapplication/json

genres array Required

No description available.

topAuthors array Required

No description available.

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)

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "genres",
        "topAuthors"
      ],
      "properties": {
        "genres": {
          "type": "array",
          "items": {
            "ref": "buzz.bookhive.getExplore#genreItem",
            "type": "ref"
          }
        },
        "topAuthors": {
          "type": "array",
          "items": {
            "ref": "buzz.bookhive.getExplore#authorItem",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {}
  },
  "description": "Get featured genres and top authors for the explore hub."
}

authorItem object

No description available.

Properties

author string Required

No description available.

avgRating integer Optional

Average rating * 10 (e.g. 42 = 4.2 stars)

minimum: 0maximum: 50

bookCount integer Required

No description available.

minimum: 0

thumbnail string Optional

No description available.

View raw schema

{
  "type": "object",
  "required": [
    "author",
    "bookCount"
  ],
  "properties": {
    "author": {
      "type": "string"
    },
    "avgRating": {
      "type": "integer",
      "maximum": 50,
      "minimum": 0,
      "description": "Average rating * 10 (e.g. 42 = 4.2 stars)"
    },
    "bookCount": {
      "type": "integer",
      "minimum": 0
    },
    "thumbnail": {
      "type": "string"
    }
  }
}

genreItem object

No description available.

Properties

count integer Required

No description available.

minimum: 0

genre string Required

No description available.

View raw schema

{
  "type": "object",
  "required": [
    "genre",
    "count"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0
    },
    "genre": {
      "type": "string"
    }
  }
}