Developers

The WinClipz API

Send us a video URL, get back scored, captioned, 9:16 clips. The same engine behind the dashboard, as a REST API. Free while in beta.

Authentication

Create a key in Dashboard → Settings → API keys, then send it as a bearer token. Keys are scoped to your workspace.

Authorization: Bearer wcz_your_key_here

Submit a video

Any public video URL (YouTube, Kick, Twitch, or a direct MP4). Only submit content you own or have permission to use.

POST https://www.winclipz.net/api/v1/streams
Content-Type: application/json

{ "url": "https://www.youtube.com/watch?v=…", "title": "optional" }

→ 201 { "id": "stream_id", "status": "QUEUED" }

Check status & get clips

Poll until status is DONE — typically a few minutes, depending on video length.

GET https://www.winclipz.net/api/v1/streams/{id}

→ 200 {
  "id": "…", "status": "DONE",
  "clips": [{
    "id": "…",
    "title": "He's Back In His Zone",
    "caption": "the hook the AI wrote",
    "durationSec": 12,
    "score": 80,
    "videoUrl": "https://…/clip.mp4"
  }]
}

List all clips

GET https://www.winclipz.net/api/v1/clips

→ 200 { "clips": [ … newest 100 … ] }

cURL quickstart

curl -X POST https://www.winclipz.net/api/v1/streams \
  -H "Authorization: Bearer wcz_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=…"}'