# Goodreads Book API (https://www.socialcrawl.dev/platforms/goodreads/book)

> Returns one Goodreads book in full: title, authors and their roles, series and position, description, genres, the average rating with the 1 to 5 star breakdown, rating and review counts, how many reviews exist in each language, the edition's format, pages, publisher, ISBN and ASIN, first publication date, awards, places, characters, and how many readers are currently reading it or want to read it.

TL;DR: `GET /v1/goodreads/book` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | The Goodreads book id, for example 5907. Send one of id, url or isbn. |
| `url` | no | A Goodreads book link, for example https://www.goodreads.com/book/show/5907. |
| `isbn` | no | An ISBN-10 or ISBN-13, for example 9780547928227. |
| `include_similar` | no | true to add similar books. Default false. |
| `include_lists` | no | true to add the Listopia lists the book is on. Default false. |
| `include_preview` | no | true to add the free reading-sample link when one exists. Default false. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/goodreads/book" \
  --data-urlencode "id=5907" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Goodreads book with an API?

Call GET /v1/goodreads/book and send one of id, url or isbn. The id is the Goodreads book id such as 5907, the url is a Goodreads book link, and the isbn is an ISBN-10 or ISBN-13.

### What does the Goodreads book endpoint return?

It returns the title, authors and their roles, series and position, description, genres, the average rating with the 1 to 5 star breakdown, rating and review counts, reviews per language, the edition's format, pages, publisher, ISBN and ASIN, first publication date, awards, places, characters, and how many readers are reading it or want to read it.

### Can I add similar books or Listopia lists?

Yes. Set include_similar to true for similar books, include_lists to true for the Listopia lists the book is on, and include_preview to true for the free reading-sample link when one exists. All three default to false.

### How do I find which languages a book has reviews in?

The book record lists how many reviews exist in each language. Use one of those codes as the language filter on GET /v1/goodreads/book/reviews.

### How much does this Goodreads endpoint cost?

Each call costs 1 credit on the standard tier. There is no subscription, and 100 free credits cover 100 calls.

See the full Goodreads API: https://www.socialcrawl.dev/platforms/goodreads

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I look up a book by ISBN with the Goodreads API?
- What data does the SocialCrawl Goodreads book endpoint return?