Goodreads

Get Goodreads book

Get a Goodreads book with its authors, series, genres, ratings, awards and edition details.

GET/v1/goodreads/books/{bookId}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
bookIdintegerrequiredpath

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

Response fields
69

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no book has this id.

one of: found, not_found

The book when found; otherwise null.

databookid
integer

Book id.

databookworkId
integernullable

Work id shared by every edition.

databookurl
string

Book page URL.

databooktitle
string

Title without the series.

databookfullTitle
stringnullable

Title with the series, as the page heading shows it.

databookoriginalTitle
stringnullable

Title of the original work.

databookdescription
stringnullable

Description as plain text, paragraphs separated by blank lines.

databookdescriptionHtml
stringnullable

Description with the site's own formatting (HTML).

databookcover
stringnullable

Cover image URL. Link only; not hosted by Social Fetch.

Credited people, the main author first.

databookauthors[]id
integernullable

Author id.

databookauthors[]name
string

Name.

databookauthors[]url
stringnullable

Author page URL.

databookauthors[]role
stringnullable

Credit, e.g. `Author`, `Translator`, `Illustrator`.

databookauthors[]isGoodreadsAuthor
booleannullable

Whether the author runs a Goodreads author profile.

databookauthors[]image
stringnullable

Photo URL, for the main author. Link only.

databookauthors[]followers
integernullable

Followers, for the main author.

databookauthors[]worksCount
integernullable

Distinct works, for the main author.

Series the book belongs to.

databookseries[]title
string

Series title.

databookseries[]url
stringnullable

Series page URL.

databookseries[]id
integernullable

Series id.

databookseries[]position
stringnullable

Place in the series, e.g. `1` or `0.5`.

Top shelved genres, most shelved first.

databookgenres[]name
string

Genre.

databookgenres[]url
stringnullable

Genre page URL.

databookformat
stringnullable

Format, e.g. `Hardcover`.

databookpages
integernullable

Number of pages.

databookpublisher
stringnullable

Publisher of this edition.

databookpublishedAt
stringnullable

Publication date of this edition, ISO 8601.

databookfirstPublishedAt
stringnullable

First publication date of the work, ISO 8601.

databooklanguage
stringnullable

Language of this edition.

databookisbn
stringnullable

ISBN-10.

databookisbn13
stringnullable

ISBN-13.

databookasin
stringnullable

Amazon ASIN.

Ratings summary.

databookratingaverage
numbernullable

Average rating, 0 to 5.

databookratingcount
integernullable

Number of ratings.

databookratingreviewCount
integernullable

Number of text reviews.

Ratings per star, 1 star first and 5 stars last.

databookratingdistribution[]
integeroptional

Text reviews per language.

databookratingreviewsByLanguage[]language
string

ISO 639 language code.

databookratingreviewsByLanguage[]count
integer

Text reviews in it.

Literary awards.

databookawards[]name
string

Award.

databookawards[]url
stringnullable

Award page URL.

databookawards[]category
stringnullable

Category.

databookawards[]year
integernullable

Year.

databookawards[]designation
stringnullable

`WINNER` or `NOMINEE`, as the site marks it.

Settings.

databookplaces[]name
string

Setting.

databookplaces[]country
stringnullable

Country.

databookplaces[]url
stringnullable

Place page URL.

databookplaces[]year
integernullable

Year, when given.

Characters.

databookcharacters[]name
string

Character.

databookcharacters[]url
stringnullable

Character page URL.

databookquotesCount
integernullable

Quotes saved from the work.

databookquestionsCount
integernullable

Reader questions about the work.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.