Goodreads Book Search API
The best matching books for a title, author or ISBN.
GET /v1/goodreads/search1 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.
Example response
A 200 response. Live responses have the same shape with current data.
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.
Other Goodreads endpoints
- BookGET /v1/goodreads/books/{bookId}
- Book reviewsGET /v1/goodreads/books/{bookId}/reviews
- Book editionsGET /v1/goodreads/books/{bookId}/editions
- Review commentsGET /v1/goodreads/reviews/comments
- SeriesGET /v1/goodreads/series/{seriesId}
- AuthorGET /v1/goodreads/authors/{authorId}
- Author booksGET /v1/goodreads/authors/{authorId}/books
- QuotesGET /v1/goodreads/quotes