Guides
Creator Analytics
After a creator run completes, GET /v1/clipsonar/creators/:id/analytics returns the same Insights payload shown in the ClipSonar app. Top-level keys are always author, metrics, overview, brief, and trends.
Examples below are trimmed from a real API response for a completed Instagram creator. Nested lists are shortened for readability; field names and types match production.
Response shape
Nested fields match the live JSON. Expand mentally as metrics.performance.avgViews, overview.dna.niche, brief.hookTypeLeaderboard[].type, and so on.
creator_idstringrequiredCreator id
authorobjectrequiredProfile / author summary
metricsobjectrequiredAggregate performance metrics for the analyzed corpus
overviewobjectrequiredInsights overview used by the in-app Insights page
briefobjectrequiredCampaign brief payload
trendsobjectrequiredTime-series trends (arrays may be empty)
metrics
metrics.performance holds the headline stats. analyzedCount is the number of clips included in the run.
{
"performance": {
"changes": {
"viralRatePts": 0,
"medianViewsPct": -57
},
"avgViews": 2646947,
"viralRate": 0,
"avgDuration": 37,
"medianViews": 3161496,
"reelsAnalyzed": 5,
"engagementRate": 1.53,
"postingFrequency": 3.7
},
"analyzedCount": 5
}overview
Common keys include dna, pageMeta, playbook, topReels, performance, whatShowsUp, contentStrategy, and formatPerformance. Some arrays can be empty depending on the corpus. Profile header fields live on top-level author.
{
"dna": {
"niche": [
"Nature and marine biology facts",
"Science storytelling via b-roll",
"Animal behavior explanations",
"Historical documentary tie-ins"
],
"approach": [
"Posts 3–4 clips weekly",
"Primary format: b-roll with captions",
"Opens with story or bold claim",
"Uses text popups and zoom inserts"
],
"audience": [
"Curious nature enthusiasts",
"Science fact seekers",
"Casual documentary viewers",
"Marine life fans"
],
"contentStyles": [
"B-roll heavy with captions",
"Story-led openings",
"Bold claims and questions",
"Slow, observational pacing"
],
"summaryParagraph": "This creator packages nature and science facts as short, story-led clips, using b-roll of animals and natural phenomena to explain hidden biological processes. The top video, at 3.76M views, opened with a story about bubbler crabs cleaning beaches, showing that narrative framing around a visual subject outperforms plain footage. Across the corpus, clips that paired a clear hook with a concrete scientific takeaway consistently drew the largest audiences."
},
"pageMeta": {
"timezone": "Asia/Calcutta",
"generatedAt": "2026-08-04T12:38:58.803Z",
"dateRangeEnd": "2026-08-03T22:01:20.000Z",
"analyzedCount": 5,
"dateRangeStart": "2026-07-25T13:33:24.000Z"
},
"playbook": {
"visualStyle": {
"framing": "Broll",
"setting": "Outdoor",
"lighting": "Natural",
"captionsShare": 80
},
"editingStyle": {
"pace": "Slow",
"devices": [
"Text Popup",
"Jump Cut",
"Zoom",
"Broll Insert"
],
"sampleSize": 5,
"approxCutsPerSec": null
},
"styleInsight": [
"Top clip used story-led b-roll, breaking from the corpus's slow observational norm",
"Bold-claim clip used fast pacing, contrasting with the slow editing style"
],
"publishingHabits": {
"bestTimesLabel": "Sat, Tue, Sun · 03:00, 21:00",
"frequencyLabel": "3–4 clips/week",
"consistencyScore": 100
}
},
"topReels": [
{
"title": "Viewers discover how tiny bubbler crabs clean and aerate sandy beaches by forming balls of sand.",
"views": 3756334,
"takenAt": "2026-07-25T13:33:24.000Z",
"contentId": "90c934f9-ef80-483d-b4ec-23775d847036",
"shortcode": "DbN7eLgRkn0",
"durationSec": 23.523,
"thumbnailUrl": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/DbN7eLgRkn0/thumbnail.jpg"
},
{
"title": "Viewers discover diatoms, living single-celled algae made of glass that exist everywhere from polar ice to outer space.",
"views": 3589017,
"takenAt": "2026-08-02T16:06:23.000Z",
"contentId": "69d65a68-90e3-4b91-8e0b-eb72c94172c0",
"shortcode": "DbizWvGg8xr",
"durationSec": 45.013,
"thumbnailUrl": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/DbizWvGg8xr/thumbnail.jpg"
}
],
"performance": {
"changes": {
"viralRatePts": 0,
"medianViewsPct": -57
},
"avgViews": 2646947,
"viralRate": 0,
"avgDuration": 37,
"medianViews": 3161496,
"reelsAnalyzed": 5,
"engagementRate": 1.53,
"postingFrequency": 3.7
},
"whatShowsUp": {
"factors": [
{
"title": "Story-first framing on visual subjects",
"shareOfTop": null,
"description": [
"Top clip opened with a story about bubbler crabs, not just footage",
"Story hook appeared in 100% of top clips",
"Narrative gave the b-roll a reason to exist"
],
"evidenceLabel": "Story hook in 100% of top clips",
"evidenceContentIds": [
"90c934f9-ef80-483d-b4ec-23775d847036",
"69d65a68-90e3-4b91-8e0b-eb72c94172c0"
]
},
{
"title": "Bold claims that promise discovery",
"shareOfTop": null,
"description": [
"Diatoms clip used a bold claim about glass algae in space",
"Claim format hit 3.59M views, second-highest",
"Positioned the fact as a revelation, not trivia"
],
"evidenceLabel": "3.59M views on bold-claim clip",
"evidenceContentIds": [
"90c934f9-ef80-483d-b4ec-23775d847036",
"69d65a68-90e3-4b91-8e0b-eb72c94172c0"
]
}
]
},
"contentStrategy": {
"formatMix": [
{
"count": 3,
"label": "Broll",
"share": 60,
"avgViews": 2161408,
"performanceStars": 2,
"evidenceContentIds": [
"90c934f9-ef80-483d-b4ec-23775d847036",
"3858d56f-8c7e-4602-8f23-ab329c9cc0e0",
"b92e883f-dc97-4f86-814b-cdd6dd455982"
]
},
{
"count": 1,
"label": "Other",
"share": 20,
"avgViews": 3589017,
"performanceStars": 3,
"evidenceContentIds": [
"69d65a68-90e3-4b91-8e0b-eb72c94172c0"
]
}
],
"postingCadence": {
"bestDays": [
"Sat",
"Tue",
"Sun"
],
"bestHours": [
"03:00",
"21:00"
],
"postsPerWeek": 3.7,
"consistencyScore": 100
},
"formatSampleSize": 5
},
"formatPerformance": [
{
"label": "Broll",
"share": 60,
"trend": [
3756334,
1363945
],
"avgViews": 2161408,
"reelCount": 3,
"viralRate": 0,
"medianViews": 1487762,
"engagementRate": 1.3
},
{
"label": "Other",
"share": 20,
"trend": [
3589017
],
"avgViews": 3589017,
"reelCount": 1,
"viralRate": 0,
"medianViews": 3589017,
"engagementRate": 2.38
}
],
"topCollaborations": [
{
"share": 100,
"authorId": "0fba10da-7f33-49a1-b6af-fa045bc38ece",
"avgViews": 3161496,
"fullName": "Tom Hiddleston",
"username": "twhiddleston",
"reelCount": 1,
"viralRate": 0,
"isVerified": true,
"medianViews": 3161496,
"engagementRate": 2.96,
"profileImageUrl": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/twhiddleston/profile.jpg",
"evidenceContentIds": [
"dfd055e5-dcb1-4efa-93d9-b500ca915a14"
]
}
]
}brief
Brief sections power campaign planning UI. Leaderboards and mix objects usually include share, count, avgViews / medianViews, and optional evidence ids.
{
"structure": {
"beatTraits": [
{
"id": "beat-value",
"label": "Value beat",
"winnerShare": 1,
"restShare": 0.33,
"lift": 2,
"direction": "up"
},
{
"id": "beat-hook",
"label": "Hook beat",
"winnerShare": 1,
"restShare": 1,
"lift": 0,
"direction": "up"
}
]
},
"hookTypeLeaderboard": [
{
"type": "BOLD_CLAIM",
"count": 1,
"share": 0.2,
"avgEngagementRate": 2.38,
"medianViews": 3589017
},
{
"type": "STORY",
"count": 2,
"share": 0.4,
"avgEngagementRate": 1.97,
"medianViews": 3458915
},
{
"type": "PATTERN_INTERRUPT",
"count": 1,
"share": 0.2,
"avgEngagementRate": 1.53,
"medianViews": 1240128
}
],
"ctaTypeLeaderboard": [
{
"type": "WATCH_MORE",
"count": 1,
"share": 0.2,
"avgEngagementRate": 2.96,
"medianViews": 3161496
}
],
"formatMix": [
{
"label": "Broll",
"share": 60,
"count": 3,
"avgViews": 2161408,
"performanceStars": 2
},
{
"label": "Other",
"share": 20,
"count": 1,
"avgViews": 3589017,
"performanceStars": 3
},
{
"label": "Talking Head",
"share": 20,
"count": 1,
"avgViews": 3161496,
"performanceStars": 3
}
],
"brandMentions": [
{
"label": "Disney+",
"share": 20,
"count": 1,
"avgViews": 3161496,
"performanceStars": 3
},
{
"label": "Hulu",
"share": 20,
"count": 1,
"avgViews": 3161496,
"performanceStars": 3
}
],
"audience": {
"ages": [
{
"label": "56+",
"share": 40,
"count": 2,
"avgViews": 2498231,
"performanceStars": 2
}
],
"genders": []
},
"generatedAt": "2026-08-04T13:15:44.752Z"
}

