Get job status

/v1/clipsonar/jobs/:id

Poll async job status. `id` is the `job_id` from create/refresh/analyze responses. No query or body.

Path parameters

idstringrequired
Job id
Example: 82fde0d4-1111-2222-3333-444455556666

Query parameters

This endpoint has no query parameters.

Request body

This endpoint has no request body.

Response

200 Current job state.

job_idstringrequired
Job id
statusstringrequired
`queued` | `processing` | `completed` | `failed` | `paused_no_credits`
creator_idstring | nullrequired
Related creator when applicable
collection_idstring | nullrequired
Related collection when applicable
clip_idstring | nullrequired
Related clip when the job analyzed a single clip
foundnumberoptional
Videos found so far
analyzednumberoptional
Videos analyzed so far
analysis_failednumberoptional
Videos that failed analysis
is_runningbooleanoptional
Whether the run is still active
error_messagestring | nulloptional
Failure detail when status is failed
started_atstring | nulloptional
ISO start time
completed_atstring | nulloptional
ISO completion time

{
  "job_id": "cd21cc1e-112e-4e16-83c0-cc86261d6b5f",
  "status": "completed",
  "creator_id": "99b38603-b18b-4d95-9e20-3af0560f7673",
  "collection_id": null,
  "clip_id": null,
  "found": 25,
  "analyzed": 25,
  "analysis_failed": 0,
  "is_running": false,
  "error_message": null,
  "started_at": "2026-08-04T15:10:06.536Z",
  "completed_at": "2026-08-04T15:12:57.595Z"
}

PreviousAnalyze clip by URL NextList webhooks

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