Livestreams

Retrieve information about active livestreams

Livestreams

Livestreams APIs allow you to get information about active livestreams on the Kick platform.

Get Livestreams

Retrieve a list of livestreams based on filtering criteria.

Get Livestreams

This endpoint requires authentication using a bearer token with the livestreams:read scope.

Request Parameters

broadcaster_user_id · integer

Filter livestreams by broadcaster user ID

category_id · integer

Filter livestreams by category ID

language · string

Filter livestreams by language (ISO 639-1 code)

limit · integer · default: "25"

Number of results to return (max 100)

sort · string · default: "viewers_desc"

Sort order for results. Options: viewers_desc, viewers_asc, recently_started

Response

data · array

Show Array of livestream objects

id · integer

Unique ID of the livestream

broadcaster · object

Show Broadcaster object

id · integer

User ID of the broadcaster

username · string

Username of the broadcaster

profile_picture · string

URL to the broadcaster’s profile picture

channel · object

Show Channel object

id · integer

Channel ID

slug · string

Channel slug

follower_count · integer

Number of followers

title · string

Title of the livestream

viewer_count · integer

Current number of viewers

thumbnail · object

Show Thumbnail object

url · string

URL to the livestream thumbnail

category · object

Show Category object

id · integer

Category ID

name · string

Category name

slug · string

Category slug

icon · string

URL to the category icon

created_at · string

Timestamp when the livestream started

message · string

Response status message

Request

curl --request GET \
  --url "https://api.kick.com/public/v1/livestreams?category_id=1&limit=10&sort=viewers_desc" \
  --header "Authorization: Bearer {YOUR_TOKEN}"

Response

{
  "data": [
    {
      "id": 12345,
      "broadcaster": {
        "id": 67890,
        "username": "topstreamer",
        "profile_picture": "https://kick-profiles.s3.amazonaws.com/12345.jpeg"
      },
      "channel": {
        "id": 54321,
        "slug": "topstreamer",
        "follower_count": 25000
      },
      "title": "Playing the newest games with friends!",
      "viewer_count": 8542,
      "thumbnail": {
        "url": "https://stream-thumbnails.s3.amazonaws.com/12345.jpeg"
      },
      "category": {
        "id": 1,
        "name": "Just Chatting",
        "slug": "just-chatting",
        "icon": "https://kick-categories.s3.amazonaws.com/just-chatting.png"
      },
      "created_at": "2023-06-15T18:30:00Z"
    },
    {
      "id": 23456,
      "broadcaster": {
        "id": 78901,
        "username": "gamergirl",
        "profile_picture": "https://kick-profiles.s3.amazonaws.com/23456.jpeg"
      },
      "channel": {
        "id": 65432,
        "slug": "gamergirl",
        "follower_count": 18750
      },
      "title": "Late night gaming session!",
      "viewer_count": 6321,
      "thumbnail": {
        "url": "https://stream-thumbnails.s3.amazonaws.com/23456.jpeg"
      },
      "category": {
        "id": 1,
        "name": "Just Chatting",
        "slug": "just-chatting",
        "icon": "https://kick-categories.s3.amazonaws.com/just-chatting.png"
      },
      "created_at": "2023-06-15T20:15:00Z"
    }
  ],
  "message": "Livestreams retrieved successfully"
}