GET/goodreads/author/{id}apiKey2 credits/request
Returns a Goodreads author profile: bio, birth/death dates, website, genres, photo, and aggregate rating stats.
Required: id.
Sampled 14 Oct 2026: 11 fields returned with a value. In the sample: average_rating: 4.3; website: suzannecollinsbooks.com; about: 750 characters; genres: 3 entries; image_url: images.gr-assets.com; ratings_count: 21,912,345; reviews_count: 1,011,434; uri: goodreads.com.
Open in Playground
GET/goodreads/author/{id}/booksapiKey2 credits/request
Lists 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.
Required: id. Optional: page.
Sampled 14 Oct 2026: 30 items. Filled in every item: id, title, author, average_rating, ratings_count, uri. In the sample: average_rating: 3.81 to 4.66, median 4.36; uri: goodreads.com; ratings_count: 26 to 10,316,121, median 2,567.
Open in Playground
GET/goodreads/author/{id}/quotesapiKey2 credits/request
Returns 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).
Required: id. Optional: page.
Sampled 14 Oct 2026: 30 items. Filled in every item: id, text, author, book_title, book_id, work_id, likes, uri. Not in every item: tags (24). In the sample: likes: 3,166 to 28,923, median 6,051; uri: goodreads.com; tags: median 2 entries.
Open in Playground
GET/goodreads/book/{id}apiKey3 credits/request
Returns a Goodreads book: description, authors, series, genres, format, pages, publisher, publication date, ISBNs, and aggregate rating with the full 1-5 star distribution.
Required: id.
Sampled 14 Oct 2026: 19 fields returned with a value. In the sample: publication_date: 2008-10-14; pages: 374; image_url: m.media-amazon.com; description: 843 characters; authors: 1 entry; genres: 10 entries; rating.average: 4.36; rating.ratings_count: 10,316,071.
Open in Playground
GET/goodreads/book/{id}/editionsapiKey3 credits/request
Returns 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.
Required: id. Optional: page.
Sampled 14 Oct 2026: 10 items. Filled in every item: book_id, title, authors, format, pages, publication_date, publisher, asin and 4 more. Not in every item: isbn (3), isbn13 (3). In the sample: pages: 352 to 458, median 387; uri: goodreads.com; authors: median 1 entry; average_rating: 4.33 to 4.61, median 4.43; ratings_count: 10,390 to 9,889,517, median 18,135.
Open in Playground
GET/goodreads/book/{id}/reviewsapiKey2 credits/request
Returns a book's featured reviews (reviewer, rating, text, date, like/comment counts, spoiler flag), sorted by like count.
Required: id. Optional: limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: reviewer, reviewer_url, rating, text, date, like_count, comment_count. Not in every item: contains_spoilers (1). In the sample: date: 2008-09-20 to 2025-03-19; rating: 1 to 5, median 4; reviewer_url: goodreads.com; contains_spoilers: true in 1 of 1; text: median 3,068 characters; like_count: 354 to 2,057, median 561; comment_count: 2 to 344, median 95.
Open in Playground
GET/goodreads/genre/{name}apiKey2 credits/request
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.
Required: name.
Sampled 14 Oct 2026: 50 items. Filled in every item: id, title, author, author_id, average_rating, ratings_count, publication_year, shelved_count and 1 more. In the sample: average_rating: 3.68 to 4.66, median 4.36; uri: goodreads.com; ratings_count: 448,540 to 11,867,041, median 1,793,915; publication_year: 1,937 to 2,023, median 2,007; shelved_count: 24,774 to 90,783, median 33,146.
Open in Playground
GET/goodreads/list/{id}apiKey2 credits/request
Returns a Goodreads Listopia list (ranked book list) by id, paginated.
Required: id. Optional: page.
Sampled 14 Oct 2026: 100 items. Filled in every item: id, title, author, average_rating, ratings_count, uri. In the sample: average_rating: 3.68 to 4.62, median 4.16; uri: goodreads.com; ratings_count: 45,852 to 11,866,997, median 1,722,942.
Open in Playground
GET/goodreads/listsapiKey2 credits/request
Returns 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`.
Takes no parameters.
Sampled 14 Oct 2026: 300 items. Filled in every item: id, name, category.
Open in Playground
GET/goodreads/searchapiKey1 credit/request
Searches 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.
Required: q. Optional: limit.
Sampled 14 Oct 2026: 5 items. Filled in every item: id, title, author, author_id, average_rating, ratings_count, pages, description and 2 more. In the sample: average_rating: 4 to 4.49, median 4.36; image_url: i.gr-assets.com; description: median 178 characters; ratings_count: 1,316,316 to 10,316,078, median 3,891,739; pages: 374 to 541, median 391; uri: goodreads.com.
Open in Playground