Goodreads

Search Goodreads books

Search Goodreads books by title, author or ISBN and get the best matches.

GET/v1/goodreads/search
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

Title, author or ISBN to search for, e.g. `hunger games`. 1 to 200 characters.

min 1 chars · max 200 chars

Response fields
26

Endpoint-specific response payload.

dataquery
string

The query that was searched.

Best matching books, best first. Empty when nothing matches.

databooks[]id
integer

Book id (the number in `/book/show/{id}`).

databooks[]workId
integernullable

Work id shared by every edition, when shown.

databooks[]title
string

Title as the site shows it, with the series.

databooks[]url
string

Book page URL.

databooks[]cover
stringnullable

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

Authors named on the row.

databooks[]authors[]id
integernullable

Author id.

databooks[]authors[]name
string

Author name.

databooks[]authors[]url
stringnullable

Author page URL.

databooks[]averageRating
numbernullable

Average rating, 0 to 5.

databooks[]ratingsCount
integernullable

Number of ratings.

databooks[]publishedYear
integernullable

Year first published, when shown.

databooks[]editionsCount
integernullable

Number of editions, when shown.

databooks[]titleWithoutSeries
stringnullable

Title alone.

databooks[]pages
integernullable

Number of pages.

databooks[]rank
integernullable

Position in the results.

databooks[]description
stringnullable

Opening of the description, as plain text.

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/search?query=hunger%20games" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Goodreads book search results.