Add occured_at timestamps to Clips API
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.
* 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
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.
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!