Get authenticated user info (id, username, name, books count).

Look up another Hardcover user's public profile by id, username, or name. Returns bio, book/follower counts, and privacy. Set include_library=true to also fetch their recent library entries (subject to their privacy setting).

Get recent reading activity (status changes, ratings, reviews, list updates), newest first. Defaults to the feed of users you follow. Pass user_id or username to fetch a single user's activity instead.

Get library reading statistics: total books, books per status, average rating, and books read in a given year.

Search Hardcover by title, author, or ISBN. Supports multiple entity types: books (default), authors, series, lists, users, publishers, characters, and prompts.

Get detailed info about a specific book by its Hardcover ID or slug.

Get characters associated with a book by its Hardcover ID. Returns character names and descriptions.

Get books from your library. Filter by reading status or finished-date range (start_date + end_date). Sort by rating, title, or updated date. Use sort='rating', order='desc' to get top-rated books. Use start_date + end_date to answer 'what did I read in May last year?'

Get your library entry for a book: status, rating, reads.

List your reviews, newest first. Includes review text, rating, and book info.

List all books you have marked as owned. Returns title, authors, and edition details.

Get your active reading goals with target, metric, progress, and date range.

Get your Hardcover lists. Returns id, name, books count, privacy.

Get a specific Hardcover list with its books by list ID.

Get a book series by id, slug, or name with books in reading order.

Get an author's details and books by Hardcover ID, slug, or name.

Get currently trending books, most popular first. Choose a time window with 'duration'.

List Hardcover 'vibes' — curated, themed book recommendation collections (e.g. 'Hidden Gem Fantasy'). Each vibe includes its books.

Look up a publisher by Hardcover ID, slug, or name. Returns publisher info and a paginated list of editions.

Get edition details by Hardcover ID, ISBN-13, or ASIN.

Set a book's status, rating, review, privacy, and private notes. Preserves unspecified fields.

Create or update a reading goal with target, metric, dates, and optional description/privacy.

Mark an edition as owned or not owned. Use get_edition to find the edition ID first.

Add a reading date or progress entry. Updates active read if one exists. Supports page progress and audiobook time tracking.

Update a reading date or progress entry. Preserves unspecified fields. Supports page progress and audiobook time tracking.

Delete a reading date entry by its ID. This cannot be undone.

Remove a book from your library entirely. This cannot be undone.

Create a new Hardcover list.

Update an existing Hardcover list's name, description, or privacy.

Delete a Hardcover list by ID. This cannot be undone.

Add a book to a Hardcover list.

Remove a book from a list. Use id or list_id + book_id.

Fetch reading journal entries for the authenticated user. Includes notes, quotes, status changes, ratings, reviews, and progress updates. Supports optional filters: book_id, event type, limit, and offset.

Create a reading journal entry (for example a note or quote) for a book.

Delete a reading journal entry by ID.

List community book prompts. Optionally filter to featured prompts only. Returns question, description, answers_count, and books_count.

Submit a book as an answer to a community book prompt.

Follow a Hardcover user by user_id or username.

Unfollow a Hardcover user by user_id or username.