Goodreads hub

Goodreads Book Search API

The best matching books for a title, author or ISBN.

GET /v1/goodreads/search

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

About this endpoint

GET /v1/goodreads/search?query= returns the books that best match a title, an author or an ISBN, best first: id, workId, title, titleWithoutSeries, url, cover, authors, pages, averageRating, ratingsCount, rank and the opening of the description. Use the id with the book, reviews and editions routes. An empty books array means nothing matched.

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 Book Search API FAQ

How many results does a search return?

The top matches only, typically 5 to 10. It is meant to find the right book id, not to page through a catalogue.

Can I search by ISBN?

Yes. Send the ISBN-10 or ISBN-13 as query; the edition it names comes back first when the site knows it.

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.

Does search work in other scripts?

Yes. Titles in Japanese, Cyrillic or any other script are searched as sent.