Get Clip Analytics (BULK)

Query parameters

This endpoint has no query parameters.

Request body

Send JSON with Content-Type: application/json.

• clip_idsstring[]required

  1-100 clip ids (server may enforce a lower quota cap)

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

{
  "clip_ids": [
    "3858d56f-8c7e-4602-8f23-ab329c9cc0e0"
  ]
}

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