Guides
Clip analytics
Use GET /v1/clipsonar/clips/analytics or Get Clip Analytics (BULK) to load per-clip insights. The response is always { clips: [...] }.
Examples below are trimmed from a real API response. Pipeline cost/meta is not returned. Insights live directly on analysis.result (not a nested result.result).
Response shape
clipsobject[]requiredAnalyzed clip objects for the requested ids
analysis.result
Hook/CTA types, story beats, brands, persona, visual/editing signals, and optional transcript fields.
{
"video_url": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/DblR667vY8u/video.mp4",
"content_type": "EDUCATIONAL",
"hook_type": "BOLD_CLAIM",
"cta_type": "NONE",
"story": [
{
"start": "00:00",
"end": "00:04",
"label": "HOOK",
"explanation": "The creator sits in a car and announces 'Insane Tech YouTuber Recommendations Part 2' to kick off the video."
},
{
"start": "00:04",
"end": "01:13",
"label": "VALUE",
"explanation": "The creator recommends RandomGaminginHD for showcasing older graphics cards and budget hardware capabilities."
}
],
"topic": "Tech YouTuber Recommendations",
"gist": "Tech enthusiast looking for reliable and entertaining hardware channels to follow.",
"description": "The creator shares the second part of his favorite tech YouTube channels, highlighting creators who focus on budget retro graphics cards and straightforward tech news without overly flashy edits. He discusses why these channels offer unique value for anyone interested in PC building and hardware testing.",
"takeaways": [
"Discover lesser-known or niche tech YouTube channels focused on PC hardware.",
"Learn about testing and reviewing older, budget-friendly graphics cards.",
"Get recommendations for clean, straightforward tech news reporting."
],
"spoken_brands": [],
"on_screen_brands": [
"RandomGaminginHD",
"Paul's Hardware"
],
"target_persona": {
"genders": [
"MALE"
],
"interests": [
"Technology",
"PC Gaming",
"Hardware",
"YouTube Creators"
],
"age_ranges": [],
"life_stages": [
"STUDENTS",
"YOUNG_PROFESSIONALS"
],
"financial_classes": [
"BUDGET",
"MIDDLE"
]
},
"visual_format": "TALKING_HEAD",
"opening_scene": "TALKING_TO_CAMERA",
"has_on_screen_captions": true,
"setting": "CAR",
"lighting": "NATURAL",
"editing_pace": "FAST",
"approx_cuts_per_sec": 0.8,
"editing_devices": [
"JUMP_CUT",
"ZOOM",
"TEXT_POPUP",
"BROLL_INSERT"
],
"speaking_tone": "ENERGETIC",
"speaking_pace": "FAST",
"narrative_style": "EDUCATIONAL",
"thumbnail_analysis": {
"thumbnail_url": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/DblR667vY8u/thumbnail.jpg",
"description": "A close-up shot of the creator in a car talking to the camera with text overlay.",
"has_face": true,
"face_emotion": "EXCITED",
"has_product": false,
"has_logo": false,
"has_offer": false,
"on_thumbnail_text": [
"Insane Tech YouTuber Recommendations Part 2"
],
"brands_detected": [],
"products_detected": []
},
"transcript": null,
"transcript_en": null,
"transcript_words": []
}

