openapi.yaml

openapi: 3.0.1
info:
  title: YouTube Tutorial Plugin
  description: Plugin for finding relevant YouTube tutorials.
  version: 'v1'
servers:
  - url: example.com
paths:
  /api/tutorials:
    get:
      operationId: getTutorials
      summary: Get relevant tutorials.
      parameters:
        - in: query
          name: keywords
          schema:
            type: string
          description: Used to search YouTube for tutorial videos.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/getTutorialsResponse'
components:
  schemas:
    getTutorialsResponse:
      type: object
      properties:
        tutorials:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
                description: Video title.
              description:
                type: string
                description: Video description.
              link:
                type: string
                description: Video URL
              published_date:
                type: string
              length:
                type: string
              views:
                type: number
              thumbnail:
                type: string
                description: Static thumbnail URL for video.