Goodreads Scraper: Books, Ratings, ISBN, Genres and Reviews avatar

Goodreads Scraper: Books, Ratings, ISBN, Genres and Reviews

Pricing

from $1.35 / 1,000 books

Go to Apify Store
Goodreads Scraper: Books, Ratings, ISBN, Genres and Reviews

Goodreads Scraper: Books, Ratings, ISBN, Genres and Reviews

Scrape Goodreads books by keyword, ISBN, list, shelf, genre, author, series or book link: rating, ratings count, reviews count, genres, pages, published date, ISBN, description and cover. Add review rows with text and stars. No login.

Pricing

from $1.35 / 1,000 books

Rating

0.0

(0)

Developer

The Mine Works

The Mine Works

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

Features

Limited permissions

Share

20 Goodreads books with rating, ratings count, genres, pages, ISBN and description in 3 seconds

Returns Goodreads books by keyword, ISBN, Listopia list, shelf, genre, author, series or book link, one row per book with title, author, series, average rating, ratings count, reviews count, the 1 to 5 star breakdown, genres, pages, format, published date, first published date, publisher, language, ISBN, ISBN13, ASIN, awards, description and cover. Switch on reviews to add one row per review with the text, stars, date, likes and the reviewer's public display name. No login, no cookies, no API key. You pay $1.70 per 1,000 books or reviews on the Free plan and $1.35 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

Part of The Mine Works More tools family: G2 Reviews Scraper, Naver Blog Scraper, WeChat Article Scraper 微信公众号文章, Taobao Products Scraper 淘宝 天猫, MLB Stats API Scraper, Flashscore Tennis Scraper.

Updated 17 Nov 2026: first release. Keyword and ISBN search (title, author or both), Listopia lists, shelves, genres, author book lists, series and book links, book details on every row, optional reviews with star and language filters.

Why choose this actor?

  • Every row is a full book, not a search snippet. Search, list and shelf pages only show a title and a rating; this actor fills each book with genres, pages, format, publisher, language, ISBN, ISBN13, ASIN, first published date, series, awards, description and the 1 to 5 star breakdown. In our tests 520 of 520 books carried rating, ratings count, reviews count and description, 99% carried genres and pages.
  • Fast and light. Book details come 10 at a time from the same data the Goodreads book page loads, so 20 books take about 3 seconds and 450 books from five sources under a minute on Apify.
  • Reviews when you want them. One row per review with the text as plain text, stars, date, likes, comments, spoiler flag and shelves. Filter by stars (only 1 and 2 star reviews, for example) or by language. The reviewer appears by public display name only.
  • Pay per row, nothing for errors. Links that are not Goodreads links, books that do not exist, duplicates found by two sources and the summary row are never charged.

Run it on Apify

Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 20 books for "dune". It took 3 seconds in our test run on Apify:

{
"searchQueries": ["dune"],
"maxItems": 20
}

Copy to your AI assistant

Paste this to Claude, ChatGPT or Cursor and it can run the actor for you through the Apify API:

Run the Apify actor themineworks/goodreads-scraper with input {"searchQueries": ["dune"], "maxItems": 20} using my Apify token, wait for it to finish and give me the dataset items as a table with title, author, rating, ratings_count, genres and isbn13.

Key features

  • Keyword search as on goodreads.com, in titles, authors or both, up to 2,000 books per keyword.
  • ISBN 10 or ISBN 13 lookup: the exact book in one small request.
  • Listopia lists (100 books a page, read page by page), author book lists (30 a page), shelves, genre pages and series.
  • Book links and book ids, up to 1,000 per run.
  • Book details on every row, no extra switch and no extra charge.
  • Optional reviews, up to 5,000 per book, with star and language filters, or reviews only.
  • A book found by two sources in one run is delivered once.
  • One summary row per run with pages read, books and reviews delivered and what stopped each source.

How to use it

Basic: books for a keyword

{
"searchQueries": ["atomic habits", "stephen king"],
"maxItems": 50
}

Catalog enrichment: ISBNs to full book rows

{
"searchQueries": ["9780735211292", "9780062316097", "0316015849"]
}

Each ISBN returns that book's rating, ratings count, genres, pages, publisher, description and cover. An ISBN Goodreads does not know gets an error row and is not charged.

Market research: a list, a genre and a shelf

{
"startUrls": [
"https://www.goodreads.com/list/show/1.Best_Books_Ever",
"https://www.goodreads.com/genres/most_read/science-fiction",
"https://www.goodreads.com/shelf/show/business"
],
"maxItems": 100
}

