# Kick API — Kick.com channels, live streams and viewers, VODs, clips, chat history, leaderboards and categories

> A Kick channel's full card: followers, verified badge and date, affiliate, banned flag, subscription price (USD) and subscriber badges, bio, social handles with links, profile links / panels, profile picture and banners, created date, last username change, recent categories, the live stream if it is live (viewers, title, category, language, tags, playback link), chat mode, and the latest past broadcasts.
> ReefAPI engine `kick` · 37 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/kick/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/kick/v1/channel — 1 credit
A Kick channel's full card: followers, verified badge and date, affiliate, banned flag, subscription price (USD) and subscriber badges, bio, social handles with links, profile links / panels, profile picture and banners, created date, last username change, recent categories, the live stream if it is live (viewers, title, category, language, tags, playback link), chat mode, and the latest past broadcasts.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** id, user_id, slug, username, url, bio, profile_picture, banner_image, offline_banner_image, followers_count, is_live, is_verified, verified_at, is_banned, is_affiliate, vod_enabled, subscription_enabled, subscription_price_usd, can_host, muted, role, created_at, username_updated_at, socials{instagram, twitter, youtube, discord, tiktok, facebook: {handle, url}}, club, links[]{id, title, description, link, image, order, created_at, updated_at}, subscriber_badges[]{id, months, image}, follower_badges[], recent_categories[]{…}, livestream{livestream_id, vod_id, slug, title, viewers, show_viewer_count, started_at, language, language_code, caption_language_codes[], is_mature, tags[], category{id, name, slug, url, directory, tags[], viewers}, thumbnail, thumbnail_srcset, playback_url, chatroom_id, channel{id, slug, username, url, profile_picture}, url}, playback_url, chatroom{id, chat_mode, slow_mode, followers_only, subscribers_only, emotes_only, created_at}, recent_videos[]{uuid, vod_id, livestream_id, video_id, slug, title, url, started_at, ended_at, expires_at, created_at, duration_seconds, views (the VOD page's 'Views'), legacy_views, last_viewer_count, language, language_code, caption_language_codes[], is_mature, is_live, tags[], category{…}, categories[], thumbnail, source (HLS playlist), status, is_private, is_pruned, tier, channel{…}}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/channel_live — 1 credit
Is the channel live right now — and if so the stream's viewer count, title, category with its tags, language, mature flag, start time, thumbnail and the HLS playback link (signed by kick, valid for a limited time). One light call, built for polling.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{slug, url}, is_live, livestream{livestream_id, vod_id, slug, title, viewers, show_viewer_count, started_at, language, language_code, caption_language_codes[], is_mature, tags[], category{id, name, slug, url, directory, tags[], viewers}, thumbnail, thumbnail_srcset, playback_url, chatroom_id, channel{id, slug, username, url, profile_picture}, url} (null when offline)

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/channel_videos — 2 credits
A channel's past broadcasts (VODs) as kick lists them — the latest ones kick keeps (it does not page this list; 22 on the sample channel): title, start / end time, duration, views as the VOD page prints them, category, language, captions, VOD link, HLS source and when the VOD expires.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{id, slug, url}, count, videos[]{uuid, vod_id, livestream_id, video_id, slug, title, url, started_at, ended_at, expires_at, created_at, duration_seconds, views (the VOD page's 'Views'), legacy_views, last_viewer_count, language, language_code, caption_language_codes[], is_mature, is_live, tags[], category{…}, categories[], thumbnail, source (HLS playlist), status, is_private, is_pruned, tier, channel{…}}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/video — 2 credits
One past broadcast (VOD): by its uuid (`uuid` of channel_videos) or its kick.com link (`https://kick.com/xqc/videos/<id>`). Title, start / end, duration, views, category, language, HLS source, expiry and the channel.

**Parameters:**
- `video` (string, required) — A VOD uuid (`371f0495-9aaa-4e7a-b88e-22b50c6194b0`) or a kick.com video link (`https://kick.com/xqc/videos/01a1dc39-53f8-7a6d-9a47-80b450da6c52`).

