platform'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat' required
Social media platform (facebook, instagram, tiktok, youtube, snapchat)
platformVideoIdstring required
platformAccountIdstring nullable required
accountUsernamestring nullable required
accountDisplayNamestring nullable required
accountProfilePictureUrlstring nullable required
accountFollowerCountnumber nullable required
regionstring nullable
Region code (2-letter ISO country code)
captionstring nullable required
hashtagsstring[] nullable required
downloadUrlstring nullable required
musicTitlestring nullable required
musicArtiststring nullable required
durationSecondsnumber nullable required
thumbnailUrlstring nullable required
viewCountnumber nullable required
likeCountnumber nullable required
commentCountnumber nullable required
shareCountnumber nullable required
bookmarkCountnumber nullable required
engagementRatenumber nullable required
outlierFactornumber nullable required
publishedAtstring date-time nullable required
lastSeenAtstring date-time required
addedAtstring date-time required
When the video entered the library
matchedTermsstring[] nullable required
isUgcboolean nullable required
ugcConfidencenumber nullable required
verticalstring nullable required
Research vertical (niche), e.g. education_study
formatPrimarystring nullable required
Primary video format, e.g. product_demo_review
hookArchetypestring nullable required
Hook archetype, e.g. curiosity_gap
hookTextOverlaystring nullable required
The on-screen hook text in the first seconds, if any
whyItWorkedstring nullable required
One-paragraph research verdict on why it went viral
replicationTipstring nullable required
How a marketer could adapt the pattern