ClipSonar
Agent
BlogPricing
LoginGet Started
HomeAPI DocsCreator Analytics

Guides

IntroductionAuthenticationCreator AnalyticsClip analyticsWebhooks

Creators

  • GETList creators
  • POSTCreate creator
  • GETGet creator
  • POSTRefresh creator
  • PATCHUpdate analysis
  • DELETEDelete creator
  • GETCreator analytics
  • GETList creator clips

Clips

  • GETGet clip analytics
  • POSTGet Clip Analytics (BULK)
  • POSTAnalyze clip by URL

Jobs

  • GETGet job status

Webhooks

  • GETList webhooks
  • POSTCreate webhook
  • DELETEDelete webhook
  • GETWebhook deliveries

Usage

  • GETCredit balance
  • GETUsage summary

Collections

  • GETList collections
  • GETGet collection
  • POSTCreate collection
  • PUTUpdate collection
  • DELETEDelete collection

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_idstringrequired

    Creator id

  • authorobjectrequired

    Profile / author summary

  • metricsobjectrequired

    Aggregate performance metrics for the analyzed corpus

  • overviewobjectrequired

    Insights overview used by the in-app Insights page

  • briefobjectrequired

    Campaign brief payload

  • trendsobjectrequired

    Time-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"
}
← AuthenticationCreator analytics endpoint →
cURL
curl -X GET 'https://backend.socialsonar.app/v1/clipsonar/creators/{id}/analytics' \
  -H 'Authorization: Bearer cs_live_YOUR_KEY' \
  -H 'Accept: application/json'
200
{
  "creator_id": "354bb8ac-815d-4db1-8db8-ddf76c0f9494",
  "author": {
    "username": "natgeo",
    "fullName": "National Geographic",
    "followers": 268864432,
    "bio": "Step into wonder and find your inner explorer with National Geographic 🌎",
    "profileImageUrl": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/natgeo/profile.jpg"
  },
  "metrics": {
    "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": {
    "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": {
    "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"
  },
  "trends": {
    "performanceTrend": [],
    "engagementTrend": []
  }
}
Get started

Stop guessing what to post. Ship what already works.

ClipSonar turns real Instagram and TikTok clips into hooks, formulas, and briefs, so your next campaign starts from proof, not vibes. 7 days free on any plan.

Start analyzing clips

Creator scan

Analyzing @maya.creates…

84%

InstagramTikTok

Top hooks

15 patterns

ROI

3.4x

Velocity

Daily refresh

+42%

Winning formula

Ready for next brief

ClipSonar

Content intelligence for brands and creators. Analyze Instagram and TikTok clips at scale and turn what wins into playbooks you can ship.

support@clipsonar.com

Product

AgentAboutPricingFree toolsEngagement TrackerContact

Solutions

For creatorsFor brandsFor agenciesCompare

Resources

BlogHelp CenterAPI DocsFAQ

Company

Sign inSign upPrivacy PolicyTerms of Use

© 2026 ClipSonar. All rights reserved.

Built bySocial Sonar