Get Goodreads series
Get a Goodreads series with its books in reading order.
Headers
Get your API keyAPI key (`sfk_...`)
Goodreads series id: the number in the page URL, e.g. `73758`. A slug such as `73758-the-hunger-games` or the full URL also works.
≥ 1 · ≤ 2147483647
Page number, starting at 1. Pass `page.nextPage` from the previous response to get the next page. Default 1, at most 100.
≥ 1 · ≤ 100
Endpoint-specific response payload.
`not_found` when no series has this id.
one of: found, not_found
The series when found; otherwise null.
Series id.
Series title.
Series page URL.
Description as plain text.
Numbered works in the series.
Every work in the series, numbered or not.
Books on this page in reading order, 100 a page.
Book id (the number in `/book/show/{id}`).
Work id shared by every edition, when shown.
Title as the site shows it, with the series.
Book page URL.
Cover image URL. Link only; not hosted by Social Fetch.
Authors named on the row.
Author id.
Author name.
Author page URL.
Average rating, 0 to 5.
Number of ratings.
Year first published, when shown.
Number of editions, when shown.
Place in the series, e.g. `1`, `0.5` or `1-3`; null when unnumbered.
Title alone.
Number of pages.
Text reviews.
Description as plain text.
Pagination state for the current page.
Current page number.
≥ 0
Whether another page is available.
Next page number; null on the last page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/goodreads/series/73758" \
-H "x-api-key: YOUR_API_KEY"Responses
Goodreads series.