Goodreads Review Scraper 📚

🔍 What does Goodreads Review Scraper do?

This actor scrapes detailed book reviews and related data from Goodreads.com, the world's largest community for readers. For each book URL provided, it extracts comprehensive review information including:

• 📝 Full review text content
• ⭐ Rating (1-5 stars)
• 👤 Reviewer information (name, profile URL, followers count)
• 📊 Engagement metrics (likes, comments)
• 📅 Review timestamps (created, updated)
• 🏷️ Shelving information and tags
• 🔍 Additional metadata (spoiler status, etc.)

✨ Features

• 🚀 High-performance scraping with Puppeteer
• 🔄 Automatic scrolling to load more reviews
• 🛡️ Built-in proxy support
• 🎯 Configurable maximum items limit
• 🤖 Anti-detection mechanisms
• ⚡ Parallel processing of multiple book URLs

💡 Use Cases

• 📊 Book market research and analysis
• 🎯 Reader sentiment analysis
• 📈 Track book popularity and reception
• 🔍 Literary trend research
• 📚 Building book recommendation systems
• 🎨 Content curation for book-related platforms

🛠️ Input Configuration

The actor accepts the following input parameters:

• bookUrls (Required): Array of Goodreads book URLs to scrape reviews from
• maxItems (Optional): Maximum number of reviews to collect per book (default: unlimited)
• proxyConfiguration (Optional): Proxy settings for avoiding IP blocks

⚠️ Limitations

• Respects Goodreads' terms of service and rate limits
• Some reviews might be hidden or not accessible
• Performance depends on the number of reviews and network conditions

💪 Tips for Best Results

1. 🕒 Use reasonable maxItems limits for better performance
2. 🌐 Configure proxy for large-scale scraping
3. 📋 Provide valid Goodreads book URLs
4. ⚡ Run multiple actors in parallel for bulk scraping

Input Example

A full explanation of an input example in JSON.

1{
2    "bookUrls": [
3        "https://www.goodreads.com/book/show/1137215"
4    ],
5    "maxItems": 50
6}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

