Kick Gifter Leaderboard API
Who gifted the most subscriptions to a channel, for all time, this week and this month.
GET /v1/kick/channels/{slug}/leaderboard1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/kick/channels/{slug}/leaderboard returns data.leaderboard. Its enabled object says which boards the channel turns on: allTime, week and month. The allTime, week and month arrays each hold entries with username and quantity, the number of subscriptions that person gifted.
A board the channel has switched off comes back empty, so read enabled before treating an empty array as a problem. An unknown channel returns data.lookupStatus: not_found with leaderboard: null.
Kick Gifter Leaderboard API FAQ
Which leaderboards does this return?
All three in one answer: data.leaderboard.allTime, .week and .month. The enabled object tells you which ones the channel actually runs.
What is in a leaderboard entry?
Each entry has username and quantity. Quantity is the number of gifted subscriptions counted for that board. A switched-off board has an empty array.
Why is a board empty?
Check data.leaderboard.enabled first. The channel may have disabled that board, or nobody has gifted in the period. The response is still lookupStatus: found.
How many credits does a leaderboard lookup cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Kick endpoints
- ChannelGET /v1/kick/channels/{slug}
- VideosGET /v1/kick/channels/{slug}/videos
- Channel-point rewardsGET /v1/kick/channels/{slug}/rewards
- GoalsGET /v1/kick/channels/{slug}/goals
- EmotesGET /v1/kick/channels/{slug}/emotes
- Top channelsGET /v1/kick/top-channels
- Active chattersGET /v1/kick/channels/{slug}/chatters
- Channel clipsGET /v1/kick/channels/{slug}/clips