author-books-scraper

View as Markdown
## 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 | Key | Value | Description | | --- | --- | --- | | Content-Type | application/json | Indicates the request body is JSON | ### Body | Field | Type | Required | Description | | --- | --- | --- | --- | | queryURL | string | Yes | The full Goodreads author books list URL to scrape (e.g. `https://www.goodreads.com/author/list/1077326.J_K_Rowling`) | **Example Body:** ```json { "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. ```json { "status": "Received", "statusCode": 200, ... } ``` ### Response Field Descriptions | Field | Type | Description | | --- | --- | --- | | status | string | Human-readable status message | | statusCode | number | HTTP status code of the response | | author | string | Name of the author whose books were scraped | | books | array | List of books by the author, each with title, cover image, rating, and Goodreads URL |

Request

This endpoint expects an object.
pageintegerRequired
queryURLstringRequiredformat: "uri"

Response

OK
statusstring
sourcestringformat: "uri"
scrapeURLstringformat: "uri"
titlestring
descstring
bookslist of objects
nextPagestring
lastScrapeddatetime