List Goodreads book reviews
List the reader reviews of a Goodreads book across its editions, with ratings and likes.
Headers
Get your API keyAPI key (`sfk_...`)
Goodreads book id: the number in the page URL, e.g. `2767052`. A slug such as `2767052-the-hunger-games` or the full URL also works.
≥ 1 · ≤ 2147483647
Order: `default` (the site's own ranking), `newest` or `oldest`. Default `default`.
one of: default, newest, oldest
Only reviews with this star rating, 1 to 5. Omit for all.
≥ 1 · ≤ 5
Only reviews in this language, as a two-letter code such as `en` or `es`.
pattern: ^[A-Za-z]{2,3}$
Only reviews that contain this text, up to 100 characters.
min 1 chars · max 100 chars
Rows per page, 1 to 100. Default 30.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page.
min 1 chars · max 512 chars · pattern: ^[A-Za-z0-9_.~=-]+$
Endpoint-specific response payload.
`not_found` when no book has this id.
one of: found, not_found
The book; null when not found.
Book id.
Work id.
Title.
Book page URL.
Reviews matching the filters, across every edition.
Reviews on this page.
Review id. Pass it as `reviewId` to the review comments endpoint.
Review page URL.
Who wrote it; null for a removed account.
Member id.
Display name.
Member profile URL.
Avatar image URL. Link only; the image is not hosted by Social Fetch.
Whether the member is a Goodreads author.
Followers.
Text reviews the member has written.
Star rating, 1 to 5; null when the review has none.
Review text as plain text.
Review text with the site's own formatting (HTML).
Whether the reviewer marked it as containing spoilers.
Likes.
Comments.
Shelf the reviewer put the book on, e.g. `read`.
The reviewer's own shelves for the book.
Who the reviewer recommends it to.
When it was posted, ISO 8601.
When it was last edited, ISO 8601.
Pagination state for the current page.
Whether another page is available.
Pass as `cursor` to get the next page; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/goodreads/books/2767052/reviews" \
-H "x-api-key: YOUR_API_KEY"Responses
Goodreads book reviews.