List videos
Returns a paginated list of all source videos in your library, ordered by most recent submission. Each item includes lifecycle counters (clips generated, edits, exports, posts) and the status of the latest submission.
Authorization
apiKey In: header
Query Parameters
Page number (default: 1)
1 <= valueItems per page (default: 12, max: 100)
1 <= value <= 100Value in
- "recent"
- "oldest"
- "title"
- "title-desc"
Response Body
application/json
curl -X GET "https://example.com/clips"{ "videos": [ { "id": "string", "title": "string", "author": "string", "platform": "string", "duration": 0, "thumbnail_url": "string", "video_url": "string", "clips_count": 0, "edited_count": 0, "exported_count": 0, "posted_count": 0, "submissions_count": 0, "last_submission": { "status": "queued", "error_code": "download_failed", "waiting_reason": "source_premiere_scheduled", "waiting_until": "string", "estimated_time": 0, "queue_position": 0, "is_priority": true, "created_at": "string", "completed_at": "string" } } ], "pagination": { "current_page": 0, "total_pages": 0, "total_count": 0, "has_next_page": true, "has_previous_page": true, "limit": 0 }}Complete an upload POST
Registers a finished upload, captures its dimensions/duration, and returns the video metadata together with the exact credit cost, in the same payload shape as `POST /clips/info`. Pass the returned `video_id` to `POST /clips` to start a clipping submission. Call this only after the PUT to `upload_url` returned `200`. If the file is missing from storage, this returns `FILE_NOT_FOUND`.
Delete a video DELETE
Permanently deletes a video from your library along with all its submissions and generated clips. This action cannot be undone. Returns `409` if a submission is currently processing.