ClippedDocs

Use case

Pick the clips yourself, then post them

List what was found, look at the ones worth looking at, and post the keepers to YouTube, TikTok or Instagram with your own titles.

For when a person, or your own model, decides what goes up. Leave auto-posting off, read the feed, and call publish for the clips you choose.

  1. 1Read what was found

    Every clip has a score, a title and summary once it has been described, its category and its game. Filter on your side: the feed returns every moment that scored as a clip, not only the best.

    Shell
    curl "https://app.clipped.so/api/v1/clips?channel=jynxzi&limit=50" -H "Authorization: Bearer $KEY"

  2. 2Watch one

    Fetch video with your key. An uncut clip is cut on the first fetch, which answers 202 with Retry-After until the mp4 exists.

    Shell
    curl -L "https://app.clipped.so/api/v1/clips/$CLIP_ID/video" -H "Authorization: Bearer $KEY" -o clip.mp4

  3. 3Post it

    Name the destination. Leave title and description out to use the account's templates, or send your own. The call waits for the upload, which can take a minute, and answers with where it landed.

    YouTube posts a Short. TikTok puts a draft in the creator's inbox to finish in the app, so its status is drafted. Instagram posts a Reel, publicly, straight away.

    Shell
    curl -X POST "https://app.clipped.so/api/v1/clips/$CLIP_ID/publish" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{ "destination": "youtube", "title": "He did NOT see that coming", "privacy": "public" }'

Worth knowing

  • Posting a clip that isn't cut yet answers 409 cutting and starts the cut. Post it again in about a minute.
  • 409 publish_failed carries the destination's own reason: nothing connected, a clip over three minutes on YouTube, a quota.
  • With several accounts connected, account picks one by id (from destinations in the settings). Left out, your routing rules pick.