Contents

Channel Feed Reference

Endpoint Description
Get Multiple Feed Posts

Gets posts from a specified channel feed.

Get Feed Post

Gets a specified post from a specified channel feed.

Create Feed Post

Creates a post in a specified channel feed. The content of the post is specified in the request body, with a required content parameter.

Delete Feed Post

Deletes a specified post in a specified channel feed.

Create Reaction to a Feed Post

Creates a reaction to a specified post in a specified channel feed. The reaction is specified by an emote value, which is either an ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Delete Reaction to a Feed Post

Deletes a specified reaction to a specified post in a specified channel feed. The reaction is specified by an emote ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Get Feed Comments

Gets all comments on a specified post in a specified channel feed.

Create Feed Comment

Creates a comment to a specified post in a specified channel feed. The comment content can be specified either as a query-string parameter or in the request body (in x-www-form-urlencoded format).

Delete Feed Comment

Deletes a specified comment on a specified post in a specified channel feed.

Create Reaction to a Feed Comment

Creates a reaction to a specified comment on a specified post in a specified channel feed. The reaction is specified by an emote value, which is either an ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Delete Reaction to a Feed Comment

Deletes a reaction to a specified comment on a specified post in a specified channel feed. The reaction is specified by an emote value, which is either an ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Get Multiple Feed Posts

Gets posts from a specified channel feed.

Authentication

Optional scope: any scope

URL

GET https://api.twitch.tv/kraken/feed/<channel ID>/posts

Optional Query String Parameters

Name Type Description
limit long Maximum number of most-recent objects to return. Default: 10. Maximum: 100.
cursor string Tells the server where to start fetching the next set of results in a multi-page response.

Example Request

This gets the most recent post from channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X GET 'https://api.twitch.tv/kraken/feed/44322889/posts?limit=1'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}

Get Feed Post

Gets a specified post from a specified channel feed.

Authentication

Optional scope: any scope

URL

GET https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>

Optional Query String Parameters

None

Example Request

This gets post 1341393b-e872-4554-9f6f-acd5f8b669fc from channel feed 44322889, including the 5 most recent comments on the post.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X GET 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc?comments=5'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}

Create Feed Post

Creates a post in a specified channel feed.

The content of the post is specified in the request body, with a required content parameter.

Authentication

Required scope: channel_feed_edit

URL

POST https://api.twitch.tv/kraken/feed/<channel ID>/posts

Optional Query String Parameter

Name Type Description
share boolean When set to true, the post is shared on the channel’s Twitter feed (if connected), with a link to the post’s URL.

Example Request

This creates a test post on the 44322889 channel.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-H 'Content-Type: application/json' \
-d '{"content": "Another test post Kappa"}' \
-X POST 'https://api.twitch.tv/kraken/feed/44322889/posts'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}

Delete Feed Post

Deletes a specified post in a specified channel feed.

Authentication

Required scope: channel_feed_edit

URL

DELETE https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>

Optional Query String Parameters

None

Example Request

This deletes post 1341393b-e872-4554-9f6f-acd5f8b669fc from channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X DELETE 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}

Create Reaction to a Feed Post

Creates a reaction to a specified post in a specified channel feed. The reaction is specified by an emote value, which is either an ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Authentication

Required scope: channel_feed_edit

URL

POST https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/reactions?emote_id=<emote value>

Optional Query String Parameters

None

Example Request

This creates a reaction (emote 25) to post 1341393b-e872-4554-9f6f-acd5f8b669fc in channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X POST 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc/reactions?emote_id=25'

Example Response

{
   "created_at": "2016-11-29T15:51:12Z",
   "emote_id": "25",
   "id": "24989127",
   "user": {
      "_id": "44322889",
      "bio": "Just a gamer playing games and chatting. :)",
      "created_at": "2013-06-03T19:12:02.580593Z",
      "display_name": "dallas",
      "logo": "https://static-cdn.jtvnw.net/jtv_user_pictures/dallas-profile_image-1a2c906ee2c35f12-300x300.png",
      "name": "dallas",
      "type": "staff",
      "updated_at": "2017-01-05T15:32:01.74986Z"
   }
}

