Channels

Retrieve channel information and status

Channels

Channels APIs provide access to information about livestreaming channels including their status, followers, and categories.

Get Channel

Retrieve information about a specific channel by its name.

Get Channel Followers

Retrieve followers for a specific channel.

Get Featured Channels

Retrieve a list of currently featured channels.

Get Channel

Retrieve detailed information about a specific channel by its name.

No authentication is required for this public endpoint.

Path Parameters

channelname · string · required

The name of the channel to retrieve

Response

channel · object

Show Channel object

id · integer

Unique ID of the channel

user_id · integer

ID of the user who owns the channel

name · string

Name of the channel

slug · string

URL-friendly identifier for the channel

verified · boolean

Whether the channel is verified

followers_count · integer

Number of followers the channel has

banner_image · string

URL to the channel’s banner image

profile_image · string

URL to the channel’s profile image

bio · string

Channel biography

is_live · boolean

Whether the channel is currently live

livestream · object

Show Livestream object (only present if is_live is true)

id · integer

ID of the current livestream

title · string

Title of the current livestream

viewers · integer

Current number of viewers

thumbnail · string

URL to the livestream thumbnail

category · object

Show Category object

id · integer

ID of the category

name · string

Name of the category

slug · string

URL-friendly identifier for the category

icon · string

URL to the category icon

created_at · string

Timestamp when the livestream started

Request

curl --request GET \
  --url "https://api.kick.com/public/v1/channels/streamername"

Response

{
  "channel": {
    "id": 12345,
    "user_id": 98765,
    "name": "streamername",
    "slug": "streamername",
    "verified": true,
    "followers_count": 50000,
    "banner_image": "https://kick-banners.s3.amazonaws.com/streamername.jpeg",
    "profile_image": "https://kick-profiles.s3.amazonaws.com/streamername.jpeg",
    "bio": "Professional streamer on Kick. Live daily with the best gaming content!",
    "is_live": true,
    "livestream": {
      "id": 987654,
      "title": "Friday Night Gaming Marathon!",
      "viewers": 12500,
      "thumbnail": "https://kick-livestreams.s3.amazonaws.com/streamername/thumbnail.jpeg",
      "category": {
        "id": 123,
        "name": "Just Chatting",
        "slug": "just-chatting",
        "icon": "https://kick-categories.s3.amazonaws.com/just-chatting.png"
      },
      "created_at": "2023-05-12T19:30:00Z"
    }
  }
}

Get Channel Followers

Retrieve a list of followers for a specific channel.

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

Path Parameters

channelname · string · required

The name of the channel to retrieve followers for

Query Parameters

limit · integer · default: "25"

Number of followers to return (max 100)

cursor · string

Pagination cursor for retrieving the next set of results

Response

data · array

Show Array of follower objects

user_id · integer

ID of the follower

username · string

Username of the follower

display_name · string

Display name of the follower

profile_picture · string

URL to the follower’s profile picture

followed_at · string

Timestamp when the user followed the channel

pagination · object

Show Pagination object

cursor · string

Cursor for the next page of results

has_more · boolean

Whether there are more results available

Request

curl --request GET \
  --url "https://api.kick.com/public/v1/channels/streamername/followers?limit=10" \
  --header "Authorization: Bearer {YOUR_TOKEN}"

Response

{
  "data": [
    {
      "user_id": 12345,
      "username": "follower1",
      "display_name": "Follower One",
      "profile_picture": "https://kick-profiles.s3.amazonaws.com/follower1.jpeg",
      "followed_at": "2023-05-01T14:30:00Z"
    },
    {
      "user_id": 23456,
      "username": "follower2",
      "display_name": "Follower Two",
      "profile_picture": "https://kick-profiles.s3.amazonaws.com/follower2.jpeg",
      "followed_at": "2023-05-01T13:45:00Z"
    },
    {
      "user_id": 34567,
      "username": "follower3",
      "display_name": "Follower Three",
      "profile_picture": "https://kick-profiles.s3.amazonaws.com/follower3.jpeg",
      "followed_at": "2023-05-01T13:30:00Z"
    }
  ],
  "pagination": {
    "cursor": "eyJpZCI6MTIzNDUsImZvbGxvd2VkX2F0IjoiMjAyMy0wNS0wMVQxMzozMDowMFoifQ==",
    "has_more": true
  }
}

Get Featured Channels

Retrieve a list of channels that are currently featured on the Kick platform.

No authentication is required for this public endpoint.

Query Parameters

limit · integer · default: "10"

Number of featured channels to return (max 50)

Response

featured_channels · array

Show Array of featured channel objects

channel · object

Show Channel object

id · integer

ID of the channel

name · string

Name of the channel

slug · string

URL-friendly identifier for the channel

profile_image · string

URL to the channel’s profile image

verified · boolean

Whether the channel is verified

livestream · object

Show Livestream object

id · integer

ID of the livestream

title · string

Title of the livestream

viewers · integer

Current number of viewers

thumbnail · string

URL to the livestream thumbnail

category · object

Show Category object

id · integer

ID of the category

name · string

Name of the category

feature_position · integer

Position in the featured channels list

Request

curl --request GET \
  --url "https://api.kick.com/public/v1/channels/featured?limit=3"

Response

{
  "featured_channels": [
    {
      "channel": {
        "id": 12345,
        "name": "topstreamer",
        "slug": "topstreamer",
        "profile_image": "https://kick-profiles.s3.amazonaws.com/topstreamer.jpeg",
        "verified": true
      },
      "livestream": {
        "id": 987654,
        "title": "Championship Tournament Finals!",
        "viewers": 75000,
        "thumbnail": "https://kick-livestreams.s3.amazonaws.com/topstreamer/thumbnail.jpeg",
        "category": {
          "id": 234,
          "name": "Fortnite"
        }
      },
      "feature_position": 1
    },
    {
      "channel": {
        "id": 23456,
        "name": "esportspro",
        "slug": "esportspro",
        "profile_image": "https://kick-profiles.s3.amazonaws.com/esportspro.jpeg",
        "verified": true
      },
      "livestream": {
        "id": 876543,
        "title": "Pro Gaming Challenge - Day 2",
        "viewers": 45000,
        "thumbnail": "https://kick-livestreams.s3.amazonaws.com/esportspro/thumbnail.jpeg",
        "category": {
          "id": 345,
          "name": "CS:GO"
        }
      },
      "feature_position": 2
    },
    {
      "channel": {
        "id": 34567,
        "name": "creativestudio",
        "slug": "creativestudio",
        "profile_image": "https://kick-profiles.s3.amazonaws.com/creativestudio.jpeg",
        "verified": true
      },
      "livestream": {
        "id": 765432,
        "title": "Art & Music Showcase",
        "viewers": 25000,
        "thumbnail": "https://kick-livestreams.s3.amazonaws.com/creativestudio/thumbnail.jpeg",
        "category": {
          "id": 456,
          "name": "Art"
        }
      },
      "feature_position": 3
    }
  ]
}