Creating a clip at a precise moment with a bot?

clips get created by POSTing to https://clips.twitch.tv/clips with this data:

{
    "player_backend_type": "player_core",
    "channel": "name_of_the_channel",
    "offset": "1234",
    "broadcast_id": "12345678",
    "vod_id": "",
    "play_session_id": "76cfad875fb8b5b6c76d55db76df"
}

This is undocumented, probably not meant for 3rd party use, and I haven’t tried it. But I can tell you this from observation:

  • offset is in seconds, since the start of the broadcast or the vod
  • only broadcast_id or vod_id gets submitted, depending on what you create the clip from. the vod_id is the same that is in the url, so no surprise there
  • play_session_id apparently is a random token. I haven’t looked at how it gets acquired, and doing the above request always returned a 500 error for me so far.

So to get this to work, it needs a bit more investigation