Delete Reaction to a Feed Post

Deletes a specified reaction to a specified post in a specified channel feed. The reaction is specified by an emote ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Authentication

Required scope: channel_feed_edit

URL

DELETE https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/reactions?emote_id=<emote value>

Optional Query String Parameters

None

Example Request

This deletes the authenticated user’s reaction (with emote ID 25) to post 1341393b-e872-4554-9f6f-acd5f8b669fc in channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X DELETE 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc/reactions?emote_id=25'

Example Response

{
    "deleted": true
}

Get Feed Comments

Gets all comments on a specified post in a specified channel feed.

Authentication

Optional scope: any scope

URL

GET https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/comments

Optional Query String Parameters

Name Type Description
limit long Maximum number of most-recent objects to return. Default: 10. Maximum: 100.
cursor string Tells the server where to start fetching the next set of results, in a multi-page response.

Example Request

This gets the most recent comment on post 1341393b-e872-4554-9f6f-acd5f8b669fc in channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X GET 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc/comments?limit=1'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}

Create Feed Comment

Creates a comment to a specified post in a specified channel feed.

The comment content can be specified either as a query-string parameter or in the request body (in x-www-form-urlencoded format).

Authentication

Required scope: channel_feed_edit

URLs

POST https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/comments?content=<content string>

POST https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/comments

Required Query String or Request Body Parameter

Name Type Description
content string Comment to be created.

Example Request

This creates a test comment to post 1341393b-e872-4554-9f6f-acd5f8b669fc in channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-H 'Content-Type: application/json' \
-d '{"content": "A test comment Kappa"}' \
-X POST 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc/comments'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": warning: this endpoint has been deprecated"
}

Delete Feed Comment

Deletes a specified comment on a specified post in a specified channel feed.

Authentication

Required scope: channel_feed_edit

URL

DELETE https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/comments/<comment ID>

Optional Query String Parameters

None

Example Request

This deletes comment 132989 on post 1341393b-e872-4554-9f6f-acd5f8b669fc in channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X DELETE 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc/comments/132989'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}

Create Reaction to a Feed Comment

Creates a reaction to a specified comment on a specified post in a specified channel feed. The reaction is specified by an emote value, which is either an ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Authentication

Required scope: channel_feed_edit

URL

POST https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/comments/<comment ID>/reactions?emote_id=<emote value>

Optional Query String Parameters

None

Example Request

This creates a reaction (with emote ID 25) to comment 132989 on post 1341393b-e872-4554-9f6f-acd5f8b669fc in channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X POST 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc/comments/132989/reactions?emote_id=25'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}

Delete Reaction to a Feed Comment

Deletes a reaction to a specified comment on a specified post in a specified channel feed. The reaction is specified by an emote value, which is either an ID (for example, “25” is Kappa) or the string “endorse” (which corresponds to a default face emote).

Authentication

Required scope: channel_feed_edit

URL

DELETE https://api.twitch.tv/kraken/feed/<channel ID>/posts/<post ID>/comments/<comment ID>/reactions?emote_id=<emote value>

Optional Query String Parameters

None

Example Request

This deletes the reaction with emote ID 25 to comment 132989 on post 1341393b-e872-4554-9f6f-acd5f8b669fc in channel feed 44322889.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-H 'Authorization: OAuth cfabdegwdoklmawdzdo98xt2fo512y' \
-X DELETE 'https://api.twitch.tv/kraken/feed/44322889/posts/1341393b-e872-4554-9f6f-acd5f8b669fc/comments/132989/reactions?emote_id=25'

Example Response

HTTP 410 Gone
{
   "error": "Gone",
   "status": 410,
   "message": "warning: this endpoint has been deprecated"
}
+