Goodreads

Get Goodreads author

Get a Goodreads author with their biography, ratings, followers and popular books.

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

API key (`sfk_...`)

Parameters
1
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

Response fields
47

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no author has this id.

one of: found, not_found

The author when found; otherwise null.

dataauthorid
integer

Author id.

dataauthorname
string

Name.

dataauthorurl
string

Author page URL.

dataauthorimage
stringnullable

Photo URL. Link only; not hosted by Social Fetch.

dataauthorbornAt
stringnullable

Date of birth, ISO 8601 with only the parts the site gives: `1962-08-11`, or `1850-03` or `1850`.

dataauthorbirthPlace
stringnullable

Place of birth.

dataauthordiedAt
stringnullable

Date of death, ISO 8601 with only the parts the site gives: `1881-02-09`, or `1850-03` or `1850`.

dataauthorwebsite
stringnullable

Personal website.

Genres the author writes in.

dataauthorgenres[]
stringoptional

Authors named as influences.

dataauthorinfluences[]id
integernullable

Author id.

dataauthorinfluences[]name
string

Author name.

dataauthorinfluences[]url
stringnullable

Author page URL.

dataauthorbio
stringnullable

Biography as plain text.

dataauthorfollowers
integernullable

Followers.

dataauthoraverageRating
numbernullable

Average rating across their books, 0 to 5.

dataauthorratingsCount
integernullable

Ratings of their books.

dataauthorreviewCount
integernullable

Text reviews of their books.

dataauthorworksCount
integernullable

Distinct works.

Most popular books, as the author page lists them.

dataauthortopBooks[]id
integer

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

dataauthortopBooks[]workId
integernullable

Work id shared by every edition, when shown.

dataauthortopBooks[]title
string

Title as the site shows it, with the series.

dataauthortopBooks[]url
string

Book page URL.

dataauthortopBooks[]cover
stringnullable

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

Authors named on the row.

dataauthortopBooks[]authors[]id
integernullable

Author id.

dataauthortopBooks[]authors[]name
string

Author name.

dataauthortopBooks[]authors[]url
stringnullable

Author page URL.

dataauthortopBooks[]averageRating
numbernullable

Average rating, 0 to 5.

dataauthortopBooks[]ratingsCount
integernullable

Number of ratings.

dataauthortopBooks[]publishedYear
integernullable

Year first published, when shown.

dataauthortopBooks[]editionsCount
integernullable

Number of editions, when shown.

Series the author page lists.

dataauthorseries[]id
integernullable

Series id.

dataauthorseries[]title
string

Series title.

dataauthorseries[]url
stringnullable

Series page URL.

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

Responses

Goodreads author.