Publishers

Last Updated   June 7, 2025

Reference

What is a Publisher?

A Publisher in Hardcover represents a company or organization that publishes books. Publishers are linked to specific editions of books, as the same book may be published by different publishers in different regions or formats. Publishers help users find books from their favorite publishing houses and understand the publishing history of editions.

Fields

Field	Type	Description
id	bigint	Unique identifier for the publisher
name	string	The name of the publisher
slug	string	URL-friendly identifier for the publisher
canonical_id	int	Canonical ID for merged publishers
parent_id	int	ID of the parent publisher (for imprints)
editions_count	int	Number of editions published by this publisher
locked	bool	Whether the publisher is locked from editing
state	string	Current state of the publisher record
user_id	int	ID of the user who created the publisher
created_at	timestamp	When the publisher was created
updated_at	timestamp	When the publisher was last updated
editions	Edition[]	Array of editions published by this publisher
parent_publisher	Publisher	Parent publisher object (for imprints)

Related Schemas

• Editions - Editions published by publishers
• Books - Books have multiple editions from different publishers
• Authors - Authors work with various publishers

Example Queries

Get Publisher Details

Retrieve detailed information about a specific publisher including recent editions. This example uses Penguin Random House (ID: 1).

Query

Publisher Details Query

query GetPublisherDetails {
  publishers(where: {id: {_eq: 1}}) {
      id
      name
      slug
      editions_count
      parent_publisher {
          name
      }
      editions(
          limit: 5
          order_by: {release_date: desc}
      ) {
          id
          title
          isbn_13
          release_date
          book {
              title
              contributions {
                  author {
                      name
                  }
              }
          }
      }
  }
}

Try it yourself

Find Publishers by Name

Search for publishers by name pattern. This example searches for publishers with “Penguin” in the name.

Query

Publisher Search Query

query FindPublishers {
  publishers(
      where: {name: {_eq: "Penguin Random House"}}
      order_by: {editions_count: desc}
      limit: 10
  ) {
      id
      name
      editions_count
      parent_publisher {
          name
      }
  }
}

Try it yourself

Get Books by Publisher

Find all books published by a specific publisher, showing different editions.

Note

This query shows unique books (not editions) published by the publisher, grouped by the parent book.

Query

Publisher Books Query

query GetPublisherBooks {
  publishers(where: {id: {_eq: 1}}) {
      name
      editions(
          order_by: {book: {title: asc}}
          limit: 5
      ) {
          id
          isbn_13
          physical_format
          pages
          release_date
          book {
              id
              title
              rating
              contributions {
                  author {
                      name
                  }
              }
          }
      }
  }
}

Try it yourself

Get Popular Publishers

Retrieve the most active publishers by edition count.

Query

Popular Publishers Query

query GetPopularPublishers {
  publishers(
      where: {editions_count: {_gt: 100}}
      order_by: {editions_count: desc}
      limit: 5
  ) {
      id
      name
      slug
      editions_count
      editions(
          limit: 3
          order_by: {book: {rating: desc}}
      ) {
          book {
              title
              rating
          }
      }
  }
}

Try it yourself