# Goodreads Series API (https://www.socialcrawl.dev/platforms/goodreads/series)

> Returns the books of one Goodreads series in reading order, each with its position, rating and counts, plus the series' title and description in data.series.

TL;DR: `GET /v1/goodreads/series` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | The Goodreads series id, for example 66175. Send id or url. |
| `url` | no | A Goodreads series link. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/goodreads/series" \
  --data-urlencode "id=66175" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a book series in reading order?

Call GET /v1/goodreads/series and send id or url. The id is the series id such as 66175, and the url is a Goodreads series link.

### What does the Goodreads series endpoint return?

It returns the books of the series in reading order, each with its position, rating and counts, plus the series title and description in data.series.

### Where do I find the series id?

In the Goodreads series link, or send the link itself as url.

### Does the series list have more pages?

No. A series is returned whole in one call, so there is no cursor to follow.

### How much does this Goodreads endpoint cost?

Each call costs 1 credit on the standard tier. There is no subscription, and 100 free credits cover 100 calls.

See the full Goodreads API: https://www.socialcrawl.dev/platforms/goodreads

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get the reading order of a book series with an API?
- What does the Goodreads series endpoint return?