> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/kick/channels-slug-leaderboard>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/kick/channels-slug-leaderboard.mdx>

---

# 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}/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`.

## Request

- **Endpoint:** `GET /v1/kick/channels/{slug}/leaderboard`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by slug
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/kick/channels/slug/leaderboard/get)
- **Platform page:** [/platforms/kick](https://www.socialfetch.dev/platforms/kick)

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