v21

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

author-books-scraper

Author Books Scraper

Scrapes the list of books written by a specific Goodreads author using a direct author books page URL. Returns structured metadata for all books listed on the author's Goodreads profile.


Request

Method: POST
URL: {{Instance Domain}}/api/author/books

Headers

KeyValueDescription
Content-Typeapplication/jsonIndicates the request body is JSON

Body

FieldTypeRequiredDescription
queryURLstringYesThe full Goodreads author books list URL to scrape (e.g. https://www.goodreads.com/author/list/1077326.J_K_Rowling)

Example Body:

{
  "queryURL": "https://www.goodreads.com/author/list/1077326.J_K_Rowling"
}

Response

200 Success

Returns a JSON object containing the list of books by the specified author.

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

Response Field Descriptions

FieldTypeDescription
statusstringHuman-readable status message
statusCodenumberHTTP status code of the response
authorstringName of the author whose books were scraped
booksarrayList of books by the author, each with title, cover image, rating, and Goodreads URL
post/api/author/books

Request body

pageinteger required
queryURLstring uri required

Response

OK

statusstring required
sourcestring uri required
scrapeURLstring uri required
titlestring required
descstring required
nextPagestring required
lastScrapedstring date-time required
All 15 operations