← Back to marketplace

Goodreads

Fast JSON API for Goodreads book data - book details by id or ISBN, similar books, series, genres, Listopia lists, quotes, Choice Awards, plus book, list, quote, group and people search.

media
by Mark821 endpoints100% uptime267ms avg

Includes 100 free calls per month

After the free quota, standard per-request pricing applies via x402 (USDC on Base).

Endpoints

GET/v1/book
$0.0010/req

Returns details about a single book: authors, series, genres, characters, edition data, buy links, ratings distribution and reader counts.

GET/v1/book/isbn
$0.0010/req

Returns details about a single book looked up by its ISBN. The response is identical to the one of /v1/book.

GET/v1/book/similar
$0.0010/req

Returns the books similar to a given book.

GET/v1/choice-awards/books
$0.0010/req

Returns the nominated books of a single Goodreads Choice Awards category, together with their votes and the winner flag.

GET/v1/choice-awards/categories
$0.0010/req

Returns the Goodreads Choice Awards categories of a single year.

GET/v1/genre
$0.0010/req

Returns details about a single genre, including its related genres.

GET/v1/genre/most-read
$0.0010/req

Returns the most read books in a genre.

GET/v1/genre/new-releases
$0.0010/req

Returns the books newly released in a genre.

GET/v1/genres
$0.0010/req

Returns the Goodreads genres together with pagination info.

GET/v1/list/books
$0.0010/req

Returns the books of a single book list, ranked, together with their score and votes and pagination info.

GET/v1/list/tags
$0.0010/req

Returns the popular book list tags.

GET/v1/lists/most-popular
$0.0010/req

Returns the most popular Listopia book lists together with pagination info.

GET/v1/lists/tag
$0.0010/req

Returns the book lists of a single tag together with pagination info.

GET/v1/quote/tags
$0.0010/req

Returns the popular quote tags together with the number of quotes in each.

GET/v1/quotes/tag
$0.0010/req

Returns the quotes of a single tag together with pagination info.

GET/v1/search/books
$0.0010/req

Returns the books matching a search term (title or author), together with pagination info. The returned book id can be used on /v1/book, the work id on /v1/book/similar.

GET/v1/search/groups
$0.0010/req

Returns the reader groups matching a search term, together with their member count, last activity and location and pagination info.

GET/v1/search/lists
$0.0010/req

Returns the Listopia book lists matching a search term, together with pagination info. The returned list slug can be used on /v1/list/books.

GET/v1/search/people
$0.0010/req

Returns the members matching a search term, together with their book and friend counts, location, currently read book and pagination info.

GET/v1/search/quotes
$0.0010/req

Returns the quotes matching a search term, together with their author, book, likes, tags and pagination info.

GET/v1/series
$0.0010/req

Returns the details of a single series together with its books in reading order. Every book carries its position in the series (e.g. "Book 1"), the primary works come first, followed by the remaining ones.

Quick start

Easiest way: the APIHub CLI. Credits cover x402, no wallet needed.

# install and set up once
npx @apihubio/cli register
npx @apihubio/cli topup 10

# call this service
npx @apihubio/cli call -X GET "https://proxy.apihub.io/goodreads/v1/book?id=2767052"

Or call the proxy directly (curl / any HTTP client):

curl https://proxy.apihub.io/goodreads/v1/book?id=2767052 \
  -H "Authorization: Bearer ahk_your_key"

# If credits available: charged automatically, returns 200
# Otherwise: returns 402 (pay via @x402/fetch or top up credits)

Pricing calculator

Estimate your monthly cost for Goodreads.

GET /v1/book$0.0010/req
-
GET /v1/book/isbn$0.0010/req
-
GET /v1/book/similar$0.0010/req
-
GET /v1/choice-awards/books$0.0010/req
-
GET /v1/choice-awards/categories$0.0010/req
-
GET /v1/genre$0.0010/req
-
GET /v1/genre/most-read$0.0010/req
-
GET /v1/genre/new-releases$0.0010/req
-
GET /v1/genres$0.0010/req
-
GET /v1/list/books$0.0010/req
-
GET /v1/list/tags$0.0010/req
-
GET /v1/lists/most-popular$0.0010/req
-
GET /v1/lists/tag$0.0010/req
-
GET /v1/quote/tags$0.0010/req
-
GET /v1/quotes/tag$0.0010/req
-
GET /v1/search/books$0.0010/req
-
GET /v1/search/groups$0.0010/req
-
GET /v1/search/lists$0.0010/req
-
GET /v1/search/people$0.0010/req
-
GET /v1/search/quotes$0.0010/req
-
GET /v1/series$0.0010/req
-