Skip to main content
POST
/
analyze-video
Analyze a video
curl --request POST \
  --url https://rawugc.com/api/v1/analyze-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videoUrl": "<string>",
  "prompt": "<string>"
}
'
{
  "summary": "<string>",
  "hook": "<string>",
  "keyframes": [
    {
      "timestamp": 123,
      "type": "hook",
      "description": "<string>",
      "visual": "<string>",
      "audio": "<string>",
      "text": "<string>"
    }
  ],
  "durationSeconds": 123,
  "tags": [
    "<string>"
  ],
  "whyItPerformed": [
    "<string>"
  ],
  "attributesToCopy": [
    "<string>"
  ],
  "hooksToTest": [
    "<string>"
  ]
}

Authorizations

Authorization
string
header
required

Use your API key from the RawUGC dashboard. Include as: Authorization: Bearer YOUR_API_KEY

Body

application/json
videoUrl
string<uri>
required

Video URL to analyze. Accepts social links (TikTok, Instagram, YouTube) or direct video URLs.

prompt
string

Optional custom analysis prompt

Maximum string length: 5000

Response

Video analyzed successfully

summary
string
hook
string

Main hook and why it works

keyframes
object[]
durationSeconds
number
tags
string[]
whyItPerformed
string[]

Why the video performed well

attributesToCopy
string[]

Actionable traits to copy

hooksToTest
string[]

Alternate hooks to test