Book rating and review collection
Goodreadsエンドポイントを使えば、「Book rating and review collection」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
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.
エンドポイントファミリー
6
ドキュメント化されたパラメータ
25
サンプル数
10
ライブカタログスナップショット
稼働エンドポイント
10
メソッド
GET
必須パラメータ
19
スキーマ参照
10
{
"platform": "Goodreads",
"endpoint": "goodreads-search",
"method": "GET",
"path": "/goodreads/search",
"auth": "apiKey"
}ユースケース
Extract Goodreads book detail, ratings, reviews, author profiles, author books, and list rankings as structured JSON from public Goodreads pages.
Goodreadsエンドポイントを使えば、「Book rating and review collection」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Goodreadsエンドポイントを使えば、「Author and bibliography enrichment」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Goodreadsエンドポイントを使えば、「List and ranking monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のGoodreadsエンドポイントカタログから取得しています（エンドポイント10件、ドキュメント化されたリクエストパラメータ25個、公開レスポンススキーマ10件）。DocsとPlaygroundが参照しているカタログと同じものです。
Goodreadsのエンドポイントは10件、6つのリクエストファミリーに分類されています（Author、Book、Genreほか3件）。
これらのGoodreadsエンドポイントには25個のリクエストパラメータがドキュメント化されており、うち19個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
10件のGoodreadsエンドポイントのうち10件が実際のサンプルレスポンスを、10件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Goodreadsのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Goodreadsのエンドポイントは10個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/goodreads/author/{id}
/goodreads/book/{id}
/goodreads/genre/{name}
/goodreads/list/{id}
/goodreads/lists
/goodreads/search
エンドポイントカタログ
/goodreads/searchSearches Goodreads for books by title or author using `q`, returning up to `limit` results (default 10, max 50). Each result has its id, title, author and author id, average rating, ratings count, page count, a truncated description, cover image URL and Goodreads URL. Only books are returned, not authors or lists.
MCPツール goodreads_search
/goodreads/book/{id}Returns a Goodreads book: description, authors, series, genres, format, pages, publisher, publication date, ISBNs, and aggregate rating with the full 1-5 star distribution.
MCPツール goodreads_book
/goodreads/book/{id}/reviewsReturns a book's featured reviews (reviewer, rating, text, date, like/comment counts, spoiler flag), sorted by like count.
MCPツール goodreads_book_reviews
/goodreads/author/{id}Returns a Goodreads author profile: bio, birth/death dates, website, genres, photo, and aggregate rating stats.
MCPツール goodreads_author
/goodreads/author/{id}/booksLists the books of a Goodreads author by author `id`, about 30 per page; `page` is 1-based and defaults to 1. Each book has its `id`, title, author, average rating, ratings count and Goodreads URL, and the `id` can be used to look up the full book.
MCPツール goodreads_author_books
/goodreads/list/{id}Returns a Goodreads Listopia list (ranked book list) by id, paginated.
MCPツール 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).
MCPツール 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; requests against a book with no editions data return an upstream error.
MCPツール 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' 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ツール 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ツール goodreads_lists
関連API
Media & Streaming
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
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. A pull on 2026-10-27 showed a directory of 300 lists (starting with Best Books Ever) and a fantasy genre page of 50 books led by Harry Potter and the Philosopher's Stone.
/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.
lists returned 300 lists, the first Best Books Ever (id 1, category general). Pass an id to the list route and page.
genre fantasy returned 50 books; the first, Harry Potter and the Philosopher's Stone (id 42844155), had an average rating of 4.47 from 11,887,504 ratings and a 1997 publication year. Ratings counts are large integers, so avoid 32-bit storage.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Goodreads のデータを JSON として取得できます。Goodreads に対応するスキル:
Researches books, authors, and audiobooks via the Crawlora API — Goodreads (books, authors, reviews, lists, quotes), Apple Books (books, audiobooks…
npx skills add github.com/Crawlora-org/crawlora-skills --skill book-researchCompare book niches and title positioning through Crawlora Goodreads catalogs, editions, review samples, and Apple Books/Audible listings. Use for…
npx skills add github.com/Crawlora-org/crawlora-skills --skill book-market-positioningFAQ
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.
300 on 2026-10-27, each with an id and category.