> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/goodreads/series-seriesid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/goodreads/series-seriesid.mdx>

---

# Goodreads Series API

A series with its books in reading order.

`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.

## Request

- **Endpoint:** `GET /v1/goodreads/series/{seriesId}`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by series id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/series/seriesid/get)
- **Platform page:** [/platforms/goodreads](https://www.socialfetch.dev/platforms/goodreads)

## 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.
