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

# Wistia Video Extraction

> Fetch Wistia video metadata, media links, and engagement stats from a Wistia URL.



## OpenAPI

````yaml POST /wistia/video
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.hobbo.ai
    description: Main API server
  - url: https://py-api.hobbo.ai
    description: Python API server for scraper endpoints
security:
  - ApiKeyAuth: []
paths:
  /wistia/video:
    post:
      description: >-
        Fetch Wistia video metadata, media links, and engagement stats from a
        Wistia URL.
      requestBody:
        description: Wistia video fetch parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WistiaVideoRequest'
        required: true
      responses:
        '200':
          description: Video details fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WistiaVideoResponse'
        '400':
          description: Validation error or unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                errorExample:
                  value:
                    error: <string>
      servers:
        - url: https://py-api.hobbo.ai
components:
  schemas:
    WistiaVideoRequest:
      type: object
      required:
        - query
      properties:
        query:
          type: string
          description: Provide proper Wistia video URL
        is_text_formatted:
          type: boolean
          description: Controls text formatting in output
          default: true
    WistiaVideoResponse:
      type: object
      properties:
        all_reviews:
          type: array
          description: Array of fetched Wistia video data
          items:
            type: object
            properties:
              query:
                type: string
                description: Original query URL
              branding:
                type: object
                description: Wistia branding metadata
              media_date:
                type: string
                description: Date when the review was posted
              media_duration:
                type: number
                description: Duration in seconds
              enable_customer_logo:
                type: boolean
                description: Whether customer logo overlay is enabled
              media_id:
                type: string
                description: Wistia media ID
              media_type:
                type: string
                description: Media type
              media_name:
                type: string
                description: Media name/title
              media_stats:
                type: object
                properties:
                  load_count:
                    type: number
                    description: Total loads
                  play_count:
                    type: number
                    description: Total plays
                  unique_load_count:
                    type: number
                    description: Unique loads
                  unique_play_count:
                    type: number
                    description: Unique plays
                  average_engagement:
                    type: number
                    description: Average engagement
              media_data:
                type: array
                description: Raw Wistia assets array
                items:
                  type: object
                  properties:
                    bitrate:
                      type: number
                    created_at:
                      type: number
                    details:
                      type: object
                    display_name:
                      type: string
                    height:
                      type: number
                    is_enhanced:
                      type: boolean
                    metadata:
                      type: object
                      properties:
                        av_stream_metadata:
                          type: string
                    progress:
                      type: number
                    public:
                      type: boolean
                    size:
                      type: number
                    slug:
                      type: string
                    status:
                      type: number
                    type:
                      type: string
                    url:
                      type: string
                    width:
                      type: number
              review_media:
                type: array
                description: Array of media items (images/videos)
                items:
                  type: object
                  properties:
                    review_media_type:
                      type: string
                      description: Type of media (image or video)
                    review_media_url:
                      type: string
                      description: URL of the media
                    bitrate:
                      type:
                        - number
                        - 'null'
                      description: Bitrate of the video
                    codec:
                      type:
                        - string
                        - 'null'
                      description: Video codec
                    container:
                      type:
                        - string
                        - 'null'
                      description: Container format
                    height:
                      type:
                        - number
                        - 'null'
                      description: Height of the media
                    width:
                      type:
                        - number
                        - 'null'
                      description: Width of the media
                    display_name:
                      type:
                        - string
                        - 'null'
                      description: Display name of the media quality
                    ext:
                      type:
                        - string
                        - 'null'
                      description: File extension
                    size:
                      type:
                        - number
                        - 'null'
                      description: File size in bytes
                    slug:
                      type:
                        - string
                        - 'null'
                      description: Media slug
                    type:
                      type:
                        - string
                        - 'null'
                      description: Media type identifier
                    url:
                      type:
                        - string
                        - 'null'
                      description: Direct URL to the media file
              thumbnail_url:
                type: string
                description: URL of the review video thumbnail
              video_url:
                type: string
                description: URL of the review video
              iframe_data:
                type: object
                properties:
                  src:
                    type: string
                    description: Wistia embed iframe src
    Error:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
        data:
          type: object
          description: Empty object or additional error data
        success:
          type: boolean
          description: Indicates operation failed
          example: false
        message:
          type: string
          description: Error message describing what went wrong

````