ClippedDocs

Use case

Post a streamer's best clips automatically

Watch a streamer, set a score to post from, and let Clipped put the standouts on YouTube with nobody at a keyboard.

The setup most accounts want: pick who to watch, say how good a clip has to be, and stop thinking about it. Clipped records the streamer whenever they go live, scores every moment from 0 to 100, cuts the ones that clear your bar and posts them.

One thing can't be done with a key: connecting the YouTube account. Its owner signs in once, in the browser, under Settings → Accounts in the app. Everything after that is below.

  1. 1Watch the streamer

    From this call on they are recorded every time they go live. A bare name is Twitch; Kick and YouTube are kick:xqc and youtube:@handle, or a pasted link.

    Shell
    curl -X POST https://app.clipped.so/api/v1/streamers -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{ "channel": "jynxzi" }'

  2. 2Say what is good enough to post

    A rule is on or off and has a minScore: 70 posts the clearly good moments, 85 and up only the standouts. Set it on the streamer, and it beats the account's default for their clips.

    Shell
    curl -X PATCH https://app.clipped.so/api/v1/streamers/jynxzi -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{ "autoPost": { "on": true, "minScore": 80 } }'

  3. 3Choose the shape, and a daily limit

    blur-fill is the vertical shape that works for any stream; captions burns them in; postsPerDay is the most that go up in a day, so a wild stream doesn't flood the channel.

    Shell
    curl -X PATCH https://app.clipped.so/api/v1/settings -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{ "format": "blur-fill", "captions": true, "postsPerDay": 6 }'

  4. 4Check an account is connected

    destinations in the settings says where clips can go and which account is the default. If YouTube isn't connected, nothing posts.

    Shell
    curl https://app.clipped.so/api/v1/settings -H "Authorization: Bearer $KEY"

Worth knowing

  • Clips that post themselves go to YouTube only. TikTok and Instagram are posted to when you ask, one clip at a time.
  • A rule for one game or genre (categoryRules) sits between the streamer's rule and the account's: use it to post Valorant from 75 and never post Just Chatting.
  • Watching needs a paid plan; without one the first call answers 402 plan_required.