Search Goodreads books
Search Goodreads books by title, author or ISBN and get the best matches.
Headers
Get your API keyAPI key (`sfk_...`)
Title, author or ISBN to search for, e.g. `hunger games`. 1 to 200 characters.
min 1 chars · max 200 chars
Endpoint-specific response payload.
The query that was searched.
Best matching books, best first. Empty when nothing matches.
Book id (the number in `/book/show/{id}`).
Work id shared by every edition, when shown.
Title as the site shows it, with the series.
Book page URL.
Cover image URL. Link only; not hosted by Social Fetch.
Authors named on the row.
Author id.
Author name.
Author page URL.
Average rating, 0 to 5.
Number of ratings.
Year first published, when shown.
Number of editions, when shown.
Title alone.
Number of pages.
Position in the results.
Opening of the description, as plain text.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/goodreads/search?query=hunger%20games" \
-H "x-api-key: YOUR_API_KEY"Responses
Goodreads book search results.