# Update: /channels, /version/channels, and /live\_channels endpoint changes

**URL:** <https://staging-discuss.dev.twitch.com/t/update-channels-version-channels-and-live-channels-endpoint-changes/12002>\
**Category:** Extensions\
**Created:** [September 14, 2017, 6:40pm UTC](https://staging-discuss.dev.twitch.com/t/update-channels-version-channels-and-live-channels-endpoint-changes/12002 "2017-09-14T18:40:56Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![rbartlet](https://d1d6mrmdu7ztse.cloudfront.net/user_avatar/staging-discuss.dev.twitch.com/rbartlet/32/3219_2.png) [@rbartlet](https://staging-discuss.dev.twitch.com/u/rbartlet)\
**Post date:** [September 14, 2017, 6:40pm UTC](https://staging-discuss.dev.twitch.com/t/update-channels-version-channels-and-live-channels-endpoint-changes/12002/1 "2017-09-14T18:40:56Z")

</div>

Hello developers,

We are making some changes to the way several of our API endpoints function to ensure the continued stability and scalability of core extensions systems. We are making these changes because we have discovered that these endpoints, as designed, are not able to handle the volume of data necessary to serve their purpose.

Effective today, we will be disabling the following endpoints:

[https://api.twitch.tv/extensions/](https://api.twitch.tv/extensions/)[extension ID]/channels  
[https://api.twitch.tv/extensions/](https://api.twitch.tv/extensions/)/[version]/channels

In the near future, we will provide new endpoints with pagination to provide equivalent functionality. If you have any systems that query these endpoints, they will need to be updated to handle paginated data responses upon reactivation. Our documentation will be updated to reflect this when the updated endpoints are released.

Additionally, we want to give you a heads up that the /live\_channels endpoint will also be receiving a pagination update.

[https://api.twitch.tv/extensions/](https://api.twitch.tv/extensions/)/[version]/live\_channels

Because live\_channels serves a critical function for several live extensions, we will not be disabling it today, but will be announcing a small deprecation window upon the completion of a new, paginated version of the endpoint. We will be reaching out directly to affected developers to assist in the transition.

Thank you for your flexibility and continued support as we work to resolve these issues. This thread will be updated as new information becomes available.

---

<div class="post-metadata">

**Author:** ![tf2casperr](https://d1d6mrmdu7ztse.cloudfront.net/user_avatar/staging-discuss.dev.twitch.com/tf2casperr/32/9301_2.png) [@tf2casperr](https://staging-discuss.dev.twitch.com/u/tf2casperr)\
**Post date:** [September 19, 2017, 1:38pm UTC](https://staging-discuss.dev.twitch.com/t/update-channels-version-channels-and-live-channels-endpoint-changes/12002/2 "2017-09-19T13:38:58Z")

</div>

Hi @rbartlet thanks for the FYI. Is there currently any sort of analytics or other endpoint where we can see how many channels have our Extension installed? I can’t seem to find that figure anywhere and I assume the endpoints listed above would previously have given this information.

---

<div class="post-metadata">

**Author:** ![rbartlet](https://d1d6mrmdu7ztse.cloudfront.net/user_avatar/staging-discuss.dev.twitch.com/rbartlet/32/3219_2.png) [@rbartlet](https://staging-discuss.dev.twitch.com/u/rbartlet)\
**Post date:** [September 19, 2017, 3:42pm UTC](https://staging-discuss.dev.twitch.com/t/update-channels-version-channels-and-live-channels-endpoint-changes/12002/3 "2017-09-19T15:42:34Z")

</div>

Your assumption is correct. This was the intent behind these endpoints. We are working on getting new replacement endpoints available.

Before taking action on these three endpoints we looked at which ones were being actively used, in order to make a call about disabling versus depreciation. The live\_channels endpoint was actively used, so we have done what we can to provide continuity. The other two endpoints were not critical to the operation of any extension, so to minimise risk, we disabled them.

An update about a new live\_channels endpoint should be coming very soon.

I know that this is not the greatest answer, but it is something that we are trying to be transparent about and are actively working on.

---

<div class="post-metadata">

**Author:** ![mBeierl](https://d1d6mrmdu7ztse.cloudfront.net/user_avatar/staging-discuss.dev.twitch.com/mbeierl/32/3187_2.png) [@mBeierl](https://staging-discuss.dev.twitch.com/u/mBeierl)\
**Post date:** [September 19, 2017, 7:06pm UTC](https://staging-discuss.dev.twitch.com/t/update-channels-version-channels-and-live-channels-endpoint-changes/12002/4 "2017-09-19T19:06:13Z")

</div>

It would also be great to have some query parameters, e.g. filter by game, or sort by view\_count.

---

<div class="post-metadata">

**Author:** ![amzn-fielden](https://d1d6mrmdu7ztse.cloudfront.net/user_avatar/staging-discuss.dev.twitch.com/amzn-fielden/32/3351_2.png) [@amzn-fielden](https://staging-discuss.dev.twitch.com/u/amzn-fielden)\
**Post date:** [September 20, 2017, 12:26am UTC](https://staging-discuss.dev.twitch.com/t/update-channels-version-channels-and-live-channels-endpoint-changes/12002/5 "2017-09-20T00:26:32Z")

</div>

> [@rbartlet](#):
>
> The live\_channels endpoint was actively used, so we have done what we can to provide continuity. The other two endpoints were not critical to the operation of any extension, so to minimise risk, we disabled them.

This is definitely true, however one of the bigger attractions of the `https://api.twitch.tv/extensions/[extension ID]/channels` endpoint is the ability to run business analytics for those developers who would like to.

The data provided data is helpful/required to answer questions that are not entirely needed at runtime of the extension such as:

- How many broadcasters have installed my extension? (Today? This Week? Overall?)
- How many broadcasters have activated my extension?
- How many broadcasters have not activated my extension?

There’s a few things that may be helpful in addition to what was previously returned by the `/channels` endpoint. Note that most of these things are possible by running some offline analysis after pulling the `/channels` data on a regular interval or by stitching together multiple Twitch API calls, but there may be some common use cases that are worth solving in once place.

- State Change Timestamps  
This could also be a filter/parameter that limits the results. E.g. “Give me all [installs/activations/deactivations] since XYZ timestamp”
- Last Broadcast Timestamp  
As expected, the `/live_channels` endpoint is a snapshot in time and if you are trying to run analytics it’s likely that you will miss sections of your install base’s active/live time. Unless you pull the data frequently, which generates unnecessary server load 😉

Overall, I think the `/channels` and `/live_channels` endpoints are super helpful and serve distinct purposes. Excited to hear future updates.
