Kick hub

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}/goals

1 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.