search-books

View as Markdown
## Search Books Searches Goodreads for books matching a given query string. Returns a list of matching books with their metadata, useful for discovering books by title, author, or keyword. --- ## Request **Method:** `POST` **URL:** `{{Instance Domain}}/api/search/books` ### Headers | Key | Value | Description | | --- | --- | --- | | Content-Type | application/json | Indicates the request body is JSON | ### Body | Field | Type | Required | Description | | --- | --- | --- | --- | | query | string | Yes | The search term to look up on Goodreads (e.g. `"Harry Potter"`) | **Example Body:** ```json { "query": "Harry Potter" } ``` --- ## Response ### 200 Success Returns a JSON object containing a list of books matching the search query. ```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 | | results | array | List of books matching the search query, each with title, author, cover image, and Goodreads URL |

Request

This endpoint expects an object.
queryURLstringRequiredformat: "uri"

Response

OK
statusstring
sourcestringformat: "uri"
apiURLstringformat: "uri"
searchTypestring
numberOfResultsstring
resultlist of objects
lastScrapeddatetime