# Kick API > Kick returns streamer profiles and live stream data through a workflow and API. Kick looks up a streamer by channel name or link and returns profile details, follower count, and live stream details when available. Kick lists live streams sorted by current viewers; optionally provide a category, language, and maximum number of results. - Page: https://fous.com/tools/kick - Handle: `@kick` - Category: [Entertainment](https://fous.com/tools/category/entertainment) - Source website: https://kick.com - Last verified: Sep 29, 2026 ## Methods ### Get channel Operation `get_channel`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. Look up a Kick streamer by channel name or channel link. Shows current live stream details when available; offline stream fields are null. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `channel` | string | yes | `"https://kick.com/trainwreckstv"` | Kick channel name or channel link, for example xqc or https://kick.com/xqc. | **Input schema** ```json { "type": "object", "required": [ "channel" ], "properties": { "channel": { "type": "string", "description": "Kick channel name or channel link, for example xqc or https://kick.com/xqc.", "examples": [ "https://kick.com/trainwreckstv", "xqc" ] } }, "additionalProperties": false, "examples": [ { "channel": "https://kick.com/trainwreckstv" }, { "channel": "xqc" } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `bio` | string or null | `"squadW - #1 Podcast"` | Channel biography. | | `is_live` | boolean | `false` | Whether the channel is live now. | | `user_id` | integer or null | `723` | Kick internal user ID. | | `category` | string or null | `"Grand Theft Auto V (GTA)"` | Category of the current live stream; null while offline. | | `verified` | boolean | `true` | Whether Kick marks the channel as verified. | | `channel_id` | integer or null | `715` | Kick internal channel ID. | | `start_time` | string or null | `"2026-09-28T19:30:24+00:00"` | Live stream start time in ISO 8601 with offset; null while offline. | | `channel_link` | string | `"https://kick.com/trainwreckstv"` | Kick channel page link. | | `display_name` | string or null | `"Trainwreckstv"` | Streamer name shown on Kick. | | `social_links` | array | | Links to the streamer’s social accounts. | | `social_links[].link` | string | `"https://discord.gg/GxP4cxmXhM"` | | | `social_links[].platform` | string | `"Discord"` | | | `stream_title` | string or null | `"🥽 LIVE 🥽 HERE 🥽 LOCK IN 🥽 MEGA DAY 🥽 GTA 5 🥽 NOPIXEL V 🥽 BUT ALSO 🥽 CHILL REACT WITH FOOD BEFORE 🥽 ULTRA DAY �` | Title of the current live stream; null while offline. | | `livestream_id` | integer or null | `129599997` | Kick internal livestream ID; null while offline. | | `follower_count` | integer or null | `647221` | Current follower count. | | `stream_language` | string or null | `"English"` | Stream language; null while offline. | | `current_viewer_count` | integer or null | `10696` | Current viewer count; null while offline. | | `profile_picture_image_link` | string or null | `"https://files.kick.com/images/user/723/profile_image/conversion/87a305ea-3bc8-4e65-8772-9a453e8b9f37-fullsize.webp"` | Streamer profile picture image link. | **Example input** ```json { "channel": "https://kick.com/trainwreckstv" } ``` **Example output** ```json { "bio": "squadW - #1 Podcast", "is_live": false, "user_id": 723, "category": null, "verified": true, "channel_id": 715, "start_time": null, "channel_link": "https://kick.com/trainwreckstv", "display_name": "Trainwreckstv", "social_links": [ { "link": "https://discord.gg/GxP4cxmXhM", "platform": "Discord" }, { "link": "https://www.instagram.com/tylerniknam", "platform": "Instagram" }, { "link": "https://x.com/Trainwreckstv", "platform": "X" } ], "stream_title": null, "livestream_id": null, "follower_count": 647221, "stream_language": null, "current_viewer_count": null, "profile_picture_image_link": "https://files.kick.com/images/user/723/profile_image/conversion/87a305ea-3bc8-4e65-8772-9a453e8b9f37-fullsize.webp" } ``` ### List live streams Operation `list_live_streams`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. List the most-watched live Kick streams now, optionally in a category and language, sorted by current viewers. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `category` | string | no | `"Just Chatting"` | Game or category name, for example Just Chatting or Counter-Strike 2; leave blank for all categories. | | `language` | string | no | `"English"` | Stream language name or code, for example English or en; leave blank for any language. | | `max_results` | integer | no | `7` | Maximum streams to return, for example 25 (up to 100). | **Input schema** ```json { "type": "object", "properties": { "category": { "type": "string", "default": "", "description": "Game or category name, for example Just Chatting or Counter-Strike 2; leave blank for all categories.", "examples": [ "Just Chatting", "Counter-Strike 2" ] }, "language": { "type": "string", "default": "", "description": "Stream language name or code, for example English or en; leave blank for any language.", "examples": [ "English", "en" ] }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum streams to return, for example 25 (up to 100).", "x-fous-developer": true, "examples": [ 7, 5, 100 ] } }, "additionalProperties": false, "examples": [ { "language": "English", "max_results": 7 }, { "category": "Just Chatting", "max_results": 5 }, { "category": "Counter-Strike 2", "language": "en", "max_results": 5 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `streams` | array | | Live streams sorted from most viewers to fewest. | | `streams[].category` | string or null | `"IRL"` | Game or category name. | | `streams[].language` | string or null | `"English"` | Stream language name. | | `streams[].channel_id` | integer or null | `1227772` | Kick channel ID. | | `streams[].start_time` | string or null | `"2026-09-29T04:00:18+00:00"` | Start time in ISO 8601 with UTC offset. | | `streams[].channel_link` | string or null | `"https://kick.com/n3on"` | Kick channel page link. | | `streams[].channel_name` | string or null | `"n3on"` | Streamer channel name. | | `streams[].stream_title` | string or null | `"Jamaica ft. Sean Paul"` | Live stream title. | | `streams[].livestream_id` | string or null | `"01a0eb52-0c50-70d7-b909-0de109be012b"` | Kick livestream ID. | | `streams[].current_viewers` | integer or null | `38507` | Current viewers. | | `streams[].thumbnail_image_link` | string or null | `"https://images.kick.com/video_thumbnails/BpABZhKymTnv/P7pUbsGYndOy/720.webp?versionId=wwAQPs0DMLgWBDbWFOu3J.wPDHw.fcRF"` | Stream thumbnail image link. | **Example input** ```json { "language": "English", "max_results": 7 } ``` **Example output** ```json { "streams": [ { "category": "IRL", "language": "English", "channel_id": 1227772, "start_time": "2026-09-29T04:00:18+00:00", "channel_link": "https://kick.com/n3on", "channel_name": "n3on", "stream_title": "Jamaica ft. Sean Paul", "livestream_id": "01a0eb52-0c50-70d7-b909-0de109be012b", "current_viewers": 38507, "thumbnail_image_link": "https://images.kick.com/video_thumbnails/BpABZhKymTnv/P7pUbsGYndOy/720.webp?versionId=wwAQPs0DMLgWBDbWFOu3J.wPDHw.fcRF" }, { "category": "IRL", "language": "English", "channel_id": 5417122, "start_time": "2026-09-28T10:43:27+00:00", "channel_link": "https://kick.com/deenthegreat", "channel_name": "DeenTheGreat", "stream_title": "LOCKED-IN-ATHON DAY 77 OF 90 🔥 w/ Wiz Khalifa", "livestream_id": "01a0e79c-c898-7e93-9454-170ac2842110", "current_viewers": 24422, "thumbnail_image_link": "https://images.kick.com/video_thumbnails/nnDwHw8EOliy/FgPBbjwLlVRi/720.webp?versionId=hlynLQg9GJULQ52acIafZYua5ZvL8hss" }, { "category": "Grand Theft Auto V (GTA)", "language": "English", "channel_id": 668, "start_time": "2026-09-28T19:30:24+00:00", "channel_link": "https://kick.com/xqc", "channel_name": "xQc", "stream_title": "🥽 LIVE 🥽 HERE 🥽 LOCK IN 🥽 MEGA DAY 🥽 GTA 5 🥽 NOPIXEL V 🥽 BUT ALSO 🥽 CHILL REACT WITH FOOD BEFORE 🥽 ULTRA DAY 🥽 DONT LOSE OUT 🥽", "livestream_id": "01a0e97f-3880-7392-a639-df6fde1f8f1d", "current_viewers": 10736, "thumbnail_image_link": "https://images.kick.com/video_thumbnails/DsuAwCgUc9Bh/xil5ivgiKRbv/720.webp?versionId=kEqRzd79NMgsRKUvqCFFRLCa5YzvXz_i" } ] } ``` ## Quick start Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data. ```bash curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 180 \ -H "Authorization: Bearer YOUR_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@kick", "visibility": "public", "operation": "get_channel", "version": 1, "input": { "channel": "https://kick.com/trainwreckstv" }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. import json import urllib.error import urllib.request api_key = "YOUR_API_KEY" body = json.loads("{\n \"api\": \"@kick\",\n \"visibility\": \"public\",\n \"operation\": \"get_channel\",\n \"version\": 1,\n \"input\": {\n \"channel\": \"https://kick.com/trainwreckstv\"\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=180) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. const apiKey = "YOUR_API_KEY"; const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(180_000), body: JSON.stringify({ "api": "@kick", "visibility": "public", "operation": "get_channel", "version": 1, "input": { "channel": "https://kick.com/trainwreckstv" }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` ## Use from an AI assistant Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input. - Server URL: `https://api.fous.com/mcp/tools/kick` - Authorization: `Authorization: Bearer ` **Tools** - `get_channel`: Get channel. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. - `list_live_streams`: List live streams. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. - `fous_get_run`: the result of a run that was still going, by its `request_id`. Free. Claude Code: ```bash claude mcp add --scope user --transport http fous-kick https://api.fous.com/mcp/tools/kick --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}" ``` To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt. ## Use cases - Find a streamer’s profile and follower count - Check whether a streamer is live - Compare viewer counts across live streams - Find popular streams by category and language - Review stream titles and start times ## FAQ ### Can I run it with my own inputs? Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant. ### Can I call this Kick tool as an API? Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back. ### How much does it cost? Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit. ### Do I need a Kick account? No. You only need a Fous account. ### How current is the data? Fous gets the data from kick.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026. ### Is a Kick streamer live now? Use Get channel with a channel name or link to check whether the streamer is live and see current stream details when available. ### Which Kick streams have the most viewers? List live streams returns streams sorted from most viewers to fewest. ### Which live streams are in a particular category or language? List live streams can filter by category and language. ## Related - [Twitch API](https://fous.com/tools/twitch.md): Twitch returns channel profiles, live status, up to 10 broadcasts, top streams, viewer-ranked categories, up to 100 public videos/clips, and 1–30-day schedules; counts change. - [YouTube API](https://fous.com/tools/youtube.md): YouTube returns public video, caption, comment and channel details, company channels, and the latest weekly Top Songs chart; inferred dates and some counts may be approximate. - [JustWatch API](https://fous.com/tools/justwatch.md): JustWatch shows where movies and shows are available, including streaming, purchase, and cinema options, plus recent streaming arrivals and daily streaming charts based on its listings. - [Steam API](https://fous.com/tools/steam.md): Steam returns game details, country-specific prices, reviews, and current and historical player counts, plus player rankings and sales lists; some details or prices may be unavailable, and review totals span languages and verdicts. - [Kworb API](https://fous.com/tools/kworb.md): Kworb provides published Spotify and YouTube music charts and tracked artist streaming totals; chart dates may lag, and daily streams or some views may be unavailable. - [Spotify API](https://fous.com/tools/spotify.md): Spotify returns public artist profiles, album credits and ordered tracks, song details and play counts, up to 500 playlist songs, keyword results, and country-based podcast charts; dates and regional options vary. - [Microsoft Store API](https://fous.com/tools/microsoft-store.md): Microsoft Store returns app and game listings, country-specific searches, and ranked charts; update notes, purchase prices, and exact rating counts may be unavailable. - [Roblox API](https://fous.com/tools/roblox.md): Explore and play community-created Roblox experiences, find experiences by name or link, and browse current Charts rankings with player counts and other details. - [All Entertainment tools](https://fous.com/tools/category/entertainment)