Editions

Questi contenuti non sono ancora disponibili nella tua lingua.

Ultimo Aggiornamento 24 giugno 2025

Reference

What is an Edition?

An Edition in Hardcover represents a specific published version of a book. While a book is the conceptual work (e.g., “Pride and Prejudice”), an edition is a particular physical or digital manifestation with specific attributes like ISBN, publisher, format, and release date. Multiple editions of the same book may exist with different publishers, languages, formats, or cover art.

Fields

Field	Type	Description
id	int	Unique identifier for the edition
title	string	Title of this edition
subtitle	string	Subtitle of this edition
isbn_10	string	10-digit ISBN
isbn_13	string	13-digit ISBN
asin	string	Amazon Standard Identification Number
pages	int	Number of pages
audio_seconds	int	Duration in seconds (for audiobooks)
release_date	date	Full release date
release_year	int	Year of release
physical_format	string	Physical format (hardcover, paperback, etc.)
edition_format	string	Edition format information
edition_information	string	Additional edition details
description	string	Description of this edition
book_id	int	ID of the parent book
publisher_id	int	ID of the publisher
language_id	int	ID of the language
country_id	int	ID of the country of publication
reading_format_id	int	ID of the reading format
image_id	int	ID of the cover image
rating	numeric	Average rating for this edition
users_count	int	Number of users who have this edition
users_read_count	int	Number of users who have read this edition
lists_count	int	Number of lists containing this edition
locked	bool	Whether the edition is locked from editing
state	string	Current state of the edition record
created_at	timestamp	When the edition was created
updated_at	timestamp	When the edition was last updated
book	Book	Parent book object
publisher	Publisher	Publisher object
language	Language	Language object
country	Country	Country object
reading_format	ReadingFormat	Reading format object
image	Image	Cover image object
contributions	Contribution[]	Array of contributor relationships

Books - Parent book for editions
Publishers - Publishers of editions
Languages - Edition languages
Authors - Authors via contributions

Example Queries

Get Edition Details

Retrieve detailed information about a specific edition by ISBN.

Query
Provalo tu stesso

query GetEditionByISBN {
  editions(where: {isbn_13: {_eq: "9780547928227"}}) {
      id
      title
      subtitle
      isbn_13
      isbn_10
      asin
      pages
      release_date
      physical_format
      publisher {
          name
      }
      book {
          id
          title
          rating
          contributions {
              author {
                  name
              }
          }
      }
      language {
          language
      }
      reading_format {
          format
      }
  }
}

Get All Editions of a Book

Find all editions of a specific book, showing different formats and publishers.

Query
Provalo tu stesso

query GetBookEditions {
  editions(
      where: {book_id: {_eq: 328491}}
      order_by: {release_date: desc}
  ) {
      id
      title
      isbn_13
      pages
      release_date
      physical_format
      publisher {
          name
      }
      language {
          language
      }
      reading_format {
          format
      }
      users_count
      rating
  }
}

Find Editions by Publisher

Get recent editions from a specific publisher.

Query
Provalo tu stesso

query GetPublisherEditions {
  editions(
      where: {publisher_id: {_eq: 1}}
      order_by: {release_date: desc}
      limit: 10
  ) {
      id
      title
      isbn_13
      release_date
      physical_format
      book {
          title
          rating
          contributions {
              author {
                  name
              }
          }
      }
  }
}

Search Editions by Format

Find audiobook editions with specific criteria.

Query
Provalo tu stesso

query GetAudiobookEditions {
  editions(
      where: {reading_format_id: {_eq: 2}, audio_seconds: {_gt: 0}}
      order_by: {users_count: desc}
      limit: 10
  ) {
      id
      title
      asin
      audio_seconds
      publisher {
          name
      }
      cached_contributors
      book {
          title
          rating
      }
  }
}