v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-15150454.0 KB

reviews-scraper

Reviews Scraper

Scrapes reader reviews for a book from a Goodreads book page using a direct book URL. Returns structured review data including reviewer details, ratings, and review text.

Request

Method: POST
URL: {{Instance Domain}}/api/reviews-scraper

Headers

Key	Value	Description
Content-Type	application/json	Indicates the request body is JSON

Body

Field	Type	Required	Description
queryURL	string	Yes	The full Goodreads book page URL to scrape reviews from (e.g. https://www.goodreads.com/book/show/5907)

Example Body:

{
  "queryURL": "https://www.goodreads.com/book/show/5907"
}

Response

200 Success

Returns a JSON object containing the scraped reviews for the specified book.

{
  "status": "Received",
  "statusCode": 200,
  ...
}

Response Field Descriptions

Field	Type	Description
status	string	Human-readable status message
statusCode	number	HTTP status code of the response
reviews	array	List of reader reviews, each with reviewer name, star rating, review text, and date

post/api/reviews-scraper

Request body

resourceIDstring required

{"stackTrail":"paths:/api/reviews-scraper:post:requestBody:content:application/json:schema:properties:legacyBookID","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/api/reviews-scraper:post:requestBody:content:application/json:schema:properties:nextPageToken","oasType":"schema","type":"unknown"}

Response

statusstring required

statusCodeinteger required

sourcestring uri required

scrapeURLstring uri required

totalCountinteger required

nextPageTokenstring required

prevPageTokenstring required

lastScrapedstring date-time required