Goodreads

List Goodreads author books

List the books of a Goodreads author, most popular first.

GET/v1/goodreads/authors/{authorId}/books
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
authorIdintegerrequiredpath

Goodreads author id: the number in the page URL, e.g. `153394`. A slug such as `153394.Suzanne_Collins` or the full URL also works.

≥ 1 · ≤ 2147483647

pageintegeroptionalquery

Page number, starting at 1. Pass `page.nextPage` from the previous response to get the next page. Default 1, at most 1000.

≥ 1 · ≤ 1000

Response fields
30

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no author has this id.

one of: found, not_found

The author; null when not found.

dataauthorid
integernullable

Author id.

dataauthorname
string

Author name.

dataauthorurl
stringnullable

Author page URL.

Books on this page, most popular first, 30 a page. Empty past the last page.

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.

Pagination state for the current page.

datapagepage
integer

Current page number.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number; null on the last page.

≥ 0

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/authors/153394/books" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Goodreads author books.