Kick API & Scraper
This API reads kick.com, the live-streaming platform, as JSON, logged out.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`livestreams` lists every stream that is live right now, most viewers first or in Kick's featured order, filtered by language, category and directory (games, irl, music, gambling, creative, alternative), up to 100 per page and cursor-paged through the whole directory (11,350 live channels and 890,777 viewers at one moment on 2026-11-16, from `live_totals`). `channel` returns a channel's full card: followers, verified badge and date, affiliate flag, subscription price in USD and subscriber badges, bio, social handles with links, profile links, banners, creation date, last username change, recent categories, the live stream if it is live and the latest past broadcasts. `channel_live` is a light live check with viewers, title, category, language and the HLS playback link. `channel_videos` and `video` return past broadcasts (VODs) with the views the VOD page prints, duration, category, captions, the VOD link and when it expires. `channel_clips`, `clips` and `clip` return clips (views, likes, duration, creator, VOD offset). `chat_messages` returns a channel's chat history (25 per page, walking back in time, or around a timestamp) with each sender's badges; `chatters` lists who is in chat by group; `chat_user` shows one viewer's standing in a chat. `viewer_count` is the lightest live poll (one stream's viewers, 74 bytes). `leaderboards` returns a channel's gifted-subscription and Kicks gift leaderboards and `gift_leaderboard` Kick's site-wide hourly, daily, weekly or monthly ranking of the channels receiving and the users giving the most gifted subscriptions; `poll`, `prediction`, `goals` and `rewards` return the channel's interactive features. `categories`, `category`, `top_categories` and `directories` cover Kick's catalogue of about 18,000 categories; `search`, `search_channels` and `search_categories` are Kick's own search; `events` and `drops` list Kick events and drop campaigns.
What a Kick field actually contains
Fields that read differently from how they look. Every row was measured against live kick.com on 2026-11-16.
| Field | What it holds |
|---|---|
| followers_count | The channel's follower count from Kick's channel record. In 27 reads of a channel and its kick.com page in the same second, 6 matched the page's own figure exactly and 21 were 1 to 247 higher (the page shows a slightly older copy; largest gap 247 of 2,629,600, 0.009 %). |
| viewers (live streams) | Kick's current viewer count for the stream. Against the number on the channel's own page read within two seconds: 15 reads of live channels, 4 identical, the rest within -7.9 % to +5.4 % (the count moves every few seconds). |
| views (VODs) | The figure the VOD page prints as Views: 16 reads of 8 VODs, 9 identical and 7 within 4 to 39 views (0.02 %). legacy_views is a second, lower counter Kick also publishes (29-36 % lower); last_viewer_count is a third one. |
| views (clips) | The figure the clip page prints as Views: 16 reads, all within 0 to 2 (opening the page adds a view). |
| started_at, created_at | started_at is the stream's start time. channel_live returns the stream record's created_at (Kick does not print a start time there). |
| vod_id, livestream_id, uuid | A live stream and its VOD share vod_id (the id in kick.com/<channel>/videos/<id>). livestream_id is Kick's numeric stream id; uuid identifies a VOD in the `video` action. |
| subscription_price_usd | The channel's monthly subscription price as Kick lists it (4.99 on the sample channel); null when subscriptions are off. |
| playback_url | The HLS playlist of the live stream, signed by Kick for a limited time. It only plays while the channel is live. |
| clip started_at | When the clipped moment began. Clip lists print an empty date for it; the `clip` record carries the real time. |
Every filter was checked on 2026-11-16 by comparing unfiltered and filtered results in the same minute; options Kick accepts but ignores (ascending viewer sort, stream tags, category-search live filter) are not offered.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/kick/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "xqc"
}
}{
"ok": true,
"meta": {
"api": "kick",
"endpoint": "search",
"mode": "live",
"latency_ms": 936,
"record_count": 12,
"bytes": 4028,
"cache_hit": false,
"channels": 10,
"categories": 0,
"livestreams": 2,
"upstream_requests": 1,
"charged_credits": 1,
"version": "1.0.0",
"request_id": "b8eafec0888840a9",
"queue_ms": 2.6,
"fetched_at": "2026-11-16T15:58:08.990Z"
},
"data": {
"query": "xqc",
"channels": [
{
"id": 668,
"slug": "xqc",
"username": "xQc",
"url": "https://kick.com/xqc",
"profile_picture": "https://files.kick.com/images/user/676/profile_image/conversion/931b4e8f-5445-427c-bd82-b473530390cc-medium.webp",
"is_live": false,
"is_verified": true,
"followers_count": 1655328
},
{
"id": 122879734,
"slug": "xqc247",
"username": "xQc247",
"url": "https://kick.com/xqc247",
"profile_picture": "https://files.kick.com/images/user/124136666/profile_image/a6389dda-605d-45cb-996d-c93f2878f4e1",
"is_live": false,
"is_verified": true,
"followers_count": 134
},
{
"id": 30505,
"slug": "xqcl",
"username": "xqcl",
"url": "https://kick.com/xqcl",
"profile_picture": null,
"is_live": false,
"is_verified": false,
"followers_count": 19
}
],
"categories": [],
"livestreams": [
{
"livestream_id": null,
"vod_id": "01a1e3bb-2070-7ddd-9f5e-783b6b632885",
"slug": null,
"title": "Adin Ross, davooxeneize, lacobraaa, SXB, MrStivenTC, spreen, drb7h, RRaenee, Elzeein, xQc, Mellstroy475, maherco, Trainwreckstv",
"viewers": 3,
"show_viewer_count": true,
"started_at": "2026-11-16T09:40:54Z",
"created_at": null,
"language": null,
"language_code": "en",
"caption_language_codes": null,
"is_mature": false,
"tags": [],
"category": {
"id": 15,
"name": "Just Chatting",
"slug": "just-chatting",
"url": "https://kick.com/category/just-chatting",
"directory": null
},
"categories": null,
"thumbnail": "https://images.kick.com/video_thumbnails/3Pn3uvDF0w8e/4PLx9v6BRXoY/720.webp",
"thumbnail_srcset": "https://images.kick.com/video_thumbnails/3Pn3uvDF0w8e/4PLx9v6BRXoY/1080.webp 1920w, https://images.kick.com/video_thumbnails/3Pn3uvDF0w8e/4PLx9v6BRXoY/720.webp 1280w, https://images.kick.com/video_thumbnails/3Pn3uvDF0w8e/4PLx9v6BRXoY/480.webp 640w, https://images.kick.com/video_thumbnails/3Pn3uvDF0w8e/4PLx9v6BRXoY/360.webp 480w, https://images.kick.com/video_thumbnails/3Pn3uvDF0w8e/4PLx9v6BRXoY/160.webp 284w",
"playback_url": null,
"chatroom_id": null,
"channel": {
"id": 138128466,
"slug": "grandbool",
"username": "Grandbool",
"url": "https://kick.com/grandbool",
"profile_picture": "https://files.kick.com/images/user/1001105393/profile_image/conversion/3198306f-6f58-464f-91cb-d2870214b9aa-medium.webp"
},
"url": "https://kick.com/grandbool"
},
{
"livestream_id": null,
"vod_id": "01a1e305-4d90-7457-b2a3-51ed4ab301de",
"slug": null,
"title": "24/7 STREAM UNTIL 100KSUBS FACEREVEAL AT END..\n\n\nADIN ROSS SIGN ME!!!!!\n\n\nANY STREAMER WANNA SPAR\n\nEDDIE SIGN ME\n\nADIN ROSS SIGN ME !\nXQC!!!",
"viewers": 2,
"show_viewer_count": true,
"started_at": "2026-11-16T06:22:18Z",
"created_at": null,
"language": null,
"language_code": "en",
"caption_language_codes": null,
"is_mature": false,
"tags": [],
"category": {
"id": 15,
"name": "Just Chatting",
"slug": "just-chatting",
"url": "https://kick.com/category/just-chatting",
"directory": null
},
"categories": null,
"thumbnail": "https://images.kick.com/video_thumbnails/JSdGtBZcz1Kt/ziqKxQbyxWDV/720.webp",
"thumbnail_srcset": "https://images.kick.com/video_thumbnails/JSdGtBZcz1Kt/ziqKxQbyxWDV/1080.webp 1920w, https://images.kick.com/video_thumbnails/JSdGtBZcz1Kt/ziqKxQbyxWDV/720.webp 1280w, https://images.kick.com/video_thumbnails/JSdGtBZcz1Kt/ziqKxQbyxWDV/480.webp 640w, https://images.kick.com/video_thumbnails/JSdGtBZcz1Kt/ziqKxQbyxWDV/360.webp 480w, https://images.kick.com/video_thumbnails/JSdGtBZcz1Kt/ziqKxQbyxWDV/160.webp 284w",
"playback_url": null,
"chatroom_id": null,
"channel": {
"id": 3305907,
"slug": "superisaac",
"username": "Superisaac",
"url": "https://kick.com/superisaac",
"profile_picture": "https://files.kick.com/images/user/3372060/profile_image/conversion/1b59c163-f965-4a98-b455-dfcc97d61dbf-medium.webp"
},
"url": "https://kick.com/superisaac"
}
]
}
}What the Kick API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| channel | 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. | Social-listening tools call channel to get a Kick channel's full card. | channel |
| channel_live | 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. | Creator and influencer platforms call channel_live to get is the channel live right now. | channel |
| channel_videos | 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. | Brand-monitoring teams call channel_videos to get a channel's past broadcasts (VODs) as kick lists them. | channel |
| video | 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. | Audience analysts call video to get one past broadcast (VOD). | video |
| channel_clips | 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. | Social-listening tools call channel_clips to get a channel's clips, most viewed or newest first, from all time / the last month / week / day. | channel, sort, period, cursor |
| clip | 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. | Creator and influencer platforms call clip to get one clip by its id (`clip_01H811MXG4FBR62FXPE1AXABDH`) or its kick.com link. | clip |
| clips | 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). | Brand-monitoring teams call clips to get kick's clip charts. | category, sort, period, cursor |
| chat_messages | 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). | Audience analysts call chat_messages to get a channel's chat history, live or offline. | channel, cursor, start_time |
| chatters | 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. | Social-listening tools call chatters to get who is in a live channel's chat right now, by group. | channel |
| chat_user | 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. | Creator and influencer platforms call chat_user to get one user's standing in a channel's chat, as the chat's user card shows it. | channel, user |
| chatroom | 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. | Brand-monitoring teams call chatroom to get a channel's chat settings. | channel |
| leaderboards | 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. | Audience analysts call leaderboards to get a channel's two gift leaderboards. | channel |
| links | The links / panels on a channel's About tab: title, description, link, image, order. | Social-listening tools call links to get the links / panels on a channel's About tab. | channel |
| emotes | A channel's own emotes (subscriber-only flag) plus kick's global emotes and emoji set, each with id, name and image link. | Creator and influencer platforms call emotes to get a channel's own emotes (subscriber-only flag) plus kick's global emotes and emoji set, each w…. | channel |
| recent_categories | The categories a channel streamed in recently (10 on the sample channel), with live viewers and tags. | Brand-monitoring teams call recent_categories to get the categories a channel streamed in recently (10 on the sample channel), with live viewers a…. | channel |
| poll | 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. | Audience analysts call poll to get the channel's current chat poll (or the one that just ended). | channel |
| prediction | 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. | Social-listening tools call prediction to get the channel's latest channel-points prediction. | channel |
| goals | The channel's active goals (followers / subscriptions targets) with progress. | Creator and influencer platforms call goals to get the channel's active goals (followers / subscriptions targets) with progress.. | channel |
| rewards | The channel-point rewards viewers can redeem: title, cost, description, colour, enabled / paused, whether input is required. | Brand-monitoring teams call rewards to get the channel-point rewards viewers can redeem. | channel |
| livestreams | 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). | Audience analysts call livestreams to get every live stream on Kick, as the browse page lists them. | sort, language, category, directory, limit, ... |
| featured_livestreams | The homepage's featured carousel for a language (about 14 streams). | Social-listening tools call featured_livestreams to get the homepage's featured carousel for a language (about 14 streams).. | language |
| top_gifted_livestreams | Live streams kick ranks as top-gifted right now (its gifted-subs shelf). | Creator and influencer platforms call top_gifted_livestreams to get live streams kick ranks as top-gifted right now (its gifted-subs shelf).. | none |
| viewer_count | 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). | Brand-monitoring teams call viewer_count to get the current viewer count of one live stream by its `vod_id` (from `livestreams`, `search` or…. | vod_id |
| gift_leaderboard | 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. | Audience analysts call gift_leaderboard to get kick's site-wide gifted-subscription leaderboard for an hour, day, week or month. | board, interval, start_time, limit |
| live_totals | How many channels are live on Kick right now and how many viewers they have in total. | Social-listening tools call live_totals to get how many channels are live on Kick right now and how many viewers they have in total.. | none |
| languages | Every stream language kick knows (code + name) and which ones the live directory can filter on right now. | Creator and influencer platforms call languages to get every stream language kick knows (code + name) and which ones the live directory can filter o…. | none |
| top_channels | Kick's top channels list (the onboarding / sidebar list): followers, verified, live now. | Brand-monitoring teams call top_channels to get kick's top channels list (the onboarding / sidebar list). | limit |
| categories | 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). | Audience analysts call categories to get kick's category catalogue (games and topics, 18,267 on 2026-11-16), most watched first, optio…. | directory, page, limit |
| category | One category: live viewers, followers, tags, description, directory, banner. | Social-listening tools call category to get one category. | category |
| top_categories | The most watched categories right now (30), optionally inside directories. | Creator and influencer platforms call top_categories to get the most watched categories right now (30), optionally inside directories.. | directory |
| directories | Kick's six top-level directories (Games, IRL, Music, Gambling, Creative, Alternative) with their ids, slugs and icons. | Brand-monitoring teams call directories to get kick's six top-level directories (Games, IRL, Music, Gambling, Creative, Alternative) with th…. | none |
| search | What kick.com's search box shows for a query: matching channels (followers, live, verified), categories and live streams. | Audience analysts call search to get what kick.com's search box shows for a query. | query |
| search_channels | 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. | Social-listening tools call search_channels to search Kick channels by name, as kick.com's search page lists them (best match first). | query, is_live, limit |
| search_categories | Search Kick categories by name: live viewers, tags, mature flag, thumbnail. One page of up to 100 — kick's search does not page further. | Creator and influencer platforms call search_categories to search Kick categories by name. | query, limit |
| events | 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. | Brand-monitoring teams call events to get kick events (multi-channel community events) as the events page lists them. | none |
| event | One Kick event with its live streams (channel, title, viewers, language). | Audience analysts call event to get one Kick event with its live streams (channel, title, viewers, language).. | event |
| drops | Kick drop campaigns: game, organisation, rewards with the watch minutes each needs, start / end, status, participating channels. | Social-listening tools call drops to get kick drop campaigns. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/kick/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"xqc"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/kick/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "xqc"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/kick/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "xqc"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.kick.search with {"query":"xqc"}.Who uses this API and why
- Track live viewer counts across every Kick stream in a language or category, minute by minute.
- Find creators for sponsorships by category, language, followers and subscription price.
- Archive a channel's chat around a moment of a stream, with each sender's badges.
- Monitor gift leaderboards, predictions and polls on the channels you manage.
- Benchmark categories and games by live viewers, followers and clip views.
Questions developers ask before integrating
Do I need a Kick account or an API key from Kick?
No. Everything is read logged out, as any visitor sees kick.com. Nothing is posted: the API does not chat, follow or subscribe.
Can I list every live stream on Kick?
Yes. livestreams pages through the whole live directory, up to 100 streams per page. On 2026-11-16 Kick had 11,350 live channels at one moment; three consecutive pages of 100 returned 300 different streams. Because the list re-sorts by viewers every few seconds, a long walk can meet the same stream twice: a full walk of the Turkish-language directory returned 1,043 rows of which 963 were different streams, so de-duplicate on vod_id.
Which filters work on live streams?
Language (one or several), category (one or several) and directory. Measured on 2026-11-16: Turkish 1,038 rows over 11 pages, Turkish or Spanish 2,200, Just Chatting 1,771, Slots or Just Chatting 2,020, Gambling directory 277 — out of 11,171 live streams. Every row of a filtered page carried the requested language or category.
How far back does chat history go?
chat_messages returns 25 messages per page, newest first, and next_cursor walks back in time with no repeats (three pages: 75 different messages). start_time jumps to a moment, for example a timestamp inside a VOD.
Do I get viewer counts for past broadcasts and clips?
Yes. views on a VOD is the number its kick.com page prints (16 reads of 8 VODs, all within 39 views); views on a clip likewise (16 reads, all within 2).
How many VODs per channel?
As many as Kick lists: the channel's latest broadcasts (22 on the channel we sampled). Kick does not page this list.
Can I search channels and categories?
Yes, with Kick's own search: up to 100 channels or categories per query, best match first, with a live-only or offline-only switch for channels. Kick's search returns one page per query.
How fresh is the data?
Every call reads kick.com live; live viewer counts are the ones Kick reports at that second.
What is the Kick API?
Kick API is a ReefAPI endpoint group for kick.com live streams with viewer counts, channels with followers and subscription prices, vods, clips, chat history, gift leaderboards and categories. It returns live JSON through POST requests under /kick/v1.
Is the Kick API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Kick calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Kick login or account?
No login to Kick is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Kick data?
The page example is captured from a live channel call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Kick API use?
Kick actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Kick from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call kick actions with the same key, credit pool and JSON envelope used by normal REST requests.