Books

Last Updated   March 7, 2025

Reference

Fields

Field	Type	Description
compilation	bool
release_year	auto
rating	float
pages	auto
users_count	int32
lists_count	int32
ratings_count	int32
reviews_count	int32
author_names	string[]
cover_color	auto
genres	string[]
moods	string[]
content_warnings	string[]
tags	string[]
series_names	string[]
has_audiobook	bool
has_ebook	bool
contribution_types	string[]
slug	string
title	string
description	auto
subtitle	auto
release_date	auto
audio_seconds	auto
users_read_count	int32
prompts_count	int32
activities_count	int32
release_date_i	auto
featured_series	auto
featured_series_position	auto
alternative_titles	string[]
isbns	string[]
contributions	auto
image	auto

Get a list of books belonging to the current user

Query

Example Query

{
    list_books(
          where: {
              user_books: {
                  user_id: {_eq: ##USER_ID##}
              }
          },
          distinct_on: book_id
          limit: 5
          offset: 0
    ) {
      book {
            title
            pages
            release_date
      }
    }
}

Try it Yourself

Get a list of books by a specific author

Query

Example Query

query BooksByUserCount {
    books(
          where: {
              contributions: {
                  author: {
                      name: {_eq: "Brandon Sanderson"}
                  }
              }
          }
          limit: 10
          order_by: {users_count: desc}
    ) {
          pages
          title
          id
    }
}

Try it Yourself

Getting All Editions of a Book

Query

Example Query

query GetEditionsFromTitle {
  editions(where: {title: {_eq: "Oathbringer"}}) {
      id
      title
      edition_format
      pages
      release_date
      isbn_10
      isbn_13
      publisher {
          name
      }
  }
}

Try it Yourself

Create a new book

Query

Example Query

mutation {
    createBook(input: {
          title: "My First Book",
          pages: 300,
          release_date: "2024-09-07"
          description: "This is my first book."
      }) {
      book {
            title
            pages
            release_date
            description
      }
    }
}