Creator analytics

Path parameters

• idstringrequired

  Creator id returned from list or create

  Example: 1af8cf27-866f-4434-8e66-10d67cabd7c1

Query parameters

This endpoint has no query parameters.

Request body

This endpoint has no request body.

Response

200 Overview bundle used by the ClipSonar Insights page.

• 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)

{
  "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": []
  }
}