videos

Video with its detected clips

state (queued|running|ready|failed), queue_position and eta_s tell how long to wait (poll every ~10 s, or use the MCP wait_video tool). Clips are sorted chronologically (position). Pick by score (0-100, estimated viral potential) and read reason. description/hashtags are null until describeClip is called. thumbnail_url may be null while thumbnails are generated.

get/api/videos/{id}

Request

  • Base URL: https://cliponit.app
  • URL: https://cliponit.app/api/videos/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie session
    • OAuth 2 (authorization code, authorization URL https://cliponit.app/oauth/authorize, token URL https://cliponit.app/oauth/token, scopes: clips)

Response

Video + clips

idstring uuid required
titlestring required
pathstring

Server-side file path (informational)

urlstring required

Source file, relative to the server, e.g. /files/uploads/<id>.mp4

thumbnail_urlstring nullable
thumbnail_pathstring nullable
size_bytesinteger required
duration_snumber nullable

Seconds, null until probed

widthinteger nullable
heightinteger nullable
status'processing' | 'ready' | 'failed' required
state'queued' | 'running' | 'ready' | 'failed' required

processing split by the job queue: queued (waiting behind other videos) or running; otherwise = status

queue_positioninteger nullable

1-based position in the processing queue while state is queued

eta_snumber nullable

Estimated seconds until ready (0.25 × (duration + durations of the videos ahead)); null when not processing

progress'downloading' | 'probing' | 'transcribing' | 'detecting' | 'demo' | 'null' nullable

Current step while processing; null when ready/failed. demo = demo copy waiting for the master

errorstring nullable

Why it failed

is_demo0 | 1 required

1 = the sample video seeded at signup (cannot be exported on the free plan)

created_atstring required
clips_countinteger required

Example response

{
  "id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90",
  "clips": [
    {
      "id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90",
      "video_id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.