> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magicmealkits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get YouTube video metadata

> Returns title, author, thumbnails, channel info, and counts for a video. Identify it by either `video_url` or `video_id`. **Pro license required** — a Basic key returns `403` with `Pro account required`. This route is rate limited.



## OpenAPI

````yaml /api-reference/youtube/openapi.json post /youtube/metadata
openapi: 3.1.0
info:
  title: Magic Meal Kits — YouTube API
  version: 1.0.0
  description: >-
    Pull a YouTube video's transcript (and optional metadata) in the format your
    automation needs. Backs the **MMK YouTube Transcript** Make.com app.
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
  - url: https://{deployment}/api/v1
    description: Your Magic Meal Kits deployment
    variables:
      deployment:
        default: magic-meal-kits-xxxxx.run.app
        description: Your Cloud Run host (without protocol)
security:
  - ApiKeyAuth: []
tags:
  - name: Transcript
    description: Fetch a video transcript.
  - name: Metadata
    description: Fetch video metadata.
paths:
  /youtube/metadata:
    post:
      tags:
        - Metadata
      summary: Get YouTube video metadata
      description: >-
        Returns title, author, thumbnails, channel info, and counts for a video.
        Identify it by either `video_url` or `video_id`. **Pro license
        required** — a Basic key returns `403` with `Pro account required`. This
        route is rate limited.
      operationId: getVideoMetadata
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MetadataRequest'
            example:
              video_id: dQw4w9WgXcQ
      responses:
        '200':
          description: Video metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetadataResponse'
              example:
                video_id: dQw4w9WgXcQ
                success: true
                metadata:
                  title: Rick Astley - Never Gonna Give You Up
                  author_name: Rick Astley
                  author_url: https://www.youtube.com/@RickAstleyYT
                  thumbnail_url: https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg
                  channel_id: UCuAXFkgsw1L7xaCfnd5JJOw
                  view_count: 1600000000
                  like_count: 17000000
                retry_info:
                  total_attempts: 1
                  failed_attempts: 0
        '400':
          description: Invalid request or missing video identifier
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetadataResponse'
        '403':
          description: Pro account required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetadataResponse'
        '404':
          description: Video not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetadataResponse'
components:
  schemas:
    MetadataRequest:
      type: object
      description: Provide either `video_url` or `video_id`.
      properties:
        video_url:
          type: string
          description: Full YouTube URL. Use this or `video_id`.
        video_id:
          type: string
          description: 11-character YouTube video ID. Use this or `video_url`.
    MetadataResponse:
      type: object
      properties:
        video_id:
          type: string
        success:
          type: boolean
        error:
          type: string
        metadata:
          $ref: '#/components/schemas/VideoMetadata'
        retry_info:
          $ref: '#/components/schemas/RetryInfo'
    VideoMetadata:
      type: object
      properties:
        title:
          type: string
        author_name:
          type: string
        author_url:
          type: string
        thumbnail_url:
          type: string
        thumbnail_maxres_url:
          type: string
        channel_id:
          type: string
        xml_feed_url:
          type: string
          description: Channel RSS feed URL.
        subscriber_count:
          type: string
        view_count:
          type: integer
          format: int64
        like_count:
          type: integer
          format: int64
        channel_handle:
          type: string
        date_published:
          type: string
          format: date-time
          nullable: true
        upload_date:
          type: string
          format: date-time
          nullable: true
    RetryInfo:
      type: object
      description: Diagnostics about transcript/metadata fetch attempts.
      properties:
        total_attempts:
          type: integer
        failed_attempts:
          type: integer
        errors:
          type: array
          items:
            type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Your deployment's API key (MMK_API_KEY).

````