videos

List my videos (newest first)

Each item includes status, progress, duration_s, clips_count. Poll this or getVideo every ~10 s while status == "processing".

get/api/videos

Request

  • Base URL: https://cliponit.app
  • URL: https://cliponit.app/api/videos
  • 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

Videos

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"
  }
]

Changes

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