Skip to main content
GET
/
viral-library
/
videos
/
{videoId}
Get viral library video
curl --request GET \
  --url https://rawugc.com/api/v1/viral-library/videos/{videoId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "tiktokId": "<string>",
  "tiktokUrl": "<string>",
  "username": "<string>",
  "description": "<string>",
  "stats": {
    "views": 123,
    "likes": 123,
    "comments": 123,
    "shares": 123,
    "saves": 123
  },
  "hashtags": [
    "<string>"
  ],
  "soundName": "<string>",
  "duration": 123,
  "thumbnailUrl": "<string>",
  "playUrl": "<string>",
  "analysis": {
    "hook": "<string>",
    "summary": "<string>",
    "whyItPerformed": [
      "<string>"
    ],
    "attributesToCopy": [
      "<string>"
    ],
    "hooksToTest": [
      "<string>"
    ],
    "keyframes": [
      {
        "timestamp": 123,
        "type": "<string>",
        "description": "<string>",
        "visual": "<string>",
        "audio": "<string>",
        "text": "<string>"
      }
    ],
    "durationSeconds": 123,
    "tags": [
      "<string>"
    ],
    "analyzedAt": 123
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

videoId
string
required

The video ID

Response

Video with full analysis

A viral video with its metadata and optional AI analysis

id
string

Unique video identifier

tiktokId
string

Original TikTok video ID

tiktokUrl
string<uri>

URL to the original TikTok video

username
string

TikTok creator username

description
string

Video caption/description

stats
object

Engagement metrics

hashtags
string[]

Hashtags used in the video

soundName
string

Name of the sound/music used

duration
number

Video duration in seconds

thumbnailUrl
string<uri>

Thumbnail image URL

playUrl
string<uri>

Direct video playback URL

analysis
object

AI analysis data (null if not yet analyzed)