> **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>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/goodreads.mdx>

---

# Goodreads API. Books and readers as JSON.

Books, reader reviews and their comments, editions, authors, series, quotes and Listopia lists. 11 routes under `/v1/goodreads`, one credit per request.

- 11 routes
- Books + reviews
- 1 credit per request

Social Fetch exposes 11 routes under `/v1/goodreads`. Books, authors, series and lists are named by the number in their Goodreads URL (`2767052` for The Hunger Games, `153394` for Suzanne Collins); the URL slug or the full URL works too. Every response uses the `{ data, meta }` envelope, and every lookup carries `data.lookupStatus`: `found` or `not_found`. HTTP 200 only means the request finished, so branch on `lookupStatus` before storing a row.

`GET /v1/goodreads/books/{bookId}` returns the book as one object: `title`, `fullTitle`, `description`, `cover`, credited `authors` with roles, `series` with positions, `genres`, the edition's `format`, `pages`, `publisher`, `publishedAt`, `language`, `isbn`, `isbn13` and `asin`, the work's `firstPublishedAt`, `originalTitle`, `awards`, `places` and `characters`, and a `rating` summary with the five-star `distribution` and review counts per language.

`GET /v1/goodreads/books/{bookId}/reviews` pages through every reader review of the work, across all editions, with `sort` (`default`, `newest`, `oldest`), `rating`, `language` and `query` filters, up to 100 a page. Each review has an `id` you can pass to `GET /v1/goodreads/reviews/comments` for its comment thread. Editions page 20 at a time with a cursor; author books, quotes, series and lists page by number.

## What you can get

- Books with authors and roles, series and positions, genres, edition details, ISBNs, awards, settings, characters and a five-star rating distribution.
- Every reader review of a book across its editions, newest or oldest first, filtered by star rating, language or text, up to 100 a page.
- The comments under any review, 10 a page, and every edition of a book with format, publisher, language and ISBNs.
- Authors with biography, birth and death, influences, followers, ratings, top books and series, plus each author's full book list.
- Series in reading order, quotes by tag or by author, Listopia lists with ranked books, scores and votes, and the lists for a tag.
- Book search by title, author or ISBN, typed `lookupStatus` on every lookup, and all 11 routes at one credit per request.

## Goodreads endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Book | GET /v1/goodreads/books/{bookId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/books/bookid/get) |
| Book reviews | GET /v1/goodreads/books/{bookId}/reviews | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/books/bookid/reviews/get) |
| Book editions | GET /v1/goodreads/books/{bookId}/editions | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/books/bookid/editions/get) |
| Review comments | GET /v1/goodreads/reviews/comments | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/reviews/comments/get) |
| Book search | GET /v1/goodreads/search | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/search/get) |
| Series | GET /v1/goodreads/series/{seriesId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/series/seriesid/get) |
| Author | GET /v1/goodreads/authors/{authorId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/authors/authorid/get) |
| Author books | GET /v1/goodreads/authors/{authorId}/books | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/authors/authorid/books/get) |
| Quotes | GET /v1/goodreads/quotes | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/quotes/get) |
| Lists by tag | GET /v1/goodreads/lists | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/lists/get) |
| List | GET /v1/goodreads/lists/{listId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/lists/listid/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try each Goodreads route against real books and authors.
2. **Pick the route and id.** Use `GET /v1/goodreads/books/2767052` for a book, `GET /v1/goodreads/books/2767052/reviews?sort=newest` for its latest reviews, or `GET /v1/goodreads/search?query=dune` to find an id. Send `x-api-key` on every request.
3. **Branch, page and bill.** Check `data.lookupStatus` before writing a row. Follow `page.nextCursor` or `page.nextPage` while `page.hasMore` is true. Bill from `meta.creditsCharged` and log `meta.requestId` for support.

## Pricing

Every Goodreads route charges 1 credit per completed request, a not-found answer included. Credits never expire on pay-as-you-go packs. `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Goodreads no longer issues developer keys. Social Fetch returns its public books, reviews, authors and lists under one JSON envelope with shared book and author shapes, typed `lookupStatus` values and absolute links. Covers and photos are linked, never rehosted.

## FAQ

### Is there a Goodreads API for books and reviews?

Yes. Social Fetch has 11 Goodreads routes under /v1/goodreads: book, book reviews, book editions, review comments, book search, author, author books, quotes, series, list and lists by tag. Authenticate with your Social Fetch API key in x-api-key.

### How do I identify a book, author, series or list?

Use the number in the Goodreads URL: 2767052 in goodreads.com/book/show/2767052-the-hunger-games, 153394 for an author, 73758 for a series, 1 for a Listopia list. The slug form (2767052-the-hunger-games) or the full URL is accepted too. Search by title or ISBN when you only have the name.

### Can I get every review of a book, not just the first page?

Yes. GET /v1/goodreads/books/{bookId}/reviews pages through all reader reviews of the work, across every edition, up to 100 a page. Pass page.nextCursor back as cursor while page.hasMore is true. sort, rating, language and query filter the list; a cursor only continues the filters it was issued for.

### How do I read the comments under a review?

Every review has an id. Pass it as reviewId to GET /v1/goodreads/reviews/comments to get its comments, newest or oldest first, 10 a page, with each commenter's name, profile link and avatar. The site serves 100 comments in each order; a longer thread is marked truncated. A review without comments is found with totalCount 0.

### What does a book response include?

On found, book carries id, workId, url, title, fullTitle, originalTitle, description as text and HTML, cover, authors with role, series with position, genres, format, pages, publisher, publishedAt, firstPublishedAt, language, isbn, isbn13, asin, rating with average, count, reviewCount, distribution and reviewsByLanguage, awards, places, characters, quotesCount and questionsCount.

### How does search work?

GET /v1/goodreads/search?query= returns the best matching books for a title, author or ISBN, best first, with id, workId, title, author, cover, pages, average rating and ratings count. It returns the top matches, typically 5 to 10, not a paged catalogue.

### How much does the Goodreads API cost?

Every Goodreads route charges 1 credit per completed request. New accounts start with 100 free credits. Check meta.creditsCharged on each response for the amount actually billed.

### Does HTTP 200 mean the book exists?

No. HTTP 200 means the request finished. Check data.lookupStatus: found means the item was returned, not_found means no item has that id. Persist meta.requestId when you need to debug a miss.

## Related

- [Goodreads Book API](https://www.socialfetch.dev/platforms/goodreads/books-bookid): A book with authors, series, genres, edition details, awards and ratings (`GET /v1/goodreads/books/{bookId}`).
- [Goodreads Reviews API](https://www.socialfetch.dev/platforms/goodreads/books-bookid-reviews): Every reader review of a book, sorted and filtered (`GET /v1/goodreads/books/{bookId}/reviews`).
- [Goodreads Review Comments API](https://www.socialfetch.dev/platforms/goodreads/reviews-comments): The comment thread under a review (`GET /v1/goodreads/reviews/comments`).
- [Goodreads Author API](https://www.socialfetch.dev/platforms/goodreads/authors-authorid): An author's biography, ratings, followers and top books (`GET /v1/goodreads/authors/{authorId}`).
- [Goodreads Listopia API](https://www.socialfetch.dev/platforms/goodreads/lists-listid): A Listopia list with ranked books, scores and votes (`GET /v1/goodreads/lists/{listId}`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language book or author question to the matching Goodreads operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Goodreads tools from Cursor or Claude with the same credit metering as REST.
