buzz.bookhive.catalogBook

bookhive.buzz

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A canonical book record in the BookHive catalog",
      "key": "any",
      "record": {
        "properties": {
          "authors": {
            "description": "The authors of the book (tab separated)",
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "cover": {
            "description": "URL to full-size cover image",
            "type": "string"
          },
          "coverBlob": {
            "accept": [
              "image/png",
              "image/jpeg"
            ],
            "description": "Uploaded full-size cover image blob",
            "maxSize": 2000000,
            "type": "blob"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Book description/summary",
            "maxLength": 5000,
            "type": "string"
          },
          "genres": {
            "description": "Genres of the book",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "description": "The book's hive id",
            "type": "string"
          },
          "identifiers": {
            "description": "External identifiers for the book",
            "ref": "buzz.bookhive.defs#bookIdentifiers",
            "type": "ref"
          },
          "rating": {
            "description": "Average rating (0-5000, where 1000 == 1.0)",
            "maximum": 5000,
            "minimum": 0,
            "type": "integer"
          },
          "ratingsCount": {
            "description": "Number of ratings",
            "type": "integer"
          },
          "series": {
            "description": "Series name if the book is part of a series",
            "type": "string"
          },
          "source": {
            "description": "The source service name (e.g. Goodreads)",
            "type": "string"
          },
          "sourceId": {
            "description": "ID of the book in the source service",
            "type": "string"
          },
          "sourceUrl": {
            "description": "URL to the book on the source service",
            "type": "string"
          },
          "thumbnail": {
            "description": "URL to thumbnail image",
            "type": "string"
          },
          "thumbnailBlob": {
            "accept": [
              "image/png",
              "image/jpeg"
            ],
            "description": "Uploaded thumbnail image blob",
            "maxSize": 1000000,
            "type": "blob"
          },
          "title": {
            "description": "The title of the book",
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "updatedAt": {
            "format": "datetime",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "authors",
          "thumbnail",
          "createdAt",
          "updatedAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "buzz.bookhive.catalogBook",
  "lexicon": 1
}

Validate Record

Validate a record against buzz.bookhive.catalogBook

Validation Options
Automatically resolve and include external schemas for full validation
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:enu2j5xjlqsjaylv3du4myh4
CID
bafyreibb5ahxfl2p62u5sbcnng4sill46cu3cuop4uyi2gu567pc4ynjb4
Indexed At
2026-03-25 09:46 UTC
AT-URI
at://did:plc:enu2j5xjlqsjaylv3du4myh4/com.atproto.lexicon.schema/buzz.bookhive.catalogBook

Referenced Schemas (1)

Similar Lexicons

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A book within the hive

  • A book in the user's library

  • A minimal book record for reading attestation. For rich metadata (ratings, reviews, covers), see buzz.bookhive.book.

  • A user's shelf entry for a book. Exactly one record per book per user (deduplicate by ids.olWorkId, then by isbn13, then by fuzzy title+author). Status, dates, rating and notes are all carried inline; aggregators and ot…

  • An author-authoritative record of a published or forthcoming work, signed by the author's own repository.

Lexicon Garden

@