CutLuma Public API

openapi: 3.2.0
info:
  title: CutLuma Public API
  version: 1.1.0
  summary: 'Read-only endpoints for assistants and agents: search CutLuma''s tools, guides and templates, read pages as Markdown, look up pricing and shared videos.'
  description: 'CutLuma (https://cutluma.com) is a free online video editor that runs in the browser. No API key is needed for anything described here. Agents that speak MCP can use https://cutluma.com/mcp instead (same data, with tool schemas). Every content page is also available as Markdown by appending .md to its path or sending Accept: text/markdown.'
  termsOfService: https://cutluma.com/terms
  contact:
    url: https://cutluma.com/
servers:
- url: https://cutluma.com
tags:
- name: Public
paths:
  /api/public/catalog:
    get:
      summary: Site catalog
      operationId: catalog
      description: Every free tool, use-case page, guide and template with titles, descriptions and links.
      responses:
        '200':
          description: Catalog
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
  /api/public/search:
    get:
      summary: Search the site
      operationId: search
      parameters:
      - name: q
        in: query
        description: What the user wants to do or find
        schema:
          type: string
      - name: kind
        in: query
        description: Restrict to one type
        schema:
          type: string
          enum:
          - all
          - tool
          - use
          - guide
          - template
      - name: limit
        in: query
        description: Max results (1-50)
        schema:
          type: integer
      responses:
        '200':
          description: Matches with url, markdown and open links
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
  /api/public/templates:
    get:
      summary: Find video templates
      operationId: templates
      parameters:
      - name: q
        in: query
        description: Keywords
        schema:
          type: string
      - name: format
        in: query
        description: Aspect ratio
        schema:
          type: string
          enum:
          - '9:16'
          - '1:1'
          - '4:5'
          - '16:9'
      - name: category
        in: query
        description: Category name
        schema:
          type: string
      - name: arabic
        in: query
        description: 1 for Arabic right-to-left templates only
        schema:
          type: string
      - name: language
        in: query
        description: 'Two-letter code (en, zh, hi, es, ar, fr, bn, pt, ru, id, ur, de, ja, tr, ko): only templates written in that language'
        schema:
          type: string
      - name: limit
        in: query
        description: Max results (1-100)
        schema:
          type: integer
      responses:
        '200':
          description: Templates with an "open" link that loads each one in the editor
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
  /api/public/plans:
    get:
      summary: Plans and prices
      operationId: plans
      responses:
        '200':
          description: Active plans
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
  /api/public/playbooks:
    get:
      summary: Video business playbooks
      operationId: playbooks
      description: 'The series of researched guides on earning money with video: each part with its business model, key facts, takeaways and links. Figures are published ranges and worked examples, not promises of income.'
      parameters:
      - name: topic
        in: query
        description: 'Optional: only the parts that match, e.g. clipping, UGC, podcast'
        schema:
          type: string
      responses:
        '200':
          description: Parts of the series
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
  /api/public/sizes:
    get:
      summary: Video sizes per platform
      operationId: sizes
      parameters:
      - name: platform
        in: query
        description: Optional filter such as tiktok or youtube
        schema:
          type: string
      responses:
        '200':
          description: Aspect ratios and recommended pixel sizes
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
  /api/public/editor-link:
    get:
      summary: Build an editor link
      operationId: editorLink
      description: A URL that opens the editor with a tool or template ready for the user.
      parameters:
      - name: tool
        in: query
        description: Editor tool
        schema:
          type: string
          enum:
          - captions
          - record
          - resize
          - silence
          - shorts
          - product
          - testimonials
          - trim
          - text
          - music
          - montage
          - camera
          - voice
          - speed
          - tts
          - translate
          - greenscreen
          - cutout
          - prompter
          - stock
          - textvideo
          - magicdesign
          - aiimage
          - bgremove
          - magicedit
          - visualizer
          - charts
          - industry
          - effects
          - translatedesign
          - localize
          - transcript
          - dub
          - publish
          - present
          - open
          - subtitles
          - textbehind
          - tracking
          - subjectfx
          - colorchange
          - freezeintro
          - guide
          - hub
          - narration
          - agent
          - grade
          - styles
          - mixer
          - multicam
      - name: template
        in: query
        description: Template id
        schema:
          type: string
      - name: language
        in: query
        description: Two-letter caption language
        schema:
          type: string
      responses:
        '200':
          description: url + note
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
  /api/public/{token}:
    get:
      summary: Shared video details
      operationId: sharedVideo
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
        description: The v= value of a share link
      responses:
        '200':
          description: Name, kind, size, duration and media URLs
          content:
            application/json:
              schema:
                type: object
      tags:
      - Public
externalDocs:
  description: llms.txt
  url: https://cutluma.com/llms.txt
x-mcp:
  url: https://cutluma.com/mcp
  transport: streamable-http
  authentication: none for the read-only tools; OAuth 2.1 or an agent key for the account tools
  card: https://cutluma.com/.well-known/mcp.json