position keeps each book's rank on the list.

An author's books, or a whole series

{
"startUrls": [
"https://www.goodreads.com/author/list/3389.Stephen_King",
"https://www.goodreads.com/series/45363-the-twilight-saga"
],
"maxItems": 200
}

Reader sentiment: low star reviews in English

{
"startUrls": ["https://www.goodreads.com/book/show/5907.The_Hobbit"],
"output": "reviews",
"maxReviewsPerBook": 500,
"reviewRatingMin": 1,
"reviewRatingMax": 2,
"reviewLanguage": "en"
}

Input parameters

FieldTypeWhat it does
searchQuerieslist of textKeywords as typed in the Goodreads search box, or ISBNs. Goodreads links work here too.
startUrlslist of linksGoodreads book, list, shelf, genre, author, series or search links.
searchFieldall, title, authorWhich part of the book the keywords must match. Default all.
maxItemsnumberThe most books per keyword or link, 1 to 2,000. Default 20.
outputbooks, books_and_reviews, reviewsBooks only, books with their reviews, or reviews only. Default books.
maxReviewsPerBooknumberThe most reviews per book when reviews are on, 1 to 5,000. Default 30.
reviewRatingMin, reviewRatingMax1 to 5Only reviews within these stars.
reviewLanguagetextTwo letter code such as en, es or de, for reviews in that language.
proxyConfigurationproxyLeave empty. The actor picks its own route.

What data do you get?

Book rows (type = book): book_id, title, title_complete, author, author_id, author_url, contributors, series, series_position, series_url, rating, ratings_count, reviews_count, rating_distribution, genres, pages, format, published_date, first_published_date, publisher, language, isbn, isbn13, asin, original_title, awards, description, cover_url, url, work_id, plus source, input, search_query, list_title, position, page and scraped_at.

Review rows (type = review): book_id, book_title, book_author, book_url, review_id, rating, text, spoiler, likes, comments, shelves, reviewed_at, updated_at, reviewer_name, review_position, book_reviews_total, source, input, scraped_at.

rating, ratings_count and reviews_count on a book row count all editions of the book, as the Goodreads book page shows them. pages, format, publisher, isbn and published_date belong to the edition the link or search points to. Kindle and older editions often have no ISBN.

Output example

{
"type": "book",
"book_id": "44767458",
"title": "Dune",
"title_complete": "Dune (Dune, #1)",
"author": "Frank Herbert",
"series": "Dune",
"series_position": "1",
"rating": 4.29,
"ratings_count": 1729409,
"reviews_count": 90969,
"rating_distribution": { "1": 26333, "2": 56357, "3": 207719, "4": 533163, "5": 905837 },
"genres": ["Science Fiction", "Fiction", "Fantasy", "Classics", "Audiobook"],
"pages": 658,
"format": "Hardcover",
"published_date": "2019-10-01",
"first_published_date": "1965-06-01",
"publisher": "Ace",
"language": "English",
"isbn": "059309932X",
"isbn13": "9780593099322",
"awards": ["Hugo Award, Best Novel, 1966", "Nebula Award, Best Novel, 1965"],
"description": "Set on the desert planet Arrakis, Dune is the story of the boy Paul Atreides...",
"cover_url": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1555447414i/44767458.jpg",
"url": "https://www.goodreads.com/book/show/44767458-dune",
"source": "search",
"input": "dune",
"position": 1
}
{
"type": "review",
"book_id": "5907",
"book_title": "The Hobbit, or There and Back Again",
"book_author": "J.R.R. Tolkien",
"review_id": "K57x5TdipsgcUAYo53Udhg",
"rating": 5,
"text": "In a hole in the ground there lived a hobbit.\n\nBooks exist in time and place and our experience of them is affected by...",
"spoiler": false,
"likes": 930,
"comments": 155,
"shelves": ["all-time-favorites-fiction", "young-adult", "fiction"],
"reviewed_at": "2008-11-05T15:18:37.000Z",
"reviewer_name": "(the reviewer's public display name)",
"review_position": 1,
"book_reviews_total": 96146
}

Pricing

Pay per event: you pay for the books and reviews you receive, plus a flat $0.001 per run, whatever memory you choose. Book details cost nothing extra.

