Goodreads

Search Goodreads books

Searches Goodreads for books by title or author using q, returning up to limit results (default 10, max 50). Each result has its id, title, author and author id, average rating, ratings count, page count, a truncated description, cover image URL and Goodreads URL. Only books are returned, not authors or lists.

get/goodreads/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/goodreads/search
  • Auth: API key in header x-api-key

Query parameters

qstring required

Search query

limitinteger

Max results, default 10, max 50

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "results": [
      {
        "average_rating": 4.35
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.