Kick Channel Goals API
A channel's follower and subscriber goals with their progress, status and dates in one JSON list.
GET /v1/kick/channels/{slug}/goals1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/kick/channels/{slug}/goals returns data.goals, an array of id, type, status, currentValue, targetValue, countsFromCreation, createdAt, endsAt and achievedAt. Progress is a pair of integers, so you can compute the remaining amount or a percentage from the response.
A channel with no goals returns lookupStatus: found and an empty goals array. An unknown channel returns lookupStatus: not_found and an empty array. The difference is in lookupStatus, not in the list length.
Kick Channel Goals API FAQ
What does a goal include?
Each goal has id, type, status, currentValue, targetValue, countsFromCreation, createdAt, endsAt and achievedAt. currentValue and targetValue are the progress pair.
How do I tell whether a channel has goals?
Read data.lookupStatus first, then data.goals.length. A found channel with no goals returns an empty array. A missing channel returns not_found with an empty array too.
What does countsFromCreation mean?
When countsFromCreation is true, progress counts from when the account or goal was created. When it is false, the current value covers a narrower period set by the channel.
How many credits does a goals list 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
- Gifter leaderboardGET /v1/kick/channels/{slug}/leaderboard
- Channel-point rewardsGET /v1/kick/channels/{slug}/rewards
- 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