Goodreads hub

Goodreads Author API

One author with biography, reach and their most popular books.

GET /v1/goodreads/authors/{authorId}

1 credit Failed requests are free A not-found answer is still charged

About this endpoint

GET /v1/goodreads/authors/{authorId} takes the number from the author URL, for example 153394 for Suzanne Collins (153394.Suzanne_Collins also works). On found, data.author carries id, name, url, image, bornAt, birthPlace, diedAt, website, genres, influences, bio, followers, averageRating, ratingsCount, reviewCount, worksCount, topBooks and series. bornAt and diedAt are ISO dates (1962-08-11). Use the author books route for the complete list.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Goodreads Author API FAQ

Which inputs does the author route take?

The author id from the Goodreads URL, the id with its name slug, or the full author URL.

What format are bornAt and diedAt in?

ISO 8601 dates, with only the parts the site gives: 1962-08-11 for a full date, 1850-03 or 1850 when the site shows only a month or a year. Null when not given.

How many credits does a call cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

What does lookupStatus mean here?

found means data.author is the author. not_found means no author has this id.