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

> Goodreads API with 10 endpoints: Book, Book Reviews, Review Comments, Book Editions, Search, Author, Author Books, Quotes, Series, and Lists. Look up books by id, link or ISBN, pull reader reviews filtered by stars and language, and read authors, quotes, series and lists. 100 free credits, no card.

TL;DR: SocialCrawl's Goodreads API exposes 10 endpoints, 1 to 9 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Book | GET | `/v1/goodreads/book` | 1 | Get a Goodreads book |
| Book Reviews | GET | `/v1/goodreads/book/reviews` | 5 to 9 | List the reader reviews of a Goodreads book |
| Review Comments | GET | `/v1/goodreads/review/comments` | 1 | List the comments under a Goodreads review |
| Book Editions | GET | `/v1/goodreads/book/editions` | 1 | List every edition of a Goodreads book |
| Search | GET | `/v1/goodreads/search` | 1 | Search Goodreads books |
| Author | GET | `/v1/goodreads/author` | 1 | Get a Goodreads author |
| Author Books | GET | `/v1/goodreads/author/books` | 1 | List a Goodreads author's books |
| Quotes | GET | `/v1/goodreads/quotes` | 1 | List Goodreads quotes |
| Series | GET | `/v1/goodreads/series` | 1 | Get a Goodreads series in reading order |
| Lists | GET | `/v1/goodreads/lists` | 1 | Read a Goodreads Listopia list, or the lists for a tag |

## Code example

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

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### What does the SocialCrawl Goodreads API cover?

It covers 10 endpoints: Book, Book Reviews, Review Comments, Book Editions, Search, Author, Author Books, Quotes, Series, and Lists. They return book search, full book records, reader reviews and review comments, editions, authors and their books, quotes, series and Listopia lists in the same unified JSON as the other 74 platforms.

### Can I look up a Goodreads book by ISBN?

Yes. GET /v1/goodreads/book accepts an ISBN-10 or ISBN-13 as isbn, as well as a Goodreads book id or link.

### Can I filter Goodreads reviews by rating or language?

Yes. GET /v1/goodreads/book/reviews takes rating for a star count from 1 to 5, language for a code such as en or de, search for words inside reviews, and sort for popular, newest or oldest.

### Do I need a Goodreads account or key?

No. You call SocialCrawl with one SocialCrawl API key, so there is no Goodreads login, application or key to manage.

### How much does the Goodreads API cost?

Single records and search cost 1 credit, and review lists cost 5 credits. A new account gets 100 free credits with no card.

## 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:

- What is the SocialCrawl Goodreads API?
- Is there a Goodreads API for book reviews and ratings?
- How do I get Goodreads data without a Goodreads account?