Skip to main content
GET
List Live Categories
Returns the live categories a host can pick when going live, in display order. Use it to build a category picker, then pass the chosen category’s id as live_category_id to Go Live (POST /2/broadcasts). The whole list is returned in one response: there are no query parameters and no paging. The list is the same for every user.
This example is shortened to three categories. meta.result_count is the number of categories in data.

Using the list

  • Store the id, show the name. Ids are permanent. Names can change, so read the current name from this route instead of saving it.
  • Keep the order. Categories are returned in the order to display them.
  • Don’t hard-code the list. Categories can be added, so fetch the list instead of shipping a copy of it. An id that isn’t in the list is rejected by Go Live with 400.

Authentication and rate limit

Requires user context authentication: OAuth 2.0 with the broadcast.read scope, or OAuth 1.0a. The route allows 450 requests per 15 minutes per user.

Errors

Errors use the standard X API problem format.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

broadcast.read

View your live broadcasts and their chat.

Response

The request has succeeded.

data
object[]
errors
object[]
meta
object