# Goodreads Scraper: Books, Ratings, ISBN, Genres and Reviews (`themineworks/goodreads-scraper`) Actor

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.

- **URL**: https://apify.com/themineworks/goodreads-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Social media, E-commerce, Education
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.35 / 1,000 books

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

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

[![20 Goodreads books with rating, ratings count, genres, pages, ISBN and description in 3 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/goodreads-scraper-hero.png)](https://console.apify.com/actors/Tr4yBcdSjPwTqra1s/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

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](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [MLB Stats API Scraper](https://apify.com/themineworks/mlb-stats-api-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Flashscore Tennis Scraper](https://apify.com/themineworks/flashscore-tennis-results-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

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](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/Tr4yBcdSjPwTqra1s/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### 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:

```json
{
  "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

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

#### Catalog enrichment: ISBNs to full book rows

```json
{
  "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

```json
{
  "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

```json
{
  "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

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

### Input parameters

| Field | Type | What it does |
|---|---|---|
| `searchQueries` | list of text | Keywords as typed in the Goodreads search box, or ISBNs. Goodreads links work here too. |
| `startUrls` | list of links | Goodreads book, list, shelf, genre, author, series or search links. |
| `searchField` | `all`, `title`, `author` | Which part of the book the keywords must match. Default `all`. |
| `maxItems` | number | The most books per keyword or link, 1 to 2,000. Default 20. |
| `output` | `books`, `books_and_reviews`, `reviews` | Books only, books with their reviews, or reviews only. Default `books`. |
| `maxReviewsPerBook` | number | The most reviews per book when reviews are on, 1 to 5,000. Default 30. |
| `reviewRatingMin`, `reviewRatingMax` | 1 to 5 | Only reviews within these stars. |
| `reviewLanguage` | text | Two letter code such as `en`, `es` or `de`, for reviews in that language. |
| `proxyConfiguration` | proxy | Leave 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

```json
{
  "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
}
```

```json
{
  "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.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `book` | Once 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 |
| `review` | Once 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-start` | Once 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

| Actor | Price per 1,000 on the Free plan | Start fee | Lists, shelves, genres, authors, series | Reviews | Platform usage |
|---|---|---|---|---|---|
| **This actor** | $1.70 books or reviews | $0.001 per run | Yes | Yes, rows of their own, star and language filters | Included |
| [Goodreads Scraper by epctex](https://apify.com/epctex/goodreads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.90 | $0.00005 per run | Yes | Inside the book row | Paid by you on top |
| [Goodreads Books, ISBN & Reviews Scraper API by thescrapelab](https://apify.com/thescrapelab/Apify-Goodreads-Scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.50 | $0.00005 per run | Series and search, lists not stated | Yes, reviews mode | Included |
| [Goodreads Book Scraper by easyapi](https://apify.com/easyapi/goodreads-book-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.99 | $0.09 per run | Keyword search | Separate actor | Paid 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"`

#### Is it legal to scrape Goodreads?

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**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [MLB Stats API Scraper](https://apify.com/themineworks/mlb-stats-api-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Flashscore Tennis Scraper](https://apify.com/themineworks/flashscore-tennis-results-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kwai Video Scraper](https://apify.com/themineworks/kwai-video-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Capterra Reviews Scraper](https://apify.com/themineworks/capterra-software-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LandWatch Scraper](https://apify.com/themineworks/landwatch-land-for-sale-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Lens OCR Scraper](https://apify.com/themineworks/google-lens-ocr-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Hotels Prices Scraper](https://apify.com/themineworks/google-hotels-prices-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Tennis Match & Player Data Scraper](https://apify.com/themineworks/tennis-match-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### 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.*

# Actor input Schema

## `searchQueries` (type: `array`):

Words as you would type them in the Goodreads search box, one per line, for example dune, stephen king or atomic habits. An ISBN (10 or 13 digits) returns that exact book. Goodreads links work here too. Each keyword is one search, up to 2,000 books each.

## `startUrls` (type: `array`):

Links copied from goodreads.com: a book (https://www.goodreads.com/book/show/41865.Twilight), a Listopia list (https://www.goodreads.com/list/show/1.Best_Books_Ever), a shelf (https://www.goodreads.com/shelf/show/art), a genre (https://www.goodreads.com/genres/most_read/fantasy), an author (https://www.goodreads.com/author/list/1221698.Neil_Gaiman), a series or a search link. Lists, authors and searches are read page by page.

## `searchField` (type: `string`):

Which part of the book the keywords must match, as on the Goodreads search page.

## `maxItems` (type: `integer`):

The most books to return for each keyword or link, 1 to 2,000. Goodreads serves up to 2,000 results for one search; a shelf, genre or series page holds up to 100.

## `output` (type: `string`):

Books only gives one row per book. Books and their reviews adds one row per review after each book. Reviews only gives just the review rows (each still names its book).

## `maxReviewsPerBook` (type: `integer`):

Used when reviews are on. Reviews come in the order the Goodreads book page shows them, 100 per call.

## `reviewRatingMin` (type: `integer`):

Only reviews with at least this many stars, 1 to 5. Leave empty for all.

## `reviewRatingMax` (type: `integer`):

Only reviews with at most this many stars, 1 to 5. Set both to 1 for one star reviews only.

## `reviewLanguage` (type: `string`):

A two letter language code, for example en, es or de, to get reviews written in that language only.

## `proxyConfiguration` (type: `object`):

Leave empty: the actor goes direct and switches to an Apify datacenter IP on its own when needed. Set it only to force your own proxy.

## Actor input object example

```json
{
  "searchQueries": [
    "dune"
  ],
  "searchField": "all",
  "maxItems": 20,
  "output": "books",
  "maxReviewsPerBook": 30
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "dune"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/goodreads-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["dune"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/goodreads-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "dune"
  ],
  "maxItems": 20
}' |
apify call themineworks/goodreads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/goodreads-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Tr4yBcdSjPwTqra1s/builds/F5EiuZVHN34AxwCKk/openapi.json
