v21

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

similar-scraper

Similar Scraper

Scrapes similar and related book recommendations from a Goodreads book page using a direct book URL. Returns structured information about books that Goodreads recommends as similar reads.


Request

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

Headers

KeyValueDescription
Content-Typeapplication/jsonIndicates the request body is JSON

Body

FieldTypeRequiredDescription
queryURLstringYesThe full Goodreads book page URL to scrape similar books 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 a list of similar books scraped from the page.

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

Response Field Descriptions

FieldTypeDescription
statusstringHuman-readable status message
statusCodenumberHTTP status code of the response
similarBooksarrayList of similar/related books recommended on the page
post/api/similar-scraper

Request body

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

Response

OK

statusstring required
sourcestring uri required
scrapeURLstring uri required
lastScrapedstring date-time required