Fetch Goodreads books, reader reviews, authors, quotes, series and Listopia lists as structured JSON with one SocialCrawl API key. Reviews use the shared Review schema. Reads are priced in credits.
10 active endpoints. Books, reviews, authors, quotes and lists.
Ten read endpoints for public Goodreads data. Search books, read a book in full, page through reader reviews, list editions, look up authors, and read quotes, series and Listopia lists.
/v1/goodreads/bookOne book in full. Returns title, authors and roles, series and position, description, genres, the average rating with its 1 to 5 star breakdown, rating and review counts, review counts by language, edition format, pages, publisher, ISBN and ASIN, awards, characters and how many readers are reading it or want to read it. Standard tier (1 credit).
id, url, isbn, include_similar, include_lists, include_preview
/v1/goodreads/book/reviewsReader reviews of a book, 30 a page: popular, newest or oldest. Filter to one star rating, one language or a phrase. Each review has its rating out of 5, text, date, helpful votes and the reviewer with their review count. Advanced tier (5 credits).
id, url, isbn, sort, rating, language, search, limit, cursor
/v1/goodreads/review/commentsThe comments readers left under one review, with text, date and commenter. Take id from review.id on the book reviews route. Standard tier (1 credit).
id, limit, cursor
/v1/goodreads/book/editionsEvery edition of a book. Returns format, pages, publisher, publication date, language, ISBN, ISBN-13 and ASIN for each. Standard tier (1 credit).
id, url, isbn, limit, cursor
/v1/goodreads/searchBooks matching a title, author or keyword, with authors, average rating, rating and review counts, first publication year, pages and series. Standard tier (1 credit).
query, limit, cursor
/v1/goodreads/authorOne author. Returns name, photo, biography, follower count, number of works, birthplace and website. Standard tier (1 credit).
id, url
/v1/goodreads/author/booksAn author's books with average rating, rating and review counts, first publication year and edition count. Sort by popular, title, newest, rating or pages. Standard tier (1 credit).
id, url, sort, limit, cursor
/v1/goodreads/quotesQuotes from one book, by one author, under one tag or matching keywords. Each has its text, author, book, tags and likes. Send exactly one of book, author, tag or query. Standard tier (1 credit).
book, author, tag, query, limit, cursor
/v1/goodreads/seriesThe books of one series in reading order, each with its position, rating and counts, plus the series title and description. A series comes back whole in one call. Standard tier (1 credit).
id, url
/v1/goodreads/listsWith id or url, the books ranked on one Listopia list with rank, score and votes. With tag, the lists for that tag with their book and voter counts. Standard tier (1 credit).
id, url, tag, limit, cursor
Returns one Goodreads book: title, authors, series, description, genres, average rating with the star breakdown, counts, edition details, awards, and current readers.
Use it to profile a title: how readers rate it, how many are reading it now, and which edition you are looking at.
1 credit
$ curl https://www.socialcrawl.dev/v1/goodreads/book?id=5907 \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseGoodreads is a normal SocialCrawl data surface. You call GET /v1/goodreads/… with an API key, spend credits on live misses, and get a single JSON envelope back.
Send your key in the x-api-key header. No Goodreads account or developer app is needed for public reads. The same key works across SocialCrawl platforms.
Books accept one of id, url or isbn. Authors accept id or url. Search takes query. Formats are validated before any charge.
Book reviews cost 5 credits. Every other Goodreads route costs 1 credit. Cache hits cost 0.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.
Most products find an entity first, then deepen into detail and reviews only when needed.
GET /v1/goodreads/search?query=…Books matching a title, author or keyword
Search returns the book id the other routes take.
GET /v1/goodreads/book?id=…Rating breakdown, counts, editions data and genres
One call gives the average rating, the 1 to 5 star spread and review counts by language.
GET /v1/goodreads/book/reviews?id=…ReviewList, 30 a page, with rating and language filters
Filter to one star rating or one language, then pass the cursor for the next page.
GET /v1/goodreads/author/books?id=…An author's books sorted by popularity or date
Compare how an author's other books are rated.
GET /v1/goodreads/search?query=the+hobbit
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/goodreads/book/reviews?id=5907&sort=newest{
"success": true,
"data": {
"items": [
{
"review": {
"rating": 5,
"text": "Example review text",
"helpful_votes": 12,
"language": "en"
}
}
]
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.
title, authors, average rating, rating and review counts, first publication year
items[] with rating, text, date, helpful_votes and the reviewer
items[] with text, date and commenter
name, photo, biography, followers, works count, birthplace
Same request lifecycle as every other /v1 platform endpoint. Goodreads is not a sidecar.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
Registry lookup finds the goodreads route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public page is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.
Goodreads data is mapped to the Author, ReviewList and CommentList archetypes or returned as structured analytics rows, validated, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
Goodreads is public read data. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.
Public book pages, reader reviews, author pages, quotes, series and Listopia lists.
Public pages are read on request and normalized server-side. You never run a Goodreads login.
ReviewList and CommentList for reader text, Author for authors, and structured rows for books, quotes, series and lists.
No shelves, ratings you submit, reviews you post or private reading data.
The jobs this API is most often used for.
Book sentiment, publishing research and reader-voice mining
Callers search for a book first, then deepen into its rating breakdown, reviews and the author's other titles. Reader reviews filtered by star rating, language or phrase, in the shared Review schema, at a flat 5 credits a page of 30.
Live misses read the public page on request. Repeat calls hit cache and cost 0 credits.
Common ways teams put this data to work, and the stack each one tends to run.
book and author/books to compare ratings and review volume across a list.
book/reviews with rating and language filters for reader-language mining.
lists and series to build reading-order and similar-book features.
Book search is 1 credit. A page of reviews is 5. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/goodreads/search?query=the+hobbit" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/goodreads/book/reviews?id=5907&sort=newest" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl