# BookHub Publisher API

## Docs

- [BookHub Publisher quickstart](https://galejames.mintlify.app/quickstart/quickstart.md): Get up and running with the BookHub Publisher API v2 in minutes, including how to obtain your JWT and authenticate requests.
- [Overview](https://galejames.mintlify.app/how-to-guides/how-to-guides-overview.md): Explore how to use the BookHub Publisher API.
- [Migrate to BookHub Publisher API v2](https://galejames.mintlify.app/how-to-guides/how-to-guides-migrate-bookhub.md): Update your code to use BookHub Publisher API v2’s new features.
- [Migrate away from title sorting](https://galejames.mintlify.app/how-to-guides/how-to-guides-migrate-away-from-title-sorting.md): Update your code so it no longer uses title sorting in BookHub Publisher API v2.
- [Cache book details for faster performance](https://galejames.mintlify.app/how-to-guides/how-to-guides-cache-book-details.md): Use ETag and Cache-Control headers to cache book details and reduce unnecessary API calls.
- [Handle pagination](https://galejames.mintlify.app/how-to-guides/how-to-guides-handle-pagination.md): Retrieve paginated results from the BookHub Publisher API using `page` and `limit` parameters.
- [Monitor rate limits](https://galejames.mintlify.app/how-to-guides/how-to-guides-monitor-rate-limits.md): Track your API usage to avoid exceeding rate limits.
- [Add the Idempotency-Key header](https://galejames.mintlify.app/how-to-guides/how-to-guides-add-the-idempotency-key-header.md): Add the `Idempotency-Key` header to prevent duplicates when creating books.
- [Rank books by hitCount to find top performers](https://galejames.mintlify.app/how-to-guides/how-to-guides-use-hitcount-to-track-book-performance.md): Use the `hitCount` field to rank books by buyer interest and flag your top performers.
- [Overview](https://galejames.mintlify.app/conceptual-guides/conceptual-guides-overview.md): These explanatory and conceptual guides will help you understand how the BookHub Publisher API works.
- [Using the hitCount field for analytics](https://galejames.mintlify.app/conceptual-guides/conceptual-guides-hitcount-analytics.md): Learn how `hitCount` tracks customer interest in specific titles.
- [Pagination](https://galejames.mintlify.app/conceptual-guides/conceptual-guides-pagination.md): Understand how pagination works in the BookHub Publisher API.
- [Overview](https://galejames.mintlify.app/reference/reference-overview.md): Get reference information for the BookHub Publisher API.
- [Release notes](https://galejames.mintlify.app/reference/reference-release-notes.md): Explore all changes in BookHub Publisher API v2.
- [Document information](https://galejames.mintlify.app/reference/reference-document-information.md): View version, last updated, changelog, and other key information about the BookHub Publisher API documentation.
- [Breaking changes](https://galejames.mintlify.app/reference/reference-breaking-changes.md): Highlights important information about breaking changes in the BookHub Publisher API.
- [Authentication](https://galejames.mintlify.app/reference/reference-authentication.md): Learn how BookHub Publisher API uses JWT authentication, including header format and token requirements.
- [Rate limit headers](https://galejames.mintlify.app/reference/reference-rate-limit-headers.md): Understand how rate limit headers in API responses help you monitor and manage your BookHub API usage.
- [API endpoints](https://galejames.mintlify.app/reference/reference-api-endpoints.md): Provides additional information about the BookHub Publisher API v2 endpoints, including business rules.
- [Data models](https://galejames.mintlify.app/reference/reference-data-models.md): Explore schema definitions for BaseBook, BookWithAnalytics, Pagination, and Error response objects in the BookHub Publisher API.
- [Code examples](https://galejames.mintlify.app/reference/reference-code-examples.md): Copy code samples for book creation, sorting by creation date, handling removed title sorting, and tracking performance with `hitCount`.
- [API reference overview](https://galejames.mintlify.app/api-reference/api-reference-overview.md): Get an overview of the BookHub Publisher API, including versioning, authentication, available endpoints, and error handling.
- [Create a new book](https://galejames.mintlify.app/api-reference/endpoint/createBook.md): Creates a new book with `PENDING` status. The book will not be visible to customers until it is finalized using the finalize endpoint.
- [Get all books](https://galejames.mintlify.app/api-reference/endpoint/getAllBooks.md): Retrieves a paginated list of books for the authenticated publisher. If `page` exceeds `totalPages`, the API returns `200 OK` with an empty `books` array.
- [Get a specific book](https://galejames.mintlify.app/api-reference/endpoint/getBook.md): Retrieves detailed information about a specific book.
- [Delete a book](https://galejames.mintlify.app/api-reference/endpoint/deleteBook.md): Permanently deletes a book from the BookHub marketplace.
- [Deactivate a book](https://galejames.mintlify.app/api-reference/endpoint/deactivateBook.md): Changes a book's status from `ACTIVE` to `INACTIVE`, removing it from customer visibility without deleting it. Deactivation is a required precondition for deleting a book.
- [Finalize a book](https://galejames.mintlify.app/api-reference/endpoint/finalizeBook.md): Changes a book's status to `ACTIVE`, making it visible to customers. Accepts books in `PENDING` status (initial publication) or `INACTIVE` status (reactivating a previously deactivated book). If the book is already `ACTIVE`, this is a no-op and returns the current state.

## OpenAPI Specs

- [api-reference-bookhub-publisher-v2](https://galejames.mintlify.app/api-reference/api-reference-bookhub-publisher-v2.yaml)
- [openapi](https://galejames.mintlify.app/api-reference/openapi.json)

## Optional

- [Portfolio](https://github.com/GaleJames-creator/gale-james)
- [GitHub](https://github.com/GaleJames-creator)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.