Add occured_at timestamps to Clips API
Add a occured_at
timestamp that tells you when the content in the clip was actually streamed.
Clips API objects have a created_at
timestamp which is when the user made the clip but this can be months or years off from when the content in a clip actually happened if a clip was made from a VOD which makes created_at
useless for a lot of use cases.
Even for clips from livestreams this is an issue as users can cut clips from a 2 minute (90 secs?) window so the actual content of two clips with the exact same created_at
timestamps can be completely different, which is surprisingly common in streams of fast paced games.
occured_at
can sometimes be calculated manually with the VODs created_at
timestamp (from /helix/video) + the clips vod_offset
(from Kraken clips API, helix doesn't have vod_offset
) as long as the vod is still alive. Once a vod expires (or is deleted for channels with permanent VODs) it's not possible to calculate that timestamp for a clip anymore.
Use cases:
* Displaying clips in any form of time based ordering or filtering
For example nobody wants to see a clip from two months ago when filtering for clips from the last week just because it was made three days ago from an old VOD
* Deduplicating clips with the same content
* Finding clips that happened right before or after a clip
Basically for almost anything you'd use created_at
for occured_at
would probably be better, having to do all of that with created_at
gives a terrible user experience as the results will be off from what a user wants or expects.
-
querySelectorAll commented
Please, I don't understand how this is not a feature yet. You guys even needed this for building the official clip viewer for the "Watch full video" link or retrieving the chat (basic features).
occurred_at or something like that is x100 times more useful than created_at so please provide both.
At least bring vod_offset back but something permanent like occurred_at is better for consistency in our apps (e.g. filtering).
Thanks for your work!