# Download VODs via API or other means

**URL:** <https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490>\
**Category:** API\
**Created:** [October 6, 2020, 5:48am UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490 "2020-10-06T05:48:33Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![Kymroth](https://d3ovvz0v2ajtpu.cloudfront.net/user_avatar/discuss.dev.twitch.com/kymroth/32/8405_2.png) [@Kymroth](https://discuss.dev.twitch.com/u/Kymroth)\
**Post date:** [October 6, 2020, 5:48am UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/1 "2020-10-06T05:48:33Z")

</div>

Hello.

I have been looking around for a few days but I have not found a reliable way to download Twitch VODs from the API. Simply because I think it’s not supported.

During my digging I have found alternative ways to achieve it, using the same method as the “TwitchLeecher” app (that uses “usher” and old Twitch API calls).

So my questions are:  
Has anyone successfully achieved downloading VODs?  
Is there some hidden old (but still supported for years to come) Twitch API to do it?  
If not, is anyone familiar with the method used by “TwitchLeecher”? Can I consider it as a viable option to develop a tool that needs to download VODs?

I would appreciate any insights (and not just a “This is not supported” answer).

Thanks!

---

<div class="post-metadata">

**Author:** ![Dist](https://d3ovvz0v2ajtpu.cloudfront.net/user_avatar/discuss.dev.twitch.com/dist/32/7192_2.png) [@Dist](https://discuss.dev.twitch.com/u/Dist)\
**Post date:** [October 6, 2020, 8:11am UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/2 "2020-10-06T08:11:13Z")

</div>

> [@Kymroth](#):
>
> Has anyone successfully achieved downloading VODs?

That’s not possible through the API

> [@Kymroth](#):
>
> Is there some hidden old (but still supported for years to come) Twitch API to do it?

No

> [@Kymroth](#):
>
> If not, is anyone familiar with the method used by “TwitchLeecher”? Can I consider it as a viable option to develop a tool that needs to download VODs?

TwitchLeecher, and similar apps, violate the Twitch Developer Agreement, and are at risk of legal action being taken against them, some of which have already been shut down. I’m not a legal expert and can’t give out legal advice, so I strongly suggest you consult a legal professional if you wish to develop tools that violate legal agreements.

---

<div class="post-metadata">

**Author:** ![Kymroth](https://d3ovvz0v2ajtpu.cloudfront.net/user_avatar/discuss.dev.twitch.com/kymroth/32/8405_2.png) [@Kymroth](https://discuss.dev.twitch.com/u/Kymroth)\
**Post date:** [October 6, 2020, 8:27am UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/3 "2020-10-06T08:27:14Z")

</div>

Hello @Dist

Obviously I do not wish to violate any agreement at all.  
The initial idea was to develop a cool tool that would allow streamers to easily upload their videos to Youtube and make some simple video edition (like split in sections of 30 minutes, add to Youtube playlists, …).

I guess it’s not possible at all then, which ends my (short) life as a developer on the Twitch API (unless I get some other ideas in the future).

Thanks a bunch for the answer!

---

<div class="post-metadata">

**Author:** ![BarryCarlyon](https://d3ovvz0v2ajtpu.cloudfront.net/user_avatar/discuss.dev.twitch.com/barrycarlyon/32/253_2.png) [@BarryCarlyon](https://discuss.dev.twitch.com/u/BarryCarlyon)\
**Post date:** [October 6, 2020, 11:33am UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/4 "2020-10-06T11:33:02Z")

</div>

see also this uservoice

> **[Extend Clips API to provide the MP4 url so editors can automate downloads](https://twitch.uservoice.com/forums/310213-developers/suggestions/39228784-extend-clips-api-to-provide-the-mp4-url-so-editors)**
>
> If I have an oAuth that represents a User, where the User is either
> 
> \- the broadcaster the clip is of
> \- an editor of the channel that the clip is of
> \- the user is the owner of the clip
> 
> And I make a request for a Clip as documented:...

Upvoting uservoices help tell Twitch what we want.

> [@Kymroth](#):
>
> The initial idea was to develop a cool tool that would allow streamers to easily upload their videos to Youtube and make some simple video edition (like split in sections of 30 minutes, add to Youtube playlists, …).

The Twitch VOD system already lets Editors of a channel do this. (Cept maybe the YouTube playlist part)

---

<div class="post-metadata">

**Author:** ![Kymroth](https://d3ovvz0v2ajtpu.cloudfront.net/user_avatar/discuss.dev.twitch.com/kymroth/32/8405_2.png) [@Kymroth](https://discuss.dev.twitch.com/u/Kymroth)\
**Post date:** [October 6, 2020, 1:40pm UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/5 "2020-10-06T13:40:33Z")

</div>

Hello @BarryCarlyon

Thanks for the link. Although it seems to intend to allow downloading Clips, where my “project” was more about VODs (unless I missed something there).

From my tests, when uploading a VOD from my own Twitch channel to Youtube, I can only directly upload and not split the video into segments from the Twitch UI. But maybe it’s because my VOD is only 3 minutes duration?

Anyway, that was only a small portion of my ideas for the “project”.  
On the top of my head:

- Allow adding an appropriate thumbnail for the VODs on Youtube
- Allow uploading a bunch of VODs related to the same game in a “one shot”, creating a playlist at the same time
- Automate the upload (to some extent / based on rules / ?). (But maybe Twitch would not allow that kind of automation since it ‘leaks’ the content out of their platform).

Side note: I’m a huge fan of your work by the way man, as a long time viewer of the CohhCarnage channel.  
Some of the features you have are really impressive (the pixel detection for cut scenes, to mention one among others).

---

<div class="post-metadata">

**Author:** ![BarryCarlyon](https://d3ovvz0v2ajtpu.cloudfront.net/user_avatar/discuss.dev.twitch.com/barrycarlyon/32/253_2.png) [@BarryCarlyon](https://discuss.dev.twitch.com/u/BarryCarlyon)\
**Post date:** [October 6, 2020, 1:48pm UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/6 "2020-10-06T13:48:36Z")

</div>

> [@Kymroth](#):
>
> Thanks for the link. Although it seems to intend to allow downloading Clips, where my “project” was more about VODs (unless I missed something there).

Good point, thats my pre coffee can’t read talking 😃  
Probably need a separate uservoice for doing that via the API. (There probably already is one, I just don’t have it’s link to hand)

Since right now it’s a manual task if you are an editor. (It’s not _always_ a good idea to chop automatically in case you end up slicing a cutscene in half or something)

> [@Kymroth](#):
>
> From my tests, when uploading a VOD from my own Twitch channel to Youtube, I can only directly upload and not split the video into segments from the Twitch UI. But maybe it’s because my VOD is only 3 minutes duration?

probably yes. I believe what usually happens is a editor will make the vod be split into _as many highlights as needed_ of the required length and upload those to YouTube from Twitch via the inbuilt connection.

> [@Kymroth](#):
>
> Allow adding an appropriate thumbnail for the VODs on Youtube

That’s youtube API

> [@Kymroth](#):
>
> Automate the upload (to some extent / based on rules / ?). (But maybe Twitch would not allow that kind of automation since it ‘leaks’ the content out of their platform).

YouTube API too

Basically you just need the ability to get the VOD from Twitch (automagically) then you can do what you want since _most_ of what you describe is YouTube API not Twitch API.

Made the uservoice [Extend videos API to allow editors (and above) to automate downloads – Twitch UserVoice](https://twitch.uservoice.com/forums/310213-developers/suggestions/41560489-extend-videos-api-to-allow-editors-and-above-to)

> [@Kymroth](#):
>
> Side note: I’m a huge fan of your work by the way man, as a long time viewer of the CohhCarnage channel.  
> Some of the features you have are really impressive (the pixel detection for cut scenes, to mention one among others).

🙂 Am programmer will program for food 😃 And making cool stuff is cool ™

---

<div class="post-metadata">

**Author:** ![Kymroth](https://d3ovvz0v2ajtpu.cloudfront.net/user_avatar/discuss.dev.twitch.com/kymroth/32/8405_2.png) [@Kymroth](https://discuss.dev.twitch.com/u/Kymroth)\
**Post date:** [October 6, 2020, 2:45pm UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/7 "2020-10-06T14:45:36Z")

</div>

Yes most of my ideas involve the Youtube API which is pretty complete (I know that for a fact, having played with it for other developments).

I was just answering to:

> The Twitch VOD system already lets Editors of a channel do this. (Cept maybe the YouTube playlist part)

By mentioning how I think I could provide a much “deeper” service that what is already there.

Also, for having tested the VOD export feature a little bit, the user experience is really not great:

- Click on “Export”
- Youtube OAuth popup
- Connect, allow permissions
- The popup closes and nothing happens in the Twitch UI? Or I missed it?
- Do it all a second time because it felt like it didn’t work
- Go to my Youtube channel, notice I have 2 videos uploading
- Feeling dumb

I totally understand how that feature is not a priority for Twitch since it moves the content out of their platform though.

Anyway, thanks for creating the UserVoice for me!  
I hope they add that feature relatively “soon” ™.

In the mean time, maybe I will think of something else to work on (or maybe not, I’m not too good on the “idea” part, the “implementation” part is more my thing 😃 )

---

<div class="post-metadata">

**Author:** ![system](https://d2opxh93rbxzdn.cloudfront.net/original/2X/0/05909729875cce3b53e59d5561c4d23bb14948fc.png) [@system](https://discuss.dev.twitch.com/u/system)\
**Post date:** [November 5, 2020, 2:45pm UTC](https://discuss.dev.twitch.com/t/download-vods-via-api-or-other-means/28490/8 "2020-11-05T14:45:36Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
