Kick API endpoint
Returns one page of Kick's game and activity categories (Just Chatting, Grand Theft Auto V, ...) ordered by current viewers: id, name, slug, parent category, tags, viewers, mature flag, banner and kick.com link. category restricts to one top-level category by slug from kick-categories (a parent Kick adds later is accepted too). page is 1 to 20 and limit is 1 to 32 (default 24) because Kick silently caps both; total is the size of the whole catalog (over 18,000) while reachable is how many entries these limits can reach, so use kick-search-categories to find a category outside the first pages.
/kick/subcategoriesParameters (all optional):
category: restrict to one top-level category by slug: games, irl, music, gambling, creative, alternative or chat-roulette (see kick-categories).page: 1 to 20; defaults to 1.limit: 1 to 32; defaults to 24.Kick silently clamps page to 20 and limit to 32 (and reads limit=0 as 1), returning a page you did not ask for. This endpoint rejects those out-of-range values with 400 instead.
Notable response behavior:
total is the size of the whole catalog (over 18,000). reachable is how many entries these limits can reach (page cap times limit), so most of the catalog is only findable through kick-search-categories.viewers.parent_* fields name the top-level category. An unknown category returns 400; a top-level category Kick adds later is accepted once kick-categories lists it.Example response (long values and lists shortened):
{
"code": 200,
"msg": "OK",
"data": {
"page": 1,
"limit": 10,
"total": 18123,
"reachable": 200,
"subcategories": [
{
"id": 15,
"name": "Just Chatting",
"slug": "just-chatting",
"parent_id": 2,
"parent_name": "IRL",
"parent_slug": "irl",
"tags": [
"IRL",
"Casual"
],
"mature": false,
"viewers": 263873,
"banner_url": "https://files.kick.com/images/subcategories/15/banner/conversion/b697a8a3-62db-4779-aa76-e4e47662af97-banner.w…",
"url": "https://kick.com/category/just-chatting"
},
{
"id": 8,
"name": "Grand Theft Auto V (GTA)",
"slug": "grand-theft-auto-v",
"parent_id": 1,
"parent_name": "Games",
"parent_slug": "games",
"tags": [
"Shooter",
"Action"
],
"description": "Grand Theft Auto V is a vast open world game set in Los Santos, a sprawling sun-soaked metropolis struggling t…",
"mature": false,
"viewers": 175554,
"banner_url": "https://files.kick.com/images/subcategories/8/banner/conversion/8110f223-9654-4536-bfee-6a324bbf03f9-banner.we…",
"url": "https://kick.com/category/grand-theft-auto-v"
}
]
}
}
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| name | 10 | |
| slug | 10 | |
| parent_id | 10 | |
| parent_name | 10 | |
| parent_slug | 10 | |
| tags | 10 | median 2 entries |
| description | 4 | median 252 characters |
| mature | 10 | true in 1 of 10 |
| viewers | 10 | 10,465 to 75,055, median 26,239 |
| banner_url | 10 | files.kick.com |
| url | 10 | kick.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category | string | No | Top-level category slug from kick-categories; a parent Kick adds later is also accepted once it appears there Allowed values: games, irl, music, gambling, creative, alternative, chat-roulette. | irl | |
| page | integer | No | 1 | Page number, 1 to 20; defaults to 1 | 1 |
| limit | integer | No | 24 | Page size, 1 to 32; defaults to 24 | 10 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/kick/subcategories?category=games&page=1&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"page": 1,
"limit": 10,
"total": 18123,
"reachable": 200,
"subcategories": [
{
"id": 15,
"name": "Just Chatting",
"slug": "just-chatting",
"parent_id": 2,
"parent_name": "IRL",
"parent_slug": "irl",
"tags": [
"IRL",
"Casual"
],
"mature": false,
"viewers": 263873,
"banner_url": "https://files.kick.com/images/subcategories/15/banner/conversion/b697a8a3-62db-4779-aa76-e4e47662af97-banner.w…",
"url": "https://kick.com/category/just-chatting"
},
{
"id": 8,
"name": "Grand Theft Auto V (GTA)",
"slug": "grand-theft-auto-v",
"parent_id": 1,
"parent_name": "Games",
"parent_slug": "games",
"tags": [
"Shooter",
"Action"
],
"description": "Grand Theft Auto V is a vast open world game set in Los Santos, a sprawling sun-soaked metropolis struggling t…",
"mature": false,
"viewers": 175554,
"banner_url": "https://files.kick.com/images/subcategories/8/banner/conversion/8110f223-9654-4536-bfee-6a324bbf03f9-banner.we…",
"url": "https://kick.com/category/grand-theft-auto-v"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/kick.subcategoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | kick.SubcategoriesResponse | No | ||||
| data.category | string | No | ||||
| data.limit | integer | No | ||||
| data.page | integer | No | ||||
| data.reachable | integer | No | ||||
| data.subcategories | array | No | Subcategory record, 13 fields: banner_url, description, followers, id, mature, name, parent_id, parent_name, parent_slug, slug, tags, url and 1 more. Described under Get one Kick category API. | |||
| data.total | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/kick/subcategories?category=games&page=1&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"