Book rating and review collection
Use Goodreads endpoints to turn book rating and review collection into repeatable API requests with documented inputs and JSON responses.
Collect Goodreads book detail with average rating and ratings count, book reviews, author profiles and their books, and Listopia list rankings as normalized JSON for book catalogs, ratings research, and enrichment. Credential-free.
Extract Goodreads book detail, ratings, reviews, author profiles, author books, and list rankings as structured JSON from public Goodreads pages.
Endpoint families
6
Documented params
25
Examples
10
Live catalog snapshot
Active endpoints
10
Methods
GET
Required params
19
Schema refs
10
{
"platform": "Goodreads",
"endpoint": "goodreads-search",
"method": "GET",
"path": "/goodreads/search",
"auth": "apiKey"
}Use cases
Extract Goodreads book detail, ratings, reviews, author profiles, author books, and list rankings as structured JSON from public Goodreads pages.
Use Goodreads endpoints to turn book rating and review collection into repeatable API requests with documented inputs and JSON responses.
Use Goodreads endpoints to turn author and bibliography enrichment into repeatable API requests with documented inputs and JSON responses.
Use Goodreads endpoints to turn list and ranking monitoring into repeatable API requests with documented inputs and JSON responses.
Managed execution
Each Crawlora platform API is designed around a specific data surface. Instead of exposing a generic fetch endpoint, Crawlora combines endpoint-specific request logic, managed infrastructure, parsing, normalization, billing, and Playground-tested examples.
Request behavior is tuned for the target platform and endpoint type.
Supported endpoints can use managed proxy routing to improve reliability and reduce infrastructure work.
Dynamic pages can be routed through managed browser instances where JavaScript rendering is required.
Challenge pages and unusable upstream responses are detected and surfaced clearly.
Results are returned as documented JSON instead of raw HTML.
Test the same route from Docs and Playground before production integration.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/goodreads/author/{id}
/goodreads/book/{id}
/goodreads/genre/{name}
/goodreads/list/{id}
/goodreads/lists
/goodreads/search
Endpoint catalog
/goodreads/searchSearches Goodreads books by title/author. Credential-free public Goodreads data via the autocomplete endpoint (book results only).
/goodreads/book/{id}Returns a normalized Goodreads book: description, authors, series, genres, format, pages, publisher, publication date, ISBNs, and aggregate rating with the full 1-5 star distribution. Credential-free public Goodreads data (goodreads.com), parsed from the book page's embedded GraphQL cache.
/goodreads/book/{id}/reviewsReturns a book's featured reviews (reviewer, rating, text, date, like/comment counts, spoiler flag), sorted by like count. Credential-free public Goodreads data.
/goodreads/author/{id}Returns a normalized Goodreads author profile: bio, birth/death dates, website, genres, photo, and aggregate rating stats. Credential-free public Goodreads data.
/goodreads/author/{id}/booksReturns an author's paginated works list (title, author, average rating, ratings count). Credential-free public Goodreads data.
/goodreads/list/{id}Returns a Goodreads Listopia list (ranked book list) by id, paginated. Credential-free public Goodreads data.
/goodreads/author/{id}/quotesReturns an author's paginated attributed-quotes list (quote text, tags, like count, and — when the quote is credited to a specific book — that book's title, id, and work id). Credential-free public Goodreads data.
/goodreads/book/{id}/editionsReturns a work's paginated edition list (per-edition book id, format, page count, publication date, publisher, ISBN/ISBN13/ASIN, language, and rating) — every other translation, printing, and format of the requested book id. Goodreads keys editions by a separate "work id", not the book id in the path, so this makes one extra internal request to resolve it; requests against a book with no editions data return an upstream error.
/goodreads/genre/{name}Returns up to 50 books on a Goodreads genre/shelf tag page (e.g. fantasy, romance, science-fiction), Goodreads' credential-free per-tag "top books" view: title, author, average rating, ratings count, publication year, and how many times the book was shelved under this specific tag. Goodreads' genre/shelf taxonomy is an open, user-generated folksonomy of thousands of tags, not a small fixed list, so there is no directory endpoint — pass any known tag slug, e.g. from a book's genres[] field or a value seen on goodreads.com. There is no pagination beyond the first 50.
/goodreads/listsReturns a curated, non-exhaustive catalog of well-known Goodreads Listopia lists (id, name, category) — Goodreads has no directory or search endpoint for the tens of thousands of user-created lists, so this is hand-picked and verified live, not derived from an upstream index. Pass a returned id to GET /goodreads/list/{id} for that list's ranked book contents. Category enum: `general`, `genre`, `era`, `young_adult`, `children`, `holiday`.
Related APIs
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Media & Streaming
Turn Apple Books ebook and audiobook pages into structured data — search, catalog detail, paginated customer reviews, similar titles, author bibliographies, series listings, and chart rankings as normalized JSON. Credential-free.
Media & Streaming
Collect ESPN sports scores, teams, standings, rankings, rosters, athletes, game summaries, and news as normalized JSON for sports data workflows.
How to scrape Goodreads
Goodreads' book ratings, reviews, and author data power book research and recommendation. Crawlora's Goodreads endpoints return search, book detail, reviews, author profiles, and list rankings as normalized JSON — no login, rate-limit juggling, or proxy setup.
A book search, a book by id (with reviews), an author with their books, or a Listopia list.
Pass a query or a Goodreads id to Crawlora's Goodreads endpoint (e.g. /goodreads/search, /goodreads/book, /goodreads/author/{id}/books).
Receive title, author, average rating, ratings count, page count, and description as clean JSON.
Batch across search results and author bibliographies to build catalogs for recommendation, research, or enrichment.
FAQ
Send a search query or a Goodreads id to Crawlora's Goodreads endpoints and get book detail, average ratings, reviews, author profiles, and list rankings as structured JSON — no login. Collect public data and respect Goodreads' terms.
Yes — /goodreads/book returns the average rating and ratings count, and /goodreads/book/{id}/reviews returns publicly visible reviews for a book. It collects only public data, not private shelves or account information.
Collecting publicly accessible book, rating, and review data is generally permissible if you respect Goodreads' terms of use, robots directives, rate limits, and applicable law. This is for public data you are authorized to collect.