ClipSonar
Agent
BlogPricing
LoginGet Started
HomeAPI DocsUsageUsage summary

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

Usage summary

/v1/clipsonar/usage/summary

Aggregate API usage for the account (optionally filtered by time). No body.

Query parameters

  • fromstringoptional

    ISO start time

    Example: 2026-07-01T00:00:00.000Z

  • tostringoptional

    ISO end time

    Example: 2026-08-01T00:00:00.000Z

Request body

This endpoint has no request body.

Response

200 Usage aggregates for the selected window.

  • request_countnumberrequired

    Total API requests in window

  • error_countnumberrequired

    Requests with status >= 400

  • creators_creatednumberrequired

    Successful creator creates

  • videos_analyzednumberrequired

    Videos analyzed aggregate

  • fromstring | nullrequired

    Applied from filter

  • tostring | nullrequired

    Applied to filter

  • external_user_idstring | nullrequired

    Optional external user filter when provided

{
  "request_count": 100,
  "error_count": 14,
  "creators_created": 2,
  "videos_analyzed": 0,
  "from": null,
  "to": null,
  "external_user_id": null
}
PreviousCredit balanceNextList collections
cURL
curl -X GET 'https://backend.socialsonar.app/v1/clipsonar/usage/summary?from=2026-07-01T00%3A00%3A00.000Z&to=2026-08-01T00%3A00%3A00.000Z' \
  -H 'Authorization: Bearer cs_live_YOUR_KEY' \
  -H 'Accept: application/json'
200
{
  "request_count": 100,
  "error_count": 14,
  "creators_created": 2,
  "videos_analyzed": 0,
  "from": null,
  "to": null,
  "external_user_id": null
}
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