search-books | BiblioReads

{
  "status": "Received",
  "source": "https://github.com/nesaku/biblioreads",
  "apiURL": "https://www.goodreads.com/book/auto_complete?format=json&q=powerless",
  "searchType": "books",
  "numberOfResults": "5 results",
  "result": [
    {
      "id": 1,
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1672676191i/75513900._SX50_.jpg",
      "title": "Powerless (The Powerless Trilogy, #1)",
      "bookURL": "/book/show/75513900-powerless",
      "author": "Lauren  Roberts",
      "authorURL": "/author/show/21728475.Lauren_Roberts",
      "rating": "4.14"
    },
    {
      "id": 2,
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1731714752i/183086339._SY75_.jpg",
      "title": "Reckless (The Powerless Trilogy, #2)",
      "bookURL": "/book/show/183086339-reckless",
      "author": "Lauren  Roberts",
      "authorURL": "/author/show/21728475.Lauren_Roberts",
      "rating": "4.07"
    },
    {
      "id": 3,
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1730330746i/214151222._SY75_.jpg",
      "title": "Fearless (The Powerless Trilogy, #3)",
      "bookURL": "/book/show/214151222-fearless",
      "author": "Lauren  Roberts",
      "authorURL": "/author/show/21728475.Lauren_Roberts",
      "rating": "4.04"
    },
    {
      "id": 4,
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1731714728i/203840597._SY75_.jpg",
      "title": "Powerful (The Powerless Trilogy, #1.5)",
      "bookURL": "/book/show/203840597-powerful",
      "author": "Lauren  Roberts",
      "authorURL": "/author/show/21728475.Lauren_Roberts",
      "rating": "4.11"
    },
    {
      "id": 5,
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1684209496i/125195303._SY75_.jpg",
      "title": "Powerless (Chestnut Springs, #3)",
      "bookURL": "/book/show/125195303-powerless",
      "author": "Elsie Silver",
      "authorURL": "/author/show/21312387.Elsie_Silver",
      "rating": "4.03"
    }
  ],
  "lastScraped": "2026-06-15T00:42:08Z"
}

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

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

sourcestringformat: "uri"

apiURLstringformat: "uri"

searchTypestring

numberOfResultsstring

resultlist of objects

lastScrapeddatetime