What constitutes an embed?

[rune911]

Hello,

I wanted to get started working with the twitch API and I thought a neat project would be a shoutout player that monitors twitch chats for shoutouts and plays the top clip of the person receiving the shoutout on-stream. To do this we could use websockets to connect to chat and monitor the messages. Pick out the username of a shoutout then use the API to get that user’s top clips and play them on a web source inside of the streaming app (in my case SLOBS). I’ve got things working, but I want to make sure this method doesn’t violate any of Twitch’s rules.

My main concern is with the downloading and playing of the video file. In this case the web source is a local HTML document, so I can’t use embeds as I don’t have a parent. What I can do is have the web source download the video .mp4 file and play that. My question is: Is this allowed or does it break the embedding rules for twitch? If this does break the rules does anyone have any thoughts on an alternate way to do this?

Thanks in advance!

[BarryCarlyon]

@rune911

What I can do is have the web source download the video .mp4 file and play that. My question is: Is this allowed or does it break the embedding rules for twitch? If this does break the rules does anyone have any thoughts on an alternate way to do this?

There are no documented/supported ways to automatically obtain the MP4 URL for a video/vod or clip

Extend Clips API to provide the MP4 url so editors can automate downloads

Extend videos API to allow editors (and above) to automate downloads

[rune911]

Thanks @BarryCarlyon for the quick reply. I’m new to this community so I’d like clarification on what unsupported means here. When you say there’s no supported way to do it does that mean it’s not allowed or I should do it at my own risk because the way I’ve found if doing it could break at any time?

[BarryCarlyon]

@rune911

When you say there’s no supported way to do it does that mean it’s not allowed or I should do it at my own risk because the way I’ve found if doing it could break at any time?

All of the above. And technically means you violated the Dev agreement (on reverse engineering the Twitch website)

To display a clip you have to do an iFrame via the embed documentation

Video & Clips

or you manually go to your dashboard, and manually download the clip.

[rune911]

@BarryCarlyon that’s a big oof. I didn’t do any reverse engineering myself, but found something elsewhere via google-fu. Just wanted to see if it was legit or not and based on what you’ve said that’s a big NOPE! Looks like it’s time to build a website so I can run things through there utilizing parent. Thanks a ton for the quick replies!

[rune911]

@BarryCarlyon sorry, I do have one final followup question. If I do go forward and I build a website and embed the videos there and have the parent value set up and working and add it as a web source to a streaming app - that would be 100% ok and allowed, right? I feel like the purpose behind the parent is to know where people are viewing from, but in this case the parent wouldn’t really be where people are viewing from - they’d be viewing from a twitch stream itself. Again, I just want to make sure everything I write is 100% on the level before I let streamers use it.