search-books
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:
{
"query": "Harry Potter"
}
Response
200 Success
Returns a JSON object containing a list of books matching the search query.
{
"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 |
post/api/search/books
Request body
Response
OK