---
title: "List curated Goodreads Listopia lists"
method: GET
path: "/goodreads/lists"
tags: ["Goodreads"]
---

# List curated Goodreads Listopia lists

`GET /goodreads/lists`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/goodreads/lists`
- Auth: API key in header `x-api-key`

Returns a catalog of well-known Goodreads Listopia lists (id, name, category). Goodreads has no directory or search endpoint for the tens of thousands of user-created lists, so this is served from a live popular-lists source when available, falling back to a curated, hand-picked catalog otherwise. Pass a returned id to GET /goodreads/list/{id} for that list's ranked book contents. Category enum: `general`, `genre`, `era`, `young_adult`, `children`, `holiday`.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoodreadsListsResponseDoc
  - `code` integer
  - `data` GoodreadsListsResponse
    - `lists` GoodreadsListDirectoryItem[]
      - `category` string
      - `id` string
      - `name` string
  - `msg` string

## Other responses

- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)