Get Goodreads book
Get a Goodreads book with its authors, series, genres, ratings, awards and edition details.
Headers
Get your API keyAPI key (`sfk_...`)
Goodreads book id: the number in the page URL, e.g. `2767052`. A slug such as `2767052-the-hunger-games` or the full URL also works.
≥ 1 · ≤ 2147483647
Endpoint-specific response payload.
`not_found` when no book has this id.
one of: found, not_found
The book when found; otherwise null.
Book id.
Work id shared by every edition.
Book page URL.
Title without the series.
Title with the series, as the page heading shows it.
Title of the original work.
Description as plain text, paragraphs separated by blank lines.
Description with the site's own formatting (HTML).
Cover image URL. Link only; not hosted by Social Fetch.
Credited people, the main author first.
Author id.
Name.
Author page URL.
Credit, e.g. `Author`, `Translator`, `Illustrator`.
Whether the author runs a Goodreads author profile.
Photo URL, for the main author. Link only.
Followers, for the main author.
Distinct works, for the main author.
Series the book belongs to.
Series title.
Series page URL.
Series id.
Place in the series, e.g. `1` or `0.5`.
Top shelved genres, most shelved first.
Genre.
Genre page URL.
Format, e.g. `Hardcover`.
Number of pages.
Publisher of this edition.
Publication date of this edition, ISO 8601.
First publication date of the work, ISO 8601.
Language of this edition.
ISBN-10.
ISBN-13.
Amazon ASIN.
Ratings summary.
Average rating, 0 to 5.
Number of ratings.
Number of text reviews.
Ratings per star, 1 star first and 5 stars last.
Text reviews per language.
ISO 639 language code.
Text reviews in it.
Literary awards.
Award.
Award page URL.
Category.
Year.
`WINNER` or `NOMINEE`, as the site marks it.
Settings.
Setting.
Country.
Place page URL.
Year, when given.
Characters.
Character.
Character page URL.
Quotes saved from the work.
Reader questions about the work.
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/books/2767052" \
-H "x-api-key: YOUR_API_KEY"Responses
Goodreads book.