Greenlit Books Series API

openapi: 3.2.0
info:
  title: Greenlit Books Series 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: Series
paths:
  /series:
    get:
      operationId: listSeries
      summary: All series, plus imprints
      description: 'Every series with its ordered book list, plus an imprints aggregate. Imprints are a separate axis: one imprint can span several series and has no page of its own.'
      responses:
        '200':
          description: The series list
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta'
                  count:
                    type: integer
                  series:
                    type: array
                    items:
                      $ref: '#/components/schemas/Series'
                  imprints:
                    type: array
                    items:
                      $ref: '#/components/schemas/Imprint'
      tags:
      - Series
  /series/{slug}:
    get:
      operationId: getSeries
      summary: One series with its books in reading order
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          enum:
          - the-operators-ai-library
          - the-ai-native-builder-canon
          - understand-and-trust-ai
          - build-agents-you-can-trust
          - lead-govern-and-apply-ai
          - ai-and-agentic-engineering
          - the-claude-code-ladder
          - the-agent-builders-workshop
          - the-two-doors
          - forward-deployed-engineering-handbooks
          - the-complete-grok-bot-guide
          - the-omarchy-books
          - the-personal-ai-computer
        example: the-claude-code-ladder
      responses:
        '200':
          description: The series
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta'
                  series:
                    $ref: '#/components/schemas/Series'
        '404':
          description: Unknown slug
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Series
components:
  schemas:
    Series:
      type: object
      properties:
        name:
          type: string
        slug:
          type: string
        tier:
          type: string
          description: Short audience label.
        blurb:
          type: string
        order:
          type: integer
          description: Curated shelf order.
        count:
          type: integer
        url:
          type: string
          format: uri
        apiUrl:
          type: string
          format: uri
        books:
          type: array
          items:
            $ref: '#/components/schemas/BookLink'
    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
    Imprint:
      type: object
      description: An imprint groups books across one or more series.
      properties:
        name:
          type: string
        count:
          type: integer
        series:
          type: array
          items:
            type: string
          description: Slugs of the series this imprint spans.
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              examples:
              - not_found
              - missing_query
            message:
              type: string
        meta:
          $ref: '#/components/schemas/Meta'
    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
externalDocs:
  description: Human documentation, the MCP server, and the markdown surfaces for agents
  url: https://greenlitbooks.com/developers