EventWhen it is chargedFree planBronze (Starter)Silver (Scale)Gold (Business)
bookOnce per book row stored in your dataset$1.70 per 1,000$1.55 per 1,000$1.45 per 1,000$1.35 per 1,000
reviewOnce per review row stored in your dataset$1.70 per 1,000$1.55 per 1,000$1.45 per 1,000$1.35 per 1,000
run-startOnce per run, after the first rows are ready$0.001$0.001$0.001$0.001

With "Reviews only" the book rows are not delivered and not charged.

Never charged:

  • links that are not Goodreads links, member pages, and books or ISBNs Goodreads does not have (each gets an error row);
  • a book that a second source of the same run finds again;
  • books past your maxItems and reviews past your maxReviewsPerBook;
  • the summary, info and error rows;
  • a run with no valid input, or one that finds nothing: the start fee is charged only once rows are ready;
  • anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.

How it compares

ActorPrice per 1,000 on the Free planStart feeLists, shelves, genres, authors, seriesReviewsPlatform usage
This actor$1.70 books or reviews$0.001 per runYesYes, rows of their own, star and language filtersIncluded
Goodreads Scraper by epctex$1.90$0.00005 per runYesInside the book rowPaid by you on top
Goodreads Books, ISBN & Reviews Scraper API by thescrapelab$1.50$0.00005 per runSeries and search, lists not statedYes, reviews modeIncluded
Goodreads Book Scraper by easyapi$2.99$0.09 per runKeyword searchSeparate actorPaid by you on top

Checked 17 Nov 2026 from the public Store listings.

Run it on a schedule

  1. Open the actor in Apify Console, set your input and click Save as a new task.
  2. In the task, open Schedules, click Add schedule and pick how often (every day, every Monday at 08:00 and so on).
  3. Compare runs on book_id and ratings_count to see which books gain readers, or on review_id for new reviews.
  4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

FAQ

What does this actor read?

The same public book data goodreads.com shows anyone without logging in: search results, Listopia lists, shelves, genres, author and series pages, book details and public reviews. It does not log in, does not read member profiles or member bookshelves, and does not read anything behind a Goodreads account.

Do I need an account, cookies or an API key?

No account, no cookies and no API key (Goodreads closed its developer API to new keys in 2020). Nothing to set up; the proxy is included.

How many books can I get?

Up to 2,000 per keyword (Goodreads stops search at page 100), every page of a Listopia list or author list, 50 books per shelf and up to 100 per genre or series page. Run more keywords or links for more.

Why do some books have no ISBN?

Kindle editions, audiobooks and many older or self published editions have no ISBN on Goodreads. They usually carry an ASIN instead. Search by ISBN to get the edition you need.

Why are the rating counts higher than on an edition page?

Goodreads counts ratings and reviews across all editions of a book, and so does this actor, which matches what the book page shows.

What order do reviews come in?

The order the Goodreads book page shows them. Use the star and language filters to narrow them down.

How long does a run take?

About 3 seconds for 20 books, under a minute for 450 books from five lists and searches, and about 8 seconds for 4 books with 100 reviews each (our Apify test runs).

Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the dataset, or through the API. The "Books" and "Reviews" views give ready tables.

Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/goodreads-scraper

  • Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
  • ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
  • Cursor or VS Code: add it as an HTTP MCP server with that URL.
  • Claude Code: claude mcp add -t http goodreads-scraper "https://mcp.apify.com/?tools=themineworks/goodreads-scraper"

The actor reads only public book pages and public reviews that anyone can see without logging in, and gives reviewers by their public display name only. You are responsible for how you use the data, including Goodreads' terms, copyright in review texts and data protection laws that apply to you. This is general information, not legal advice.

Integrations

  • Google Sheets: send each run's books to a sheet with Apify's Google Sheets integration; one row per book fits a sheet as is.
  • Make, Zapier and n8n: start a run and read its dataset with the Apify apps and nodes, for example "new ISBNs from our catalog to full book rows every night".
  • Webhooks: have Apify call your URL when a run succeeds, then fetch the dataset.
  • API and SDKs: run it from Python or JavaScript with the Apify client, or with a plain HTTP call.
  • MCP clients: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

More from The Mine Works

More tools

Social media and video

Leads and business directories

Marketing, SEO and reviews

LinkedIn

Real estate

Science, health and government data

Jobs and hiring

Company and business data

E-commerce and marketplaces

Food and local services

Developer and AI tools

Support

Found a link that returns fewer books than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

Search Goodreads by keyword, ISBN, list, shelf, genre, author or series and get every book back as one row, with rating, ratings count, genres, pages, ISBN and description, plus reviews if you want them, no login.