Book rating and review collection
Mit Goodreads-Endpunkten verwandelst du book rating and review collection in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
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.
Endpunkt-Familien
6
Dokumentierte Parameter
25
Beispiele
10
Live-Katalog-Snapshot
Aktive Endpunkte
10
Methoden
GET
Pflichtparameter
19
Schema-Referenzen
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.
Mit Goodreads-Endpunkten verwandelst du book rating and review collection in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Goodreads-Endpunkten verwandelst du author and bibliography enrichment in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Goodreads-Endpunkten verwandelst du list and ranking monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-Goodreads-Endpunktkatalog — 10 Endpunkte, 25 dokumentierte Request-Parameter und 10 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
10 documented Goodreads endpoints, grouped into 6 request families — Author, Book and Genre, plus 3 more.
25 request parameters are documented across those Goodreads endpoints, 19 of them required — the full input contract is public before you write any integration code.
10 of the 10 Goodreads endpoints ship a recorded example response, and 10 carry a documented response schema — you can code against the real JSON before the first request.
Goodreads endpoints document their error responses (400, 404, 429, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
10 hosted MCP tools back the Goodreads endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Abdeckungskarte
Diese Karten werden aus dem aktiven Endpunktkatalog generiert, damit die Landingpage dieselbe API-Oberfläche widerspiegelt, die auch Docs und Playground nutzen.
/goodreads/author/{id}
/goodreads/book/{id}
/goodreads/genre/{name}
/goodreads/list/{id}
/goodreads/lists
/goodreads/search
Endpunktkatalog
/goodreads/searchSearches Goodreads books by title/author. Credential-free public Goodreads data via the autocomplete endpoint (book results only).
MCP-Tool goodreads_search
/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.
MCP-Tool goodreads_book
/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.
MCP-Tool goodreads_book_reviews
/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.
MCP-Tool goodreads_author
/goodreads/author/{id}/booksReturns an author's paginated works list (title, author, average rating, ratings count). Credential-free public Goodreads data.
MCP-Tool goodreads_author_books
/goodreads/list/{id}Returns a Goodreads Listopia list (ranked book list) by id, paginated. Credential-free public Goodreads data; page 1 of well-known lists may be served from a faster live source, with the public list page itself as fallback for every other case.
MCP-Tool goodreads_list
/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.
MCP-Tool goodreads_author_quotes
/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.
MCP-Tool goodreads_book_editions
/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.
MCP-Tool goodreads_genre
/goodreads/listsReturns a 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 served from a live popular-lists source when available, falling back to a curated, hand-picked catalog otherwise. 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`.
MCP-Tool goodreads_lists
Verwandte 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
Search public Ticketmaster events and browse the full discovery hierarchy by category or city, with pagination plus event, attraction, and venue detail endpoints -- including fan reviews, related attractions, trending attractions, and enhanced venue branding -- for live-entertainment research.
So scrapst du Goodreads
Crawlora's Goodreads endpoints return books, editions, reviews, authors, quotes, genre shelves, and Listopia lists as normalized JSON. Goodreads data is edition-aware. /goodreads/book/{id} returns a full five-star rating distribution and ISBNs for the specific edition, and /goodreads/book/{id}/editions walks every edition of the underlying work. Dune's 2019 Ace hardcover alone had 877,905 ratings.
/goodreads/search (backed by Goodreads' autocomplete) returns id, title, author and author_id, average_rating, ratings_count, and page count. /goodreads/book/{id} adds series (Dune #1), genres, format, publisher, publication_date, isbn and isbn13, language, and rating counts per star. Dune had 897,034 five-star and 26,083 one-star ratings.
/goodreads/book/{id}/editions resolves the book's work_id and pages through every edition, each with format, pages, publisher, ISBN and ASIN, language, and that edition's own rating. Aggregate editions to get a work-level total.
/goodreads/author/{id}/quotes returns an author's quotes with likes and tags. Frank Herbert's top quote had 17,028 likes. /goodreads/genre/{name} lists a shelf's books with shelved_count, the number of readers who shelved each book in that genre.
/goodreads/lists returns a catalog of about 300 well-known lists, starting with Best Books Ever, because Goodreads has no list directory of its own. /goodreads/list/{id} pages through a list's ranked books.
FAQ
Call /goodreads/book/{id}/editions. It pages through every edition of the book's work, each with ISBN, ASIN, format, publisher, and its own rating.
Yes. /goodreads/author/{id}/quotes returns an author's quotes with text, source book, tags, and like count, 30 per page.
No. Amazon-owned Goodreads shut down public developer API access in December 2020 and has not shipped an official replacement — existing API keys stopped working and no new keys are issued. Crawlora's Goodreads endpoints return book detail, ratings, reviews, author profiles, and list rankings as structured JSON with a single API key, no waitlist or grandfathered access required.