> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/goodreads/books-bookid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/goodreads/books-bookid.mdx>

---

# Goodreads Book API

One book as typed JSON: authors, series, genres, edition facts and the full rating summary.

`GET /v1/goodreads/books/{bookId}` takes the number from the book URL, for example `2767052` for The Hunger Games (`2767052-the-hunger-games` or the full URL also work). On `data.lookupStatus: found`, `data.book` carries `id`, `workId`, `url`, `title`, `fullTitle`, `originalTitle`, `description` (plain text) and `descriptionHtml`, `cover`, `authors`, `series`, `genres`, `format`, `pages`, `publisher`, `publishedAt`, `firstPublishedAt`, `language`, `isbn`, `isbn13`, `asin`, `rating`, `awards`, `places`, `characters`, `quotesCount` and `questionsCount`.

`authors` lists the main author first with `image`, `followers` and `worksCount`, then translators, illustrators and other credits with their `role`. `rating` covers every edition of the work: `average`, `count`, `reviewCount`, a five-value `distribution` (1 star first) and `reviewsByLanguage`. `workId` is shared by every edition; pass the book id to the editions route to list them.

## Request

- **Endpoint:** `GET /v1/goodreads/books/{bookId}`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by book id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/books/bookid/get)
- **Platform page:** [/platforms/goodreads](https://www.socialfetch.dev/platforms/goodreads)

## FAQ

### Which inputs does the book route take?

Only the book id from the Goodreads URL, for example 2767052. The slug form 2767052-the-hunger-games or the full book URL is accepted and reduced to the number. Anything else is refused before any request is made.

### Are the ratings for this edition or for the book?

For the book across all its editions: rating.average, rating.count and the distribution are the work's totals, as the book page shows them. format, pages, publisher, publishedAt and the ISBNs describe the edition the id names.

### How many credits does a call cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### What does lookupStatus mean here?

found means data.book is the book. not_found means no book has this id, and data.book is null. HTTP 200 only means the request finished.
