Hey everyone,
Discovering the new Helix API at the moment, and I couldn’t help but notice some nasty changes from the Kraken API.
PS: the following examples are taken on the channel lirik.
Channels
/kraken/channels/lirik
{ "mature": false, "status": "Next Stream: Wednesday @ NOON EST / 5pm GMT ", "broadcaster_language": "en", "display_name": "LIRIK", "game": "Star Wars Battlefront II", "language": "en", "_id": 23161357, "name": "lirik", "created_at": "2011-06-27T18:34:45Z", "updated_at": "2017-11-14T23:06:03Z", "partner": true, "logo", "video_banner", "profile_banner", "profile_banner_background_color", "url": "https://www.twitch.tv/lirik", "views": 209278320, "followers": 1858542, "_links": {}, "delay": null, "banner": null, "background": null }
/helix/users?login=lirik
{ "data": [ { "id": "23161357", "login": "lirik", "display_name": "LIRIK", "type": "", "broadcaster_type": "partner", "description": "Your source for a good time, hilarity, and gaming!", "profile_image_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/lirik-profile_image-476e7a592cdfed74-300x300.png", "offline_image_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/lirik-channel_offline_image-af3bc6ef396c76ae-1920x1080.png", "view_count": 209278320 } ] }
/helix/users/follows?to_id=23161357
{ "data": [ { "from_id": "162731046", "to_id": "23161357", "followed_at": "2017-11-14T23:11:38Z" } ], "pagination": {} }
Videos
/kraken/videos/201221306
{ "title": "May The Micro transactions Be With You", "description", "description_html", "broadcast_id", "broadcast_type": "archive", "status": "recorded", "language": "en", "tag_list": "", "views": 1110, "created_at": "2017-11-14T17:05:23Z", "published_at": "2017-11-14T17:05:23Z", "url": "https://www.twitch.tv/videos/201221306", "_id": "v201221306", "recorded_at": "2017-11-14T17:05:23Z", "game": "Star Wars Battlefront II", "length": 21846, "preview", "animated_preview_url", "thumbnails": [{}], "fps": {}, "resolutions": {}, "channel": { "name": "lirik", "display_name": "LIRIK" }, "_links": {} }
/helix/videos?id=201221306
{ "data": [ { "id": "201221306", "user_id": "23161357", "title": "May The Micro transactions Be With You", "description": "", "created_at": "2017-11-14T17:05:23Z", "published_at": "2017-11-14T17:05:23Z", "url": "https://www.twitch.tv/videos/201221306", "thumbnail_url": "https://static-cdn.jtvnw.net/s3_vods/7714e9285d897ffd7322_lirik_26730077552_739300026/thumb/thumb0-%{width}x%{height}.jpg", "viewable": "public", "view_count": 1110, "language": "en" } ], "pagination": {} }
Conclusion/Thoughts
Based on the examples outputs below, we can see that the following data are changed:
- Many channel information disappeared: mature, language, broadcaster_language, created_at, updated_at, and most importantly, followers.
- The followers count indeed vanished, and we now have a
/follows
endpoint that requires us to do painful loops over results when dealing with highly followed users. - Many important video information disappeared too: game, length, recorded_at, broadcast_type, resolutions, fps, etc.
To conclude, with the new Helix APi, we at the moment got:
- A more difficult way to get a user’s followers
- No way to tell which game he played during a stream session / video
- No way at all to know how long the video was,
length
disappearing.
I coudldn’t find any information concerning future implementations of these data on the roadmap.
What do you think ?
Is there a way to get those missing data ?
Will it be implemented in the endpoints below in the future ?
Thanks for reading this whole block, difficult to digest; sorry mates !
Have a good day.