HomeAPI DocsCreatorsList creator clips

GET

List creator clips

/v1/clipsonar/creators/:id/clips

Paginated clip list for a creator.

Path parameters

idstringrequired
Creator id returned from list or create
Example: 1af8cf27-866f-4434-8e66-10d67cabd7c1

Query parameters

pageintegeroptional
Page number (default 1)
Example: 1
limitintegeroptional
Page size (default 24, max 100)
Example: 24
sort_bystringoptional
Sort field (for example views, likes, taken_at)
Example: taken_at
sort_orderstringoptional
`asc` or `desc`
Example: desc
searchstringoptional
Optional text filter on caption / gist

Request body

This endpoint has no request body.

Response

200 Paginated clip summaries.

itemsobject[]required
Clip summary objects
pageintegerrequired
Current page
limitintegerrequired
Page size
totalintegerrequired
Total matching clips
has_morebooleanrequired
Whether another page exists

{
  "items": [
    {
      "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",
      "caption_text": "Tonight, V stepped into the crowd, taking in live performances at Vogue World: Hollywood.",
      "gist": null,
      "views": 7725,
      "likes": 461,
      "comments": 21,
      "taken_at": "2026-08-03T15:13:10.000Z",
      "analysis_status": "completed"
    }
  ],
  "page": 1,
  "limit": 3,
  "total": 25,
  "has_more": true
}

PreviousCreator analytics NextGet clip analytics

cURL

curl -X GET 'https://backend.socialsonar.app/v1/clipsonar/creators/1af8cf27-866f-4434-8e66-10d67cabd7c1/clips?page=1&limit=24&sort_by=taken_at&sort_order=desc' \
  -H 'Authorization: Bearer cs_live_YOUR_KEY' \
  -H 'Accept: application/json'

200

{
  "items": [
    {
      "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",
      "caption_text": "Tonight, V stepped into the crowd, taking in live performances at Vogue World: Hollywood.",
      "gist": null,
      "views": 7725,
      "likes": 461,
      "comments": 21,
      "taken_at": "2026-08-03T15:13:10.000Z",
      "analysis_status": "completed"
    }
  ],
  "page": 1,
  "limit": 3,
  "total": 25,
  "has_more": true
}

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

List creator clips

/v1/clipsonar/creators/:id/clips

Paginated clip list for a creator.

Path parameters

idstringrequired
Creator id returned from list or create
Example: 1af8cf27-866f-4434-8e66-10d67cabd7c1

Query parameters

pageintegeroptional
Page number (default 1)
Example: 1
limitintegeroptional
Page size (default 24, max 100)
Example: 24
sort_bystringoptional
Sort field (for example views, likes, taken_at)
Example: taken_at
sort_orderstringoptional
`asc` or `desc`
Example: desc
searchstringoptional
Optional text filter on caption / gist

Request body

This endpoint has no request body.

Response

200 Paginated clip summaries.

itemsobject[]required
Clip summary objects
pageintegerrequired
Current page
limitintegerrequired
Page size
totalintegerrequired
Total matching clips
has_morebooleanrequired
Whether another page exists

{
  "items": [
    {
      "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",
      "caption_text": "Tonight, V stepped into the crowd, taking in live performances at Vogue World: Hollywood.",
      "gist": null,
      "views": 7725,
      "likes": 461,
      "comments": 21,
      "taken_at": "2026-08-03T15:13:10.000Z",
      "analysis_status": "completed"
    }
  ],
  "page": 1,
  "limit": 3,
  "total": 25,
  "has_more": true
}

curl -X GET 'https://backend.socialsonar.app/v1/clipsonar/creators/1af8cf27-866f-4434-8e66-10d67cabd7c1/clips?page=1&limit=24&sort_by=taken_at&sort_order=desc' \ -H 'Authorization: Bearer cs_live_YOUR_KEY' \ -H 'Accept: application/json'

{ "items": [ { "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", "caption_text": "Tonight, V stepped into the crowd, taking in live performances at Vogue World: Hollywood.", "gist": null, "views": 7725, "likes": 461, "comments": 21, "taken_at": "2026-08-03T15:13:10.000Z", "analysis_status": "completed" } ], "page": 1, "limit": 3, "total": 25, "has_more": true }