Goodreads Reviews Scraper avatar

Goodreads Reviews Scraper

Pricing

from $1.60 / 1,000 goodreads reviews scrapers

Go to Apify Store
Goodreads Reviews Scraper

Goodreads Reviews Scraper

Collect public Goodreads book reviews with reviewer, rating, date, text, likes, spoiler status, and profile links.

Pricing

from $1.60 / 1,000 goodreads reviews scrapers

Rating

0.0

(0)

Developer

Vitalii Bondarev

Vitalii Bondarev

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

2 days ago

Last modified

Share

Collect public book reviews from Goodreads. Each dataset item represents one review and includes the book, reviewer, star rating, review date, review text, like count, spoiler warning, and links back to the review and reviewer profile. The actor reads Goodreads' public review page without logging in.

Input

FieldTypeDefaultDescription
startUrlstring—Optional HTTPS URL for a Goodreads book reviews page. When provided, it takes precedence over bookId.
bookIdstring4671Goodreads book ID used when startUrl is empty.
maxResultsinteger50Maximum number of records written. Goodreads currently returns review cards in page-sized responses, so a run may return fewer items than this cap.
sortstringdefaultKeep page order, sort by rating, or sort by newest review date.
ratinginteger—Keep only reviews with the selected rating from 1 to 5.
proxyConfigurationobject—Optional Apify proxy settings. Set useApifyProxy to false or omit the field to connect directly.

Example input:

{
"bookId": "4671",
"maxResults": 10,
"sort": "default",
"proxyConfiguration": {"useApifyProxy": false}
}

Output

The dataset contains only values present in Goodreads' review markup. A profile image, rating, likes count, or text field is omitted from an individual record when the page does not provide it. The spoiler field is true when Goodreads marks a review as hidden because it contains spoilers.

Example based on the first review in the captured public page. The review body is omitted here:

{
"imageUrl": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1619377733i/3672777._UX200_CR0,12,200,200_.jpg",
"reviewId": "101057684",
"bookId": "4671",
"bookTitle": "The Great Gatsby",
"reviewerName": "Nataliya",
"rating": 5,
"reviewDate": "May 3, 2010",
"reviewText": "[review text omitted]",
"likeCount": 2638,
"spoiler": false,
"reviewUrl": "https://www.goodreads.com/review/show/101057684",
"reviewerProfileUrl": "https://www.goodreads.com/user/show/3672777-nataliya",
"scrapedTimestamp": "<UTC timestamp>"
}

Pricing

The comparable Goodreads actor lists a price of $0.012 per result. This README records that benchmark; customer billing depends on the price configured for the published listing.