Skip to content
Hardcover

Getting Books in Your Library

Last Updated   August 13, 2025

Guide

Introduction

This guide will show you how to get a list of the books in your library using the Hardcover API. Books are considered “in your library” when they have been marked “Want to Read”, “Currently Reading”, etc.

Get a List of Books in a User’s Library

To see a selection of the books in your library, replace ##USER_ID## with your account id, which can be found by completing the “Example Request” section of the Getting Started guide.

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