Greenlit Books Topics API

openapi: 3.2.0
info:
  title: Greenlit Books Topics API
  version: 1.2.0
  description: 'Public read-only JSON API for the Greenlit Books catalog: practical books on working with AI, all live on Amazon and free to read with Kindle Unlimited. Every endpoint is a plain HTTP GET returning pretty-printed JSON with a meta envelope. Amazon links are clean /dp/ URLs. The catalog intentionally omits publication dates, page counts, and ISBNs because it carries no verified source for them; nothing is invented. Human documentation: https://greenlitbooks.com/developers'
  contact:
    name: Greenlit Books
    url: https://greenlitbooks.com
servers:
- url: https://greenlitbooks.com/api/v1
security: []
tags:
- name: Topics
paths:
  /topics:
    get:
      operationId: listTopics
      summary: Curated topics mapped to the books that cover them
      description: '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.'
      responses:
        '200':
          description: The topic list
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta'
                  count:
                    type: integer
                  topics:
                    type: array
                    items:
                      $ref: '#/components/schemas/Topic'
      tags:
      - Topics
components:
  schemas:
    BookLink:
      type: object
      description: Compact pointer to a book, with its reading-order position in its series.
      properties:
        slug:
          type: string
        title:
          type: string
        position:
          type: integer
          description: 1-based reading order within the series.
        url:
          type: string
          format: uri
        apiUrl:
          type: string
          format: uri
    Topic:
      type: object
      description: A curated topic with the catalog resources that cover it.
      properties:
        slug:
          type: string
        name:
          type: string
        aliases:
          type: array
          items:
            type: string
          description: Phrases people use to reach this topic.
        description:
          type: string
        books:
          type: array
          items:
            $ref: '#/components/schemas/BookLink'
        guide:
          type:
          - object
          - 'null'
          description: The reading guide covering this topic, when one exists.
          properties:
            title:
              type: string
            slug:
              type: string
            url:
              type: string
              format: uri
        series:
          type:
          - object
          - 'null'
          description: The series dedicated to this topic, when one exists.
          properties:
            name:
              type: string
            slug:
              type: string
            url:
              type: string
              format: uri
            apiUrl:
              type: string
              format: uri
    Meta:
      type: object
      description: Envelope on every response.
      properties:
        version:
          type: string
          const: v1
        generatedAt:
          type: string
          format: date-time
          description: When this snapshot was produced. Static endpoints stamp it at deploy; search stamps it per request.
        source:
          type: string
          format: uri
        docs:
          type: string
          format: uri
        openapi:
          type: string
          format: uri
externalDocs:
  description: Human documentation, the MCP server, and the markdown surfaces for agents
  url: https://greenlitbooks.com/developers