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

# Analyze a video

> Analyze any video URL — social links (TikTok, Instagram, YouTube) or direct video URLs. Social links are downloaded automatically. Returns rich analysis including hooks, keyframes, and performance insights. Maximum file size: 150MB (~5 minutes). Costs 1 credit.



## OpenAPI

````yaml /openapi.json post /analyze-video
openapi: 3.0.0
info:
  title: RawUGC API
  version: 1.0.0
  description: >-
    Generate AI videos, images, and music, and schedule social media posts
    programmatically.
  contact:
    name: API Support
    email: support@rawugc.com
    url: https://docs.rawugc.com
  license:
    name: Proprietary
servers:
  - url: https://rawugc.com/api/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Tasks
    description: >-
      Deprecated. Use typed resource endpoints instead: GET /videos/{videoId},
      GET /images/{imageId}, GET /music/{musicId}.
  - name: Image Generation
    description: >-
      Generate and edit AI images using Nano Banana models. Supports
      text-to-image generation (6 credits) and image-to-image editing (2
      credits).
  - name: Video Generation
    description: Generate and manage AI videos using Sora 2, Kling, and Veo 3 models
  - name: Personas
    description: Manage target audience personas for content plans
  - name: Messaging
    description: Manage brand/positioning messaging for content plans
  - name: Products
    description: Manage products for video generation
  - name: Styles
    description: Manage video creative styles and templates
  - name: Characters
    description: List available AI characters for video generation
  - name: Video Editing
    description: Post-process videos with captions, overlays, and effects
  - name: Upload
    description: Upload video and image files for use in generation requests
  - name: Social Scheduling
    description: Schedule and manage social media posts to TikTok, Instagram, and YouTube
  - name: Social Accounts
    description: Manage connected social media accounts
  - name: Music Generation
    description: >-
      Generate AI music tracks using Suno models with customizable genre, mood,
      and style
  - name: Viral Library
    description: >-
      Browse and search analyzed TikTok videos across the platform. Includes
      AI-powered analysis with hooks, keyframes, performance insights, and
      semantic search via natural language queries.
  - name: Research
    description: >-
      Scrape TikTok videos, analyze any video, and generate content plans. Tools
      for competitive research and content strategy.
paths:
  /analyze-video:
    post:
      tags:
        - Research
      summary: Analyze a video
      description: >-
        Analyze any video URL — social links (TikTok, Instagram, YouTube) or
        direct video URLs. Social links are downloaded automatically. Returns
        rich analysis including hooks, keyframes, and performance insights.
        Maximum file size: 150MB (~5 minutes). Costs 1 credit.
      operationId: analyzeVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AnalyzeVideoRequest'
      responses:
        '200':
          description: Video analyzed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyzeVideoResponse'
        '401':
          description: Unauthorized
        '429':
          description: Rate limit exceeded
components:
  schemas:
    AnalyzeVideoRequest:
      type: object
      required:
        - videoUrl
      properties:
        videoUrl:
          type: string
          format: uri
          description: >-
            Video URL to analyze. Accepts social links (TikTok, Instagram,
            YouTube) or direct video URLs.
        prompt:
          type: string
          maxLength: 5000
          description: Optional custom analysis prompt
    AnalyzeVideoResponse:
      type: object
      properties:
        summary:
          type: string
        hook:
          type: string
          description: Main hook and why it works
        keyframes:
          type: array
          items:
            type: object
            properties:
              timestamp:
                type: number
              type:
                type: string
                enum:
                  - hook
                  - transition
                  - product_shot
                  - text_overlay
                  - b-roll
                  - reaction
                  - application
                  - before_after
                  - cta
                  - other
              description:
                type: string
              visual:
                type: string
              audio:
                type: string
              text:
                type: string
        durationSeconds:
          type: number
        tags:
          type: array
          items:
            type: string
        whyItPerformed:
          type: array
          items:
            type: string
          description: Why the video performed well
        attributesToCopy:
          type: array
          items:
            type: string
          description: Actionable traits to copy
        hooksToTest:
          type: array
          items:
            type: string
          description: Alternate hooks to test
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Use your API key from the RawUGC dashboard. Include as: Authorization:
        Bearer YOUR_API_KEY

````