buzz.bookhive.getBook

bookhive.buzz

Documentation

Get a book's info. Does not require authentication.

main query

Get a book's info. Does not require authentication.

Parameters

goodreadsId string Optional

The Goodreads identifier for the book

id string Optional

The book's hive ID

isbn string Optional

The book ISBN identifier

isbn13 string Optional

The book ISBN-13 identifier

Output

Encodingapplication/json
activity array Optional

Other users' activity on the book

comments array Required

Comments on the book

cover blob Optional

Cover image of the book

createdAt stringdatetime Optional

An RFC 3339 formatted timestamp.

finishedAt stringdatetime Optional

The date the user finished reading the book

review string Optional

The book's review

reviews array Required

Reviews of the book

stars integer Optional

Number of stars given to the book (1-10) which will be mapped to 1-5 stars

startedAt stringdatetime Optional

The date the user started reading the book

status string Optional

No description available.

Known values: buzz.bookhive.defs#finished, buzz.bookhive.defs#reading, buzz.bookhive.defs#wantToRead, buzz.bookhive.defs#abandoned, buzz.bookhive.defs#owned
Try It

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

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
The Goodreads identifier for the book
The book's hive ID
The book ISBN identifier
The book ISBN-13 identifier
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "book",
        "reviews",
        "comments"
      ],
      "properties": {
        "book": {
          "ref": "buzz.bookhive.hiveBook#record",
          "type": "ref",
          "description": "The hive book's info"
        },
        "cover": {
          "type": "blob",
          "accept": [
            "image/png",
            "image/jpeg"
          ],
          "maxSize": 1000000,
          "description": "Cover image of the book"
        },
        "stars": {
          "type": "integer",
          "maximum": 10,
          "minimum": 1,
          "description": "Number of stars given to the book (1-10) which will be mapped to 1-5 stars"
        },
        "review": {
          "type": "string",
          "description": "The book's review",
          "maxGraphemes": 15000
        },
        "status": {
          "type": "string",
          "knownValues": [
            "buzz.bookhive.defs#finished",
            "buzz.bookhive.defs#reading",
            "buzz.bookhive.defs#wantToRead",
            "buzz.bookhive.defs#abandoned",
            "buzz.bookhive.defs#owned"
          ]
        },
        "reviews": {
          "type": "array",
          "items": {
            "ref": "buzz.bookhive.defs#review",
            "type": "ref"
          },
          "description": "Reviews of the book"
        },
        "activity": {
          "type": "array",
          "items": {
            "ref": "buzz.bookhive.defs#activity",
            "type": "ref"
          },
          "description": "Other users' activity on the book"
        },
        "comments": {
          "type": "array",
          "items": {
            "ref": "buzz.bookhive.defs#comment",
            "type": "ref"
          },
          "description": "Comments on the book"
        },
        "createdAt": {
          "type": "string",
          "format": "datetime"
        },
        "startedAt": {
          "type": "string",
          "format": "datetime",
          "description": "The date the user started reading the book"
        },
        "finishedAt": {
          "type": "string",
          "format": "datetime",
          "description": "The date the user finished reading the book"
        },
        "bookProgress": {
          "ref": "buzz.bookhive.defs#bookProgress",
          "type": "ref",
          "description": "Reading progress for the user"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "id": {
        "type": "string",
        "description": "The book's hive ID"
      },
      "isbn": {
        "type": "string",
        "description": "The book ISBN identifier"
      },
      "isbn13": {
        "type": "string",
        "description": "The book ISBN-13 identifier"
      },
      "goodreadsId": {
        "type": "string",
        "description": "The Goodreads identifier for the book"
      }
    }
  },
  "description": "Get a book's info. Does not require authentication."
}

Lexicon Garden

@