Hardcover Documentation

v1 GraphQL API · the same data as the app

Everything you need to build with and curate Hardcover.

The developer API and the librarian handbook for the book-tracking platform readers actually love.

POST /v1/graphql

query CurrentlyReading {
  user_books(
    where: {
      status_id: { _eq: 2 }
      user_id: { _eq: 10714 }
    }
  ) {
    book {
      title
      pages
    }
    user_book_reads(order_by: { id: desc }, limit: 1) {
      progress
      progress_pages
      started_at
    }
  }
}

{
  "data": {
    "user_books": [
      {
        "book": {
          "title": "The Fires of Heaven",
          "pages": 928
        },
        "user_book_reads": [
          {
            "progress": 63.01,
            "progress_pages": null,
            "started_at": "2026-06-02"
          }
        ]
      },
      {
        "book": {
          "title": "All Systems Red",
          "pages": 149
        },
        "user_book_reads": [
          {
            "progress": 3.47,
            "progress_pages": 5,
            "started_at": "2026-06-02"
          }
        ]
      }
    ]
  }
}

Just here to read? Head back to the app.Back to Hardcover app

Find us

For developers

Build with the API

Query books, editions, and reading data over GraphQL, or with an official SDK. Authentication, schema, and recipes.

Getting started Making your first request Authentication & tokens GraphQL schema reference Official SDKs

For librarians

Curate the library

Help keep book data accurate for everyone. Editing standards, roles, and the tools that keep the catalog clean.

Getting started as a librarian Editing standards Merging & de-duping editions Librarian FAQ

Start here

Make your first authenticated GraphQL query in under five minutes.

Search for content

Find books, authors, and editions by title, author, or identifier.

Editing editions

The librarian's guide to clean, canonical book metadata.

Built by the community

Explore the showcase

Hardcover KOReader Plugin

Sync reading progress from KOReader e-readers to Hardcover

E-ink DisplayIntegration

NickelHardcover

Hardcover.app integration for Kobo eReaders

E-ink DisplayIntegration

Obsidian Hardcover Plugin

by aliceinwaterdeep

Sync your Hardcover library to Obsidian as notes with rich metadata

IntegrationDesktop App

Talk to the team on Discord

Where readers, builders, and librarians hang out — and the fastest way to reach the Hardcover team directly.

Join the Discord