BookMetadataResponse

Response containing book metadata

authors object[]

Structured author information as JSON array

Array [

namestringrequired

Author's name

Example: Andy Weir

roleBookAuthorRole (string)required

Role of this author

Possible values: [author, co_author, editor, translator, illustrator, contributor, writer, penciller, inker, colorist, letterer, cover_artist]

sortNamestring | nullnullable

Sort name for ordering (e.g., "Weir, Andy")

Example: Weir, Andy

]

awards object[]

Awards information

Array [

categorystring | nullnullable

Award category

Example: Best Novel

namestringrequired

Name of the award

Example: Hugo Award

wonbooleanrequired

Whether the book won (true) or was just nominated (false)

Example: true

yearinteger,null<int32>nullable

Year the award was given/nominated

Example: 2015

]

blackAndWhiteboolean | nullnullable

Whether the book is black and white

Example: false

bookIdstring<uuid>required

Book ID

Example: 550e8400-e29b-41d4-a716-446655440001

bookType object

oneOf

• null
• BookTypeDto

null

coloriststring | nullnullable

Colorist(s)

Example: Richmond Lewis

countinteger,null<int32>nullable

Total count in series

Example: 4

coverArtiststring | nullnullable

Cover artist(s)

Example: David Mazzucchelli

customMetadataobject | nullnullable

Custom metadata JSON escape hatch

dayinteger,null<int32>nullable

Publication day (1-31)

Example: 1

editionstring | nullnullable

Edition information (e.g., "First Edition", "Revised Edition")

Example: First Edition

editorstring | nullnullable

Editor(s)

Example: Dennis O'Neil

formatDetailstring | nullnullable

Format details

Example: Trade Paperback

genrestring | nullnullable

Genre

Example: Superhero

imprintstring | nullnullable

Imprint name

Example: DC Black Label

inkerstring | nullnullable

Inker(s)

Example: David Mazzucchelli

isbnsstring | nullnullable

ISBN(s)

Example: 978-1401207526

languageIsostring | nullnullable

ISO language code

Example: en

lettererstring | nullnullable

Letterer(s)

Example: Todd Klein

locks objectrequired

Metadata lock states

authorsJsonLockbooleanrequired

Whether authors_json is locked

Example: false

awardsJsonLockbooleanrequired

Whether awards_json is locked

Example: false

blackAndWhiteLockbooleanrequired

Whether black_and_white is locked

Example: false

bookTypeLockbooleanrequired

Whether book_type is locked

Example: false

coloristLockbooleanrequired

Whether colorist is locked

Example: false

countLockbooleanrequired

Whether count is locked

Example: false

coverArtistLockbooleanrequired

Whether cover artist is locked

Example: false

coverLockbooleanrequired

Whether cover is locked (prevents auto-updates)

Example: false

customMetadataLockbooleanrequired

Whether custom_metadata is locked

Example: false

dayLockbooleanrequired

Whether day is locked

Example: false

editionLockbooleanrequired

Whether edition is locked

Example: false

editorLockbooleanrequired

Whether editor is locked

Example: false

formatDetailLockbooleanrequired

Whether format_detail is locked

Example: false

genreLockbooleanrequired

Whether genre is locked

Example: false

imprintLockbooleanrequired

Whether imprint is locked

Example: false

inkerLockbooleanrequired

Whether inker is locked

Example: false

isbnsLockbooleanrequired

Whether isbns is locked

Example: false

languageIsoLockbooleanrequired

Whether language_iso is locked

Example: false

lettererLockbooleanrequired

Whether letterer is locked

Example: false

mangaLockbooleanrequired

Whether manga is locked

Example: false

monthLockbooleanrequired

Whether month is locked

Example: false

numberLockbooleanrequired

Whether number is locked

Example: false

originalTitleLockbooleanrequired

Whether original_title is locked

Example: false

originalYearLockbooleanrequired

Whether original_year is locked

Example: false

pencillerLockbooleanrequired

Whether penciller is locked

Example: false

publisherLockbooleanrequired

Whether publisher is locked

Example: true

seriesPositionLockbooleanrequired

Whether series_position is locked

Example: false

seriesTotalLockbooleanrequired

Whether series_total is locked

Example: false

subjectsLockbooleanrequired

Whether subjects is locked

Example: false

