Skip to content

book

A book. Books are also products, so they inherit price/brand fields. User-specific state (rating, shelf, dates) and platform metrics are modeled as edge values.

MetadataValue
Pluralbooks
Subtitle fieldauthor
Identityisbn13, isbn
Alsoproduct
FieldType
isbnstring
isbn13string
pagesinteger
genresstring[]
seriesstring
formatstring
languagestring
originalTitlestring
placesstring[]
charactersstring[]
awardsWonstring[]
RelationTarget
writtenByperson
contributorsperson[]
publisherorganization

From product:

FieldType
aislestring
availabilitystring
barcodestring
caloriesnumber
categoriesstring[]
currencystring
departmentstring
imagesjson
novaGroupinteger
nutritionScorestring
originalPricestring
originalPriceAmountnumber
pricestring
priceAmountnumber
quantityinteger
servingSizestring
skustring
soldByWeightboolean
weightstring
weightUnitstring
weightValuenumber
RelationTarget
brandbrand
manufacturerorganization
taggedtag[]

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

  • schema.org/Book — Our isbn maps to isbn; writtenBy = author; publisher matches; pages = numberOfPages; language = inLanguage; format ≈ bookFormat (Hardcover/Paperback/EBook).
  • ONIX for Books 3.0 — Publishing-industry canonical. Our isbn/isbn13/pages/format/language/series/originalTitle align with ONIX Product Identifier, Extent, ProductForm, Language, Collection, and OriginalLanguageTitle composites.
  • Open Library Books API — Practical lookup by ISBN. Our genres/characters/places/awardsWon map to subjects/subject_people/subject_places/subject_times (awards less standardized).
  • goodreadsget_book, list_similar_books, list_series_books, search_books, list_author_books, list_books, list_shelf_books