Skip to content
//Goodreads Scraper example\\

Harry Potter books, 10 books

A ready-to-run Goodreads Scraper input: Harry Potter books, 10 books.

Updated October 27, 2026

What this example returns

This example returns up to 10 books.

The dataset’s “Books” view shows 12 columns: Cover, Title, Author, Rating, Ratings, Reviews, Genres, Pages, First published, Series, ISBN-13, and Goodreads. See every output field.

What each setting does

The input this example runs Goodreads Scraper with. “Try this input” opens it in the console, where you can run it as-is or change any field first.

Search terms searchTerms

harry potter

Keywords, titles, authors or ISBNs to search on Goodreads. Each term returns up to 2,000 books (Goodreads' own limit).

Maximum books maxItems

10

Maximum number of books to save in total across all inputs. Set 0 for no limit.

Default: 20 → this example uses 10

Last listing page endPage

1

Stop each search or list at this page number (1 = first page only). Leave empty to follow all pages.

Include reviews includeReviews

No

Add community reviews (text, rating, date, likes, shelves, reviewer display name) to every book.

Maximum reviews per book maxReviewsPerBook

0

How many reviews to add per book (0 = as many as possible, up to 5,000). At most 5,000, because the reviews are stored inside the book row, which is kept under 4 MB (longer review lists are cut and marked reviewsTruncated).

Default: 30 → this example uses 0

Sort reviews by reviewsSort

Most relevant (Goodreads default)

Order in which reviews are collected.

.json
{
  "searchTerms": [
    "harry potter"
  ],
  "maxItems": 10,
  "endPage": 1,
  "includeReviews": false,
  "maxReviewsPerBook": 0,
  "reviewsSort": "DEFAULT",
  "startUrls": []
}

What it costs

About $0.011 for 10 books

An estimate: 10 × $0.0011 per book (One Goodreads book saved to the dataset (reviews included)). A run is charged for the events it reports, so one that finds fewer books costs less. Platform usage is included in the event price.

Full pricing

When to use this example

From the Goodreads Scraper readme:

What are the main fields?

The main fields are (bookId, title, authorName, rating, numberOfRatings, numberOfReviews, numberOfPages, publishedBy, buyLinks). Dates are ISO (YYYY-MM-DD), and ISBN, series and literary awards are in isbn, series and awards.

Other ways to run Goodreads Scraper

All examples of Goodreads Scraper

About Goodreads Scraper

Scrape Goodreads books by keyword or from book, Listopia list, shelf, genre, series and author URLs. Get title, authors, rating, rating distribution, ratings and reviews counts, genres, pages, publish dates, ISBN, series, awards, description and cover, plus optional reviews. No login needed.

Price:
from $0.864 / 1,000 results
Developer:
Echofield
Categories:
E-commerce, Marketing, Other

Goodreads Scraper pageOutput fieldsPricing

Related actors

//From the blog\\

Latest articles

All articles

The internet is full of data.
Start owning yours.

Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes.

No credit card. No setup calls.