Books

Last Updated   August 15, 2025

Reference

Fields

Field	Type	Description
compilation	bool
release_year	int
rating	float
pages	int
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	string
subtitle	string
release_date	date
audio_seconds	auto
users_read_count	int32
prompts_count	int32
activities_count	int32
release_date_i	auto
featured_book_series	book_series
featured_series_id	int
alternative_titles	string[]
isbns	string[]
contributions	contributions[]
image	auto
book_category_id	int
book_characters	Characters
book_mappings	book_mappings[]
book_series	book_series[]
book_status	book_statuses
canonical	Books
canonical_id	int
created_at	timestamp
created_by_user_id	int
default_audio_edition	Editions
default_audio_edition_id	int
default_cover_edition	Editions
default_cover_edition_id	int
default_ebook_edition	Editions
default_ebook_edition_id	int
default_physical_edition	Editions
default_physical_edition_id	int
dto	string[]
dto_combined	string[]
dto_external	string[]
editions	Editions
editions_count	int
header_image_id	int
headline	string
id	int
image	images[]
import_platform_id	int
journals_count	int
links	string[]
list_books	list_books[]
literary_type_id	int
locked	bool
prompt_answers	prompt_answers[]
prompt_summaries	prompt_books_summary[]
ratings_distribution	string[]
recommendations	recommendations[]
state	string
taggable_counts	taggable_counts[]
taggings	taggings[]
updated_at	timestamptz
user_added	bool
user_books	user_books[]

User Book Statuses

Status	Description
1	Want to Read
2	Currently Reading
3	Read
4	Paused
5	Did Not Finished
6	Ignored

Get a List of Books in a User’s Library

Query

User Books

{
    user_books(
          where: {
              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

Books by User Count

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

Editions from Title

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

Create Book

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
      }
    }
}