---
title: "Curated topics mapped to the books that cover them"
method: GET
path: "/topics"
---

# Curated topics mapped to the books that cover them

`GET /topics`

## Request

- Base URL: `https://greenlitbooks.com/api/v1`
- URL: `https://greenlitbooks.com/api/v1/topics`
- Auth: none required

A curated topic layer: each topic carries the phrases people use for it, a short description, and the books, guide, and series that cover it. Use this to answer whether the catalog covers a subject in one call.

## Response `200`

The topic list

- object
  - `meta` Meta: Envelope on every response.
    - `version` 'v1'
    - `generatedAt` string, date-time: When this snapshot was produced. Static endpoints stamp it at deploy; search stamps it per request.
    - `source` string, uri
    - `docs` string, uri
    - `openapi` string, uri
  - `count` integer
  - `topics` Topic[]
    - `slug` string
    - `name` string
    - `aliases` string[]: Phrases people use to reach this topic.
    - `description` string
    - `books` BookLink[]
      - `slug` string
      - `title` string
      - `position` integer: 1-based reading order within the series.
      - `url` string, uri
      - `apiUrl` string, uri
    - `guide` object, nullable: The reading guide covering this topic, when one exists.
      - `title` string
      - `slug` string
      - `url` string, uri
    - `series` object, nullable: The series dedicated to this topic, when one exists.
      - `name` string
      - `slug` string
      - `url` string, uri
      - `apiUrl` string, uri

---

[API](https://skmtc.dev/greenlitbooks/apis/greenlit-books-api.md) · [All operations](https://skmtc.dev/greenlitbooks/apis/greenlit-books-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greenlitbooks/apis/greenlit-books-api/revisions/7c8b9f94ca1e?raw)