1[
2    {
3        "bookUrl": "https://www.goodreads.com/book/show/1137215",
4        "__typename": "Review",
5        "id": "kca://review:goodreads/amzn1.gr.review:goodreads.v1.sdrC-ZRjzY6QMCANZHeBhQ",
6        "creator": {
7            "id": 1036930,
8            "imageUrlSquare": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1583425448i/1036930._UY200_CR0,0,200,200_.jpg",
9            "isAuthor": false,
10            "viewerRelationshipStatus": null,
11            "followersCount": 842,
12            "__typename": "User",
13            "textReviewsCount": 273,
14            "name": "Michael",
15            "webUrl": "https://www.goodreads.com/user/show/1036930-michael",
16            "contributor": null
17        },
18        "recommendFor": null,
19        "updatedAt": 1739910885488,
20        "createdAt": 1267104748000,
21        "spoilerStatus": false,
22        "lastRevisionAt": 1386195467000,
23        "text": "``Miss Eliza Bennet, let me persuade you to follow my example, and take a turn about the room. -- I assure you the anti-gravity hoverchannel is very refreshing after sitting so long in one attitude.''<br /> <br />Eliza was surprised, but agreed to it immediately. She unstrapt herself from her leather seat restraints and stood, careful to maintain her balance as the airship encountered turbulence. When she entered the hoverchannel, she activated the polarity redistribution magnets within her combat suit and began floating comfortably around the perimeter of the foyer.<br /> <br />Miss Bingley's attention was quite engaged in watching Mr. Darcy's progress through his book, so much so that at one point she nearly navigated the ship into the side of Pemberley; and she was perpetually making some inquiry.<br /> <br />At length, finally exhausted by her tenacious attempts to force a conversation regarding his book, Darcy relented. \"It's entitled Boneshaker. An American novel.\"<br /> <br />\"What do you think of it?\" Eliza said as she drifted by. <br /> <br />\"A bit nonsensical, really. Steampunk claptrap about the Civil War going on much longer than it actually did, which caused technological advances that didn't really happen until much later. And a zombie-infested city called Seattle. It has been blocked off from the rest of the country, and our heroine must go in to rescue her foolish son.\" <br /> <br />Mr. Bingley crossed the room, his steam-powered mechanical legs stomping their way across the carpet to the cabinet where he refilled his glass. \"Zombies in America? That does sound quite silly. Everyone knows that zombies are native to Britain. That's how I lost my legs.\"<br /> <br />\"Please, Bingley, don't tell us that old story again,\" Mr. Hurst said, adjusting himself on the sofa before falling back asleep.<br /> <br />Darcy said, \"The plot moves along at a good pace, but the characters are a bit uninspired. A teenage boy constantly doing something inadvisable; the protective mother, blasting zombies and trying to save him.\"<br /> <br />Eliza smiled. \"Darcy, certainly you aren't saying literature is full of strong female characters who run around rescuing male characters.\"<br /> <br />\"Nor should it be,\" Mr. Hurst said, drifting slowly in and out of consciousness.<br /> <br />Ignoring Mr. Hurst's interjection, Darcy said, \"I suppose the fairer sex aren't shown in powerful roles that often, even in these books written in the far future about the distant past . . . er, or perhaps about the same time as now . . . When were we written?\"<br /> <br />Miss Bingley inquired, \"Are you sure the dinner agreed with you?\"<br /> <br />\"I feel fine, thank you,\" Darcy said. <br /> <br />\"Admit it,\" Sherlock Holmes said, standing in the doorway, Watson at his side. \"You enjoy all the fashionable gimmicks flying left and right, and the pace keeps you entertained. Yet you wonder why nothing surprising was done with any of these elements.\"<br /> <br />Darcy moved over as Holmes sat on the sofa beside him, lighting a pipe. \"You're right, Holmes. The whole reinvention of the Civil War is fascinating in theory. Then the author does nothing with it. The book has nothing to say. No reflections on the civil war, racism, or politics. Nor does it say anything about the true nature of zombies. In fact, it says little about love, which is the very heart of the story.\"<br /> <br />J. K. Rowling, refilling her glass of zinfandel, said, \"And it's practically a young adult novel, isn't it? Other than one or two mildly violent zombie moments and one four letter 'S' word, this could be the next film from Pixar. There's not even a gay sorcerer to throw off the prudes.\" <br /> <br />Darcy met Eliza's eyes as she orbited the room. \"Have you read it as well, Miss Bennett?\"<br /> <br />\"Braaaains,\" Mr. Hurst moaned softly.<br /><br />\"I found it diverting,\" Eliza said. \"I always read the books nominated for the Nebula awards. But, like you, I found the novel didn't meet my expectations. When you look beyond the stylish trappings, you have a run-of-the-mill adventure story written in a workmanlike fashion. I imagine the query letter was spectacular, though.\"<br /> <br />Darcy was on the verge of speaking when Mr. Hurst lunged up from the sofa, saliva splattering from his vicious maw, his eyes sunken in and rolled back into his head. He lurched across the room toward Bingley, whose back was facing him.<br /> <br />Eliza kicked off of the wall and rolled over to Darcy, pulling his pistol from his belt, and fired several rounds through Mr. Hurst's head. A splatter of blood, brain and skull chips showered down on Harold Bloom.<br /> <br />\"Well,\" Mr. Harold Bloom said, wiping blood from his face and wiping it on the sofa, \"that was entirely unnecessary, but what HASN'T been? The whole book review is sound and fury, signifying nothing. And how many times is this hack going to parody <u>Pride and Prejudice</u>? He seems to think it's much more funny than it is, just as Oscar Wilde thought himself hilarious, when he is in fact highly over-esteemed.\"<br /> <br />Holmes puffed his pipe, a gray cloud of smoke rising above him. \"I can't believe I didn't notice Mr. Hurst was turning. Usually I'm so attentive to details.\"<br /> <br />\"Nobody's perfect,\" Darcy said. \"Would you mind putting that pipe out? We are in a zeppelin, you know.\"<br /> <br />Holmes sighed and stood up, pulling on his overcoat. \"I'm going next door to the Kurt Vonnegut review. Pipe smoking is encouraged over there.\" <br /> <br />And as Holmes left the room, suddenly the review stopped.<br />",
24        "rating": 3,
25        "shelving": {
26            "shelf": {
27                "name": "read",
28                "webUrl": "https://www.goodreads.com/review/list/1036930?shelf=read",
29                "__typename": "Shelf"
30            },
31            "taggings": [
32                {
33                    "tag": {
34                        "name": "sf-fantasy",
35                        "webUrl": "https://www.goodreads.com/review/list/1036930?shelf=sf-fantasy",
36                        "__typename": "Tag"
37                    },
38                    "__typename": "Tagging"
39                },
40                {
41                    "tag": {
42                        "name": "most-popular-reviews",
43                        "webUrl": "https://www.goodreads.com/review/list/1036930?shelf=most-popular-reviews",
44                        "__typename": "Tag"
45                    },
46                    "__typename": "Tagging"
47                }
48            ],
49            "webUrl": "https://www.goodreads.com/review/show/91338657",
50            "__typename": "Shelving"
51        },
52        "likeCount": 382,
53        "viewerHasLiked": null,
54        "commentCount": 68
55    },
56    ...
57]

🤝 Related Actors

Here are some other useful actors for social media and content analysis:

• 🎥 TikTok Videos Scraper - Extract comprehensive video metadata with advanced filtering capabilities
• 📱 TikTok LIVE Scraper - Gather real-time data from TikTok live streams
• 👥 TikTok Following Scraper - Extract detailed user information and relationships
• 🔵 Facebook Following Scraper - Analyze Facebook following relationships and profile details
• 📝 Reddit Posts Search Scraper - Extract rich post metadata and community engagement metrics
• 👻 Snapchat User Stories Scraper - Collect public Snapchat story content and metrics
• 🎯 Snapchat Spotlight Detail Scraper - Extract detailed Snapchat Spotlight video metadata
• 👥 VK Groups Scraper - Gather comprehensive VK group and community data
• 👤 VK People Scraper - Extract detailed VK user profile information
• 📸 Instagram Profile Scraper - Collect Instagram profile metrics and details
• 🖼️ Instagram Post Detail Scraper - Extract comprehensive Instagram post data
• 📊 Instagram Hashtag Scraper - Analyze Instagram hashtag trends and metrics
• 💬 Instagram Comments Scraper - Gather Instagram post comments and engagement
• 📱 Instagram Story Scraper - Extract Instagram story content and metrics
• 🔍 Instagram Location Search Scraper - Collect location-based Instagram content