ClipSonar
Agent
BlogPricing
LoginGet Started
HomeAPI DocsClipsGet clip 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
GET

Get clip analytics

/v1/clipsonar/clips/analytics

Fetch analysis for one or many clip ids via query string. Access is checked per clip via creator or collection membership. See the Clip analytics guide for the nested `analysis.result` shape. No body.

Query parameters

  • idsstringrequired

    Comma-separated clip ids (1 to quota max)

    Example: 3858d56f-8c7e-4602-8f23-ab329c9cc0e0

Request body

This endpoint has no request body.

Response

200 Clip objects with flattened insights on `analysis.result` (no pipeline cost meta).

  • clipsobject[]required

    Analyzed clip objects for the requested ids

{
  "clips": [
    {
      "clip_id": "591acb36-4f7f-4ef0-8bcd-bb570401b47c",
      "shortcode": "DblR667vY8u",
      "thumbnail_url": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/DblR667vY8u/thumbnail.jpg",
      "gist": "Tech enthusiast looking for reliable and entertaining hardware channels to follow.",
      "likes": "461",
      "comments": "21",
      "engagement_score": 503,
      "username": "pinniaata",
      "taken_at": "2026-08-03T15:13:10.000Z",
      "analysis": {
        "status": "completed",
        "error": null,
        "started_at": "2026-08-04T15:11:37.151Z",
        "completed_at": "2026-08-04T15:12:10.415Z",
        "result": {
          "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": []
        }
      }
    }
  ]
}
PreviousList creator clipsNextGet Clip Analytics (BULK)
cURL
curl -X GET 'https://backend.socialsonar.app/v1/clipsonar/clips/analytics?ids=3858d56f-8c7e-4602-8f23-ab329c9cc0e0' \
  -H 'Authorization: Bearer cs_live_YOUR_KEY' \
  -H 'Accept: application/json'
200
{
  "clips": [
    {
      "clip_id": "591acb36-4f7f-4ef0-8bcd-bb570401b47c",
      "shortcode": "DblR667vY8u",
      "thumbnail_url": "https://sonar-social-media-cache-ap-south-1.s3.ap-south-1.amazonaws.com/analyzer/content/DblR667vY8u/thumbnail.jpg",
      "gist": "Tech enthusiast looking for reliable and entertaining hardware channels to follow.",
      "likes": "461",
      "comments": "21",
      "engagement_score": 503,
      "username": "pinniaata",
      "taken_at": "2026-08-03T15:13:10.000Z",
      "analysis": {
        "status": "completed",
        "error": null,
        "started_at": "2026-08-04T15:11:37.151Z",
        "completed_at": "2026-08-04T15:12:10.415Z",
        "result": {
          "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": []
        }
      }
    }
  ]
}
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