Twitch Clip Fetcher Bookmarklet
To install, drag this link to your bookmarks bar or folder: Twitch Clip Fetcher
Synopsis
Bookmarklet that presents a UI on top of the Twitch Clips Manager page to retrieve data for clips en masse.
Walkthrough
- Go to the Twitch Clips Manager
- Click the bookmarklet to open the UI
- Optionally specify a minimum date to limit clip retrieval:
- If you've already run this and have data stored, find the
createdAt
value for the most recent clip and paste its value into the text box - Otherwise type a date in YYYY-MM-DD format into the text box
- If you've already run this and have data stored, find the
- Click on "Get Clips"
- Clicking the button should disable it while it runs; if nothing happens, check your date format
- After "Get Clips" completes, the other buttons will become enabled for retrieving data
- "Copy clip data" will copy the entirety of the JSON data twitch returned to the clipboard so you can paste and save it
- "Copy cURL commands" will copy a set of commands you can save to a
.bat
(Windows) or.sh
(Mac/Linux) file to invoke thecurl
command in order to download all of the retrieved clips- If you're on Windows and need cURL, you can get it here
- Note: the links in these commands have a limited lifespan (24 hours)
A few notes on the data returned:
curator
may be absent if the user who took the clip no longer existsgame
may be absent if no game was set on the stream, or if the game is no longer listed on Twitchvideo
and related properties will only be present if the original video the clip was taken from still exists (e.g. it was a highlight, or a VOD less than 14/60 days old for non-partner/partner)- The bookmarklet excludes
playbackAccessToken
, which is instead reflected in the cURL commands copied from the other button; keeping it with the rest of the data would needlessly make the data much larger when it doesn't serve any other purpose and could contain sensitive information
How does this work?
- Uses the same GraphQL operation used by the clips manager table for retrieving its data
- Scrolls the clips table to cause it to load more data in order to pick up headers needed to make the requests
- Does not send data anywhere other than Twitch's GraphQL endpoint
Changelog
Version 1.0 (April 3, 2022)
- First release