subtitleLockbooleanrequired

Whether subtitle is locked

Example: false

summaryLockbooleanrequired

Whether summary is locked

Example: false

titleLockbooleanrequired

Whether title is locked

Example: false

titleSortLockbooleanrequired

Whether title_sort is locked

Example: false

translatorLockbooleanrequired

Whether translator is locked

Example: false

volumeLockbooleanrequired

Whether volume is locked

Example: false

writerLockbooleanrequired

Whether writer is locked

Example: false

yearLockbooleanrequired

Whether year is locked

Example: true

mangaboolean | nullnullable

Whether the book is manga format

Example: false

monthinteger,null<int32>nullable

Publication month (1-12)

Example: 2

originalTitlestring | nullnullable

Original title (for translated works)

Example: 火星の人

originalYearinteger,null<int32>nullable

Original publication year (for re-releases or translations)

Example: 2011

pencillerstring | nullnullable

Penciller(s)

Example: David Mazzucchelli

publisherstring | nullnullable

Publisher name

Example: DC Comics

seriesPositionnumber,null<double>nullable

Position in a series (e.g., 1.0, 2.5 for .5 volumes)

Example: 1

seriesTotalinteger,null<int32>nullable

Total number of books in the series

Example: 3

subjectsstring[]nullable

Subject/topic tags

subtitlestring | nullnullable

Book subtitle

Example: A Novel

summarystring | nullnullable

Book summary/description

Example: Bruce Wayne returns to Gotham City.

translatorstring | nullnullable

Translator name

Example: John Smith

updatedAtstring<date-time>required

Last update timestamp

Example: 2024-01-15T10:30:00Z

volumeinteger,null<int32>nullable

Volume number

Example: 1

writerstring | nullnullable

Writer(s)

Example: Frank Miller

yearinteger,null<int32>nullable

Publication year

Example: 1987

BookMetadataResponse

{
  "authors": "Unknown Type: array,null",
  "awards": "Unknown Type: array,null",
  "blackAndWhite": false,
  "bookId": "550e8400-e29b-41d4-a716-446655440001",
  "bookType": "null",
  "colorist": "Richmond Lewis",
  "count": 4,
  "coverArtist": "David Mazzucchelli",
  "customMetadata": "Unknown Type: object,null",
  "day": 1,
  "edition": "First Edition",
  "editor": "Dennis O'Neil",
  "formatDetail": "Trade Paperback",
  "genre": "Superhero",
  "imprint": "DC Black Label",
  "inker": "David Mazzucchelli",
  "isbns": "978-1401207526",
  "languageIso": "en",
  "letterer": "Todd Klein",
  "locks": {
    "authorsJsonLock": false,
    "awardsJsonLock": false,
    "blackAndWhiteLock": false,
    "bookTypeLock": false,
    "coloristLock": false,
    "countLock": false,
    "coverArtistLock": false,
    "coverLock": false,
    "customMetadataLock": false,
    "dayLock": false,
    "editionLock": false,
    "editorLock": false,
    "formatDetailLock": false,
    "genreLock": false,
    "imprintLock": false,
    "inkerLock": false,
    "isbnsLock": false,
    "languageIsoLock": false,
    "lettererLock": false,
    "mangaLock": false,
    "monthLock": false,
    "numberLock": false,
    "originalTitleLock": false,
    "originalYearLock": false,
    "pencillerLock": false,
    "publisherLock": true,
    "seriesPositionLock": false,
    "seriesTotalLock": false,
    "subjectsLock": false,
    "subtitleLock": false,
    "summaryLock": false,
    "titleLock": false,
    "titleSortLock": false,
    "translatorLock": false,
    "volumeLock": false,
    "writerLock": false,
    "yearLock": true
  },
  "manga": false,
  "month": 2,
  "originalTitle": "火星の人",
  "originalYear": 2011,
  "penciller": "David Mazzucchelli",
  "publisher": "DC Comics",
  "seriesPosition": 1,
  "seriesTotal": 3,
  "subjects": "Unknown Type: array,null",
  "subtitle": "A Novel",
  "summary": "Bruce Wayne returns to Gotham City.",
  "translator": "John Smith",
  "updatedAt": "2024-01-15T10:30:00Z",
  "volume": 1,
  "writer": "Frank Miller",
  "year": 1987
}