**Returns:** uuid, vod_id, livestream_id, video_id, slug, title, url, started_at, ended_at, expires_at, created_at, duration_seconds, views (the VOD page's 'Views'), legacy_views, last_viewer_count, language, language_code, caption_language_codes[], is_mature, is_live, tags[], category{…}, categories[], thumbnail, source (HLS playlist), status, is_private, is_pruned, tier, channel{…}

**Example request body:**
```json
{
  "video": "371f0495-9aaa-4e7a-b88e-22b50c6194b0"
}
```

### POST https://api.reefapi.com/kick/v1/channel_clips — 1 credit
A channel's clips, most viewed or newest first, from all time / the last month / week / day: title, views, likes, duration, when it was made, its offset in the VOD, who clipped it, category and the video link. 20 per page with a cursor.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).
- `sort` (enum, optional, default "views") — views (default, most viewed first) or date (newest first). [one of: views, date]
- `period` (enum, optional) — Time window the clips were made in: all, month, week or day. [one of: all, month, week, day]
- `cursor` (string, optional) — The `next_cursor` of the previous page (leave empty for the first page).

**Returns:** channel{slug, url}, sort, period, count, next_cursor, clips[]{id, title, url, views, likes, duration_seconds, created_at, started_at, vod_offset_seconds, livestream_id, privacy, is_mature, video_url, clip_url, thumbnail, category{id, name, slug, url, directory}, creator{id, username, slug, url, profile_picture}, channel{id, slug, username, url, profile_picture}}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/clip — 1 credit
One clip by its id (`clip_01H811MXG4FBR62FXPE1AXABDH`) or its kick.com link: title, views, likes, duration, start time, VOD offset, creator, channel, category and the video link.

**Parameters:**
- `clip` (string, required) — A clip id or a kick.com clip link (`https://kick.com/xqc/clips/clip_…`).

**Returns:** id, title, url, views, likes, duration_seconds, created_at, started_at, vod_offset_seconds, livestream_id, privacy, is_mature, video_url, clip_url, thumbnail, category{id, name, slug, url, directory}, creator{id, username, slug, url, profile_picture}, channel{id, slug, username, url, profile_picture}

**Example request body:**
```json
{
  "clip": "clip_01H811MXG4FBR62FXPE1AXABDH"
}
```

### POST https://api.reefapi.com/kick/v1/clips — 1 credit
Kick's clip charts: the whole site's top clips, or one category's (`category`), most viewed or newest, from all time / month / week / day. 20 per page with a cursor. These chart rows carry no like count / privacy / VOD offset (the `clip` record has them).

**Parameters:**
- `category` (string, optional) — Only clips from this category: its slug (`just-chatting`), name or kick.com category link. Empty = the whole site.
- `sort` (enum, optional, default "views") — views (default, most viewed first) or date (newest first). [one of: views, date]
- `period` (enum, optional) — Time window: all, month, week or day (default day for the whole site, week for a category, as on kick.com). [one of: all, month, week, day]
- `cursor` (string, optional) — The `next_cursor` of the previous page (leave empty for the first page).

**Returns:** category{id, slug}, sort, period, count, next_cursor, clips[]{id, title, url, views, likes, duration_seconds, created_at, started_at, vod_offset_seconds, livestream_id, privacy, is_mature, video_url, clip_url, thumbnail, category{id, name, slug, url, directory}, creator{id, username, slug, url, profile_picture}, channel{id, slug, username, url, profile_picture}}

**Example request body:**
```json
{
  "category": "just-chatting"
}
```

### POST https://api.reefapi.com/kick/v1/chat_messages — 1 credit
A channel's chat history, live or offline: each message's text (emote codes listed), time, type, the sender's name, colour and badges (subscriber months, moderator, VIP, level…), plus the pinned message. 25 per page, newest first; `cursor` walks back in time, `start_time` jumps to a moment (e.g. a VOD timestamp).

**Parameters:**
- `channel` (string, required) — The channel: slug (`xqc`), display name, kick.com channel link, or its numeric channel id (`668`, the `id` of `channel`).
- `cursor` (string, optional) — The `next_cursor` of the previous page (leave empty for the first page).
- `start_time` (string, optional) — Return the messages around this moment, ISO-8601 UTC (`2026-11-15T03:00:00Z`).

**Returns:** channel{id, slug}, count, next_cursor, pinned_message{message, pinned_by, finish_at, duration_seconds}, messages[]{id, chatroom_id, type, content, emotes[]{id, name}, created_at, sender{id, username, slug, url, identity{color, badges[], badges_v2[]}}, metadata, thread_parent_id}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/chatters — 1 credit
Who is in a live channel's chat right now, by group: moderators, VIPs, OGs, bots and viewers (kick lists up to 100 viewers), plus the total chatter count.

**Parameters:**
- `channel` (string, required) — The channel: slug (`xqc`), display name, kick.com channel link, or its numeric channel id (`668`, the `id` of `channel`).

**Returns:** channel{id, slug}, total_count, moderators[], vips[], ogs[], bots[], chatters[] — each {username, slug, url, profile_picture}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/chat_user — 1 credit
One user's standing in a channel's chat, as the chat's user card shows it: channel owner / moderator / staff, badges (subscriber, founder, VIP, level…), following since, subscribed for N months, account created, and any active ban.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).
- `user` (string, required) — The user: slug, username or kick.com link.

**Returns:** id, username, slug, url, profile_picture, is_staff, is_channel_owner, is_moderator, badges[], badges_v2[], following_since, subscribed_for_months, created_at, banned

**Example request body:**
```json
{
  "channel": "xqc",
  "user": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/chatroom — 2 credits
A channel's chat settings — slow mode with its interval, followers-only with the minimum follow time, subscribers-only, emotes-only, minimum account age — the chat rules text and the pinned message.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{slug}, settings{id, slow_mode, slow_mode_interval_seconds, followers_only, followers_only_min_minutes, subscribers_only, emotes_only, account_age_required, account_age_min_minutes, show_quick_emotes, show_banners, gift_leaderboard_*_shown, pinned_message}, rules

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/leaderboards — 2 credits
A channel's two gift leaderboards — gifted subscriptions and Kicks (kick's virtual gifts) — each all-time / this month / this week, top 10 with username and quantity, and whether the channel shows each board.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{id, slug}, gifted_subscriptions{all_time[], month[], week[], *_shown}, kicks{all_time[], month[], week[], *_shown} — rows {rank, user_id, username, quantity}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/links — 1 credit
The links / panels on a channel's About tab: title, description, link, image, order.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{slug}, count, links[]{id, title, description, link, image, order, created_at, updated_at}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/emotes — 1 credit
A channel's own emotes (subscriber-only flag) plus kick's global emotes and emoji set, each with id, name and image link.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{id, slug}, channel_emotes[]{id, name, subscribers_only, image}, global_emotes[], emoji[]

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/recent_categories — 1 credit
The categories a channel streamed in recently (10 on the sample channel), with live viewers and tags.

**Parameters:**
- `channel` (string, required) — The channel: slug (`xqc`), display name, kick.com channel link, or its numeric channel id (`668`, the `id` of `channel`).

**Returns:** channel{id, slug}, count, categories[]{id, name, slug, url, directory{id, name, slug, icon}, tags[], viewers, followers_count, is_mature, description, banner, banner_srcset}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/poll — 1 credit
The channel's current chat poll (or the one that just ended): title, options with vote counts, duration, result display time. null when there is none.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{slug}, poll{title, options[]{id, label, votes}, duration, result_display_duration, has_voted, voted_option_id, remaining}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/prediction — 1 credit
The channel's latest channel-points prediction: title, state (active / locked / resolved / cancelled), each outcome's total points, voters, return rate and top predictors, the winning outcome and its times. null when none.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{slug}, prediction{id, title, state, outcomes[]{id, title, total_vote_amount, vote_count, return_rate, top_users[]}, winning_outcome_id, duration, created_at, updated_at, locked_at}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/goals — 1 credit
The channel's active goals (followers / subscriptions targets) with progress.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{slug}, count, goals[] (as kick publishes them)

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/rewards — 1 credit
The channel-point rewards viewers can redeem: title, cost, description, colour, enabled / paused, whether input is required.

**Parameters:**
- `channel` (string, required) — The channel: its slug as in the kick.com link (`xqc`), the display name (`xQc`) or any kick.com channel link (`https://kick.com/xqc/videos`).

**Returns:** channel{slug}, count, rewards[]{id, title, cost, description, is_enabled, is_paused, is_user_input_required, prompt, background_color, …}

**Example request body:**
```json
{
  "channel": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/livestreams — 1 credit
Every live stream on Kick, as the browse page lists them: most viewers first or kick's featured order, filtered by language(s), category(ies) and directory (games, irl, music, gambling, creative, alternative). Up to 100 per page, cursor-paged through the whole directory (11,171 live streams in 112 pages of 100 on 2026-11-16; past the end = 0 rows).

**Parameters:**
- `sort` (enum, optional, default "viewers_desc") — viewers_desc (default, most viewers first) or featured (kick's featured order). [one of: viewers_desc, featured]
- `language` (array, optional) — Stream language code(s) (`en`, `tr`, `es`…) or name(s) (`Turkish`); several = any of them. `languages` lists the codes.
- `category` (array, optional) — Category slug(s), name(s) or id(s) (`just-chatting`, `slots`, `15`); several = any.
- `directory` (array, optional) — Top-level directory: games, irl, music, gambling, creative, alternative; several = any.
- `limit` (integer, optional, default 24) — Streams per page, 1-100 (default 24, as on kick.com).
- `cursor` (string, optional) — The `next_cursor` of the previous page (leave empty for the first page).

**Returns:** sort, filters{}, count, next_cursor, previous_cursor, livestreams[]{livestream_id, vod_id, slug, title, viewers, show_viewer_count, started_at, language, language_code, caption_language_codes[], is_mature, tags[], category{id, name, slug, url, directory, tags[], viewers}, thumbnail, thumbnail_srcset, playback_url, chatroom_id, channel{id, slug, username, url, profile_picture}, url}

**Example request body:**
```json
{
  "limit": 24
}
```

### POST https://api.reefapi.com/kick/v1/featured_livestreams — 1 credit
The homepage's featured carousel for a language (about 14 streams).

**Parameters:**
- `language` (string, optional, default "en") — Language code (`en` default, `tr`, `es`…).

**Returns:** language, count, livestreams[]{livestream_id, vod_id, slug, title, viewers, show_viewer_count, started_at, language, language_code, caption_language_codes[], is_mature, tags[], category{id, name, slug, url, directory, tags[], viewers}, thumbnail, thumbnail_srcset, playback_url, chatroom_id, channel{id, slug, username, url, profile_picture}, url}

**Example request body:**
```json
{
  "language": "en"
}
```

### POST https://api.reefapi.com/kick/v1/top_gifted_livestreams — 1 credit
Live streams kick ranks as top-gifted right now (its gifted-subs shelf).

**Parameters:** none

**Returns:** count, livestreams[]{livestream_id, vod_id, slug, title, viewers, show_viewer_count, started_at, language, language_code, caption_language_codes[], is_mature, tags[], category{id, name, slug, url, directory, tags[], viewers}, thumbnail, thumbnail_srcset, playback_url, chatroom_id, channel{id, slug, username, url, profile_picture}, url}

### POST https://api.reefapi.com/kick/v1/viewer_count — 1 credit
The current viewer count of one live stream by its `vod_id` (from `livestreams`, `search` or `featured_livestreams`) — the lightest live poll Kick has (75 bytes).

**Parameters:**
- `vod_id` (string, required) — The stream's vod_id (`01a1de7d-b230-7f68-a65a-a25d3cf6028a`) or its kick.com VOD link.

**Returns:** vod_id, viewers, show_viewer_count

**Example request body:**
```json
{
  "vod_id": "01a1de7d-b230-7f68-a65a-a25d3cf6028a"
}
```

### POST https://api.reefapi.com/kick/v1/gift_leaderboard — 1 credit
Kick's site-wide gifted-subscription leaderboard for an hour, day, week or month: the top channels (receivers) or the top gifters, with count, rank, previous rank / count, live flag and profile picture.

**Parameters:**
- `board` (enum, optional, default "channels") — channels (default, who received the most gifted subs) or gifters (who gave the most). [one of: channels, gifters]
- `interval` (enum, optional, default "hourly") — hourly (default), daily, weekly or monthly. [one of: hourly, daily, weekly, monthly]
- `start_time` (string, optional) — Start of the period, ISO-8601 UTC (`2026-11-16T14:00:00Z`). Default = the start of the current hour / day / week (Monday) / month in UTC.
- `limit` (integer, optional, default 10) — How many, 1-50 (kick's maximum is 50).

**Returns:** board, interval, start_time, count, rows[]{rank, previous_rank, channel_id | gifter_id, slug, username, url, profile_picture, count, previous_count, is_live}

**Example request body:**
```json
{
  "start_time": "2026-11-16T00:00:00Z"
}
```

### POST https://api.reefapi.com/kick/v1/live_totals — 1 credit
How many channels are live on Kick right now and how many viewers they have in total.

**Parameters:** none

**Returns:** total_streamers, total_viewers

### POST https://api.reefapi.com/kick/v1/languages — 1 credit
Every stream language kick knows (code + name) and which ones the live directory can filter on right now.

**Parameters:** none

**Returns:** count, languages[]{code, name, live_filter}

### POST https://api.reefapi.com/kick/v1/top_channels — 1 credit
Kick's top channels list (the onboarding / sidebar list): followers, verified, live now.

**Parameters:**
- `limit` (integer, optional, default 60) — How many, 1-60 (kick's own maximum).

**Returns:** count, channels[]{id, slug, username, url, profile_picture, followers_count, is_live, is_verified}

### POST https://api.reefapi.com/kick/v1/categories — 1 credit
Kick's category catalogue (games and topics, 18,267 on 2026-11-16), most watched first, optionally inside one directory; page-numbered with the full total. Kick serves 20 pages per listing (640 rows at 32 per page).

**Parameters:**
- `directory` (enum, optional) — Only this directory: games, irl, music, gambling, creative, alternative. [one of: games, irl, music, gambling, creative, alternative]
- `page` (integer, optional, default 1) — Page 1-20: kick serves the first 20 pages only (a higher page returns page 20 again), so one listing reaches 640 categories at 32 per page; narrow by `directory` for more.
- `limit` (integer, optional, default 24) — Categories per page, 1-32 (kick's maximum is 32).

**Returns:** directory, total (kick's full count), total_pages, reachable, total_is_capped, page, per_page, has_more, categories[]{id, name, slug, url, directory{id, name, slug, icon}, tags[], viewers, followers_count, is_mature, description, banner, banner_srcset}

### POST https://api.reefapi.com/kick/v1/category — 1 credit
One category: live viewers, followers, tags, description, directory, banner.

**Parameters:**
- `category` (string, required) — Category slug (`just-chatting`), name or kick.com category link.

**Returns:** id, name, slug, url, directory{id, name, slug, icon}, tags[], viewers, followers_count, is_mature, description, banner, banner_srcset

**Example request body:**
```json
{
  "category": "just-chatting"
}
```

### POST https://api.reefapi.com/kick/v1/top_categories — 1 credit
The most watched categories right now (30), optionally inside directories.

**Parameters:**
- `directory` (array, optional) — Only these directories: games, irl, music, gambling, creative, alternative.

**Returns:** count, categories[]{id, name, slug, url, directory{id, name, slug, icon}, tags[], viewers, followers_count, is_mature, description, banner, banner_srcset}

**Example request body:**
```json
{
  "directory": "games"
}
```

### POST https://api.reefapi.com/kick/v1/directories — 1 credit
Kick's six top-level directories (Games, IRL, Music, Gambling, Creative, Alternative) with their ids, slugs and icons.

**Parameters:** none

**Returns:** count, directories[]{id, name, slug, icon}

### POST https://api.reefapi.com/kick/v1/search — 1 credit
What kick.com's search box shows for a query: matching channels (followers, live, verified), categories and live streams.

**Parameters:**
- `query` (string, required) — What to search for (`xqc`, `slots`).

**Returns:** query, channels[]{id, slug, username, url, profile_picture, followers_count, is_live, is_verified}, categories[]{…}, livestreams[]{…}

**Example request body:**
```json
{
  "query": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/search_channels — 1 credit
Search Kick channels by name, as kick.com's search page lists them (best match first): followers, live now, verified, profile picture; live-only or offline-only. One page of up to 100 — kick's search does not page further.

**Parameters:**
- `query` (string, required) — Name to look for.
- `is_live` (boolean, optional) — true = only channels live now, false = only offline ones.
- `limit` (integer, optional, default 20) — How many, 1-100 (default 20).

**Returns:** query, is_live, count, channels[]{id, slug, username, url, profile_picture, followers_count, is_live, is_verified}

**Example request body:**
```json
{
  "query": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/search_categories — 1 credit
Search Kick categories by name: live viewers, tags, mature flag, thumbnail. One page of up to 100 — kick's search does not page further.

**Parameters:**
- `query` (string, required) — Name to look for.
- `limit` (integer, optional, default 20) — How many, 1-100 (default 20).

**Returns:** query, count, categories[]{id, name, slug, url, tags[], viewers, is_mature, banner, banner_srcset}

**Example request body:**
```json
{
  "query": "xqc"
}
```

### POST https://api.reefapi.com/kick/v1/events — 1 credit
Kick events (multi-channel community events) as the events page lists them: title, phase, start, category, languages, organiser, number of live streams and participants, total views, artwork.

**Parameters:** none

**Returns:** count, events[] (as kick publishes them; dates ISO)

### POST https://api.reefapi.com/kick/v1/event — 2 credits
One Kick event with its live streams (channel, title, viewers, language).

**Parameters:**
- `event` (string, required) — The event id (`id` of `events`).

**Returns:** event{…}, count, streams[]{channel{id, slug, url, is_verified}, user{id, username, profile_picture}, livestream{vod_id, title, viewers, language, is_mature, thumbnail}}

**Example request body:**
```json
{
  "event": "01a1c950-f486-75c0-888b-7d4adb5b26cf"
}
```

### POST https://api.reefapi.com/kick/v1/drops — 1 credit
Kick drop campaigns: game, organisation, rewards with the watch minutes each needs, start / end, status, participating channels.

**Parameters:** none

**Returns:** count, campaigns[] (as kick publishes them; dates ISO)

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=kick
- Human docs page: https://reefapi.com/docs/kick
- Overview page: https://reefapi.com/kick-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
