Goodreads Series API
A series with its books in reading order.
GET /v1/goodreads/series/{seriesId}1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/goodreads/series/{seriesId} takes the number from the series URL, for example 73758 for The Hunger Games. On found, data.series carries id, title, url, description, primaryWorksCount, totalWorksCount and books in reading order, each with position (1, 0.5 or 1-3; null for an unnumbered companion), id, workId, title, titleWithoutSeries, url, cover, authors, averageRating, ratingsCount, reviewCount, pages, publishedYear, editionsCount and description. 100 books a page.
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 Series API FAQ
Why is position null on some books?
Companions, box sets and guides that the site lists without a number come back with position null.
Do long series page?
Yes, 100 books a page. Follow page.nextPage while page.hasMore is true.
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.series is the series. not_found means no series has this id.
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
- Book searchGET /v1/goodreads/search
- AuthorGET /v1/goodreads/authors/{authorId}
- Author booksGET /v1/goodreads/authors/{authorId}/books
- QuotesGET /v1/goodreads/quotes