ClipSonar API
Introduction
The ClipSonar API gives your product the same creator and clip intelligence you see in the ClipSonar app, over a simple REST interface. Create an API key, point it at Instagram or TikTok profiles and clips, then pull structured analytics, briefs, and credit usage into your own workflows.
It is built for platforms, agencies, and internal tools that need reliable content analysis without embedding our UI. Pipelines run asynchronously (minutes, not seconds), return a job you can poll or subscribe to via webhooks, and use the same video credits as your ClipSonar account.
What you can do
- Creators. Attach public profiles, refresh them, and fetch the full overview payload (author, metrics, insights, campaign brief, trends).
- Clips. List a creator’s analyzed videos, fetch analysis for one or many clip ids, or submit a clip URL for analysis.
- Jobs & webhooks. Track async processing and get notified when a creator is ready, fails, or analysis completes.
- Usage. Read remaining ClipSonar video credits and request aggregates for your own metering.
Typical flow
- Create a creator from a profile URL → get
creator_idandjob_id - Poll job status or listen for the
creator.readywebhook - Load creator analytics for the overview your users would see in ClipSonar
- List clips, then call clip analytics for deep dives
Get started
Base path: /v1/clipsonar. Authenticate with Authorization: Bearer cs_live_…. Every endpoint page includes copyable cURL and JavaScript examples.
Creators
Clips
Jobs
Webhooks
Usage
Collections
23 endpoints · Start with List creators
