Kick API endpoint
Searches Kick channels by name and returns each match's id, slug, username, follower count, live flag, verification and kick.com link, most relevant first. query is required and at most 100 characters. live=true restricts to channels that are broadcasting now. limit is 1 to 100 (default 10). A search with no matches returns an empty list.
/kick/search-channelsParameters:
query (required): the name to search for, up to 100 characters.live (optional): true restricts results to channels that are broadcasting now.limit (optional): 1 to 100; defaults to 10.Notable response behavior:
channels list, not an error.followers is the follower count; slug is what kick-channel takes.query, an over-long query or a limit outside 1 to 100 returns 400 before Kick is called.Example response (long values and lists shortened):
{
"code": 200,
"msg": "OK",
"data": {
"query": "xqc",
"channels": [
{
"id": 668,
"slug": "xqc",
"username": "xQc",
"followers": 1357621,
"live": false,
"verified": true,
"profile_picture": "https://files.kick.com/images/user/676/profile_image/conversion/931b4e8f-5445-427c-bd82-b473530390cc-medium.we…",
"url": "https://kick.com/xqc"
},
{
"id": 66401232,
"slug": "xqcow-waiting-room-x",
"username": "xQcOW_waiting_room_X",
"followers": 653,
"live": true,
"verified": false,
"profile_picture": "https://files.kick.com/images/user/67553903/profile_image/conversion/752135e0-8198-4d61-aab5-0e8c7629b3f6-medi…",
"url": "https://kick.com/xqcow-waiting-room-x"
}
]
}
}
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| slug | 10 | |
| username | 10 | |
| followers | 10 | 0 to 1,363,480, median 7 |
| live | 10 | true in 1 of 10 |
| verified | 10 | true in 2 of 10 |
| profile_picture | 4 | files.kick.com |
| url | 10 | kick.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Channel name to search for, up to 100 characters | xqc | |
| live | boolean | No | Only channels live now | true | |
| limit | integer | No | 10 | Maximum results, 1 to 100; defaults to 10 | 10 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/kick/search-channels?query=xqc&live=true&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "xqc",
"channels": [
{
"id": 668,
"slug": "xqc",
"username": "xQc",
"followers": 1357621,
"live": false,
"verified": true,
"profile_picture": "https://files.kick.com/images/user/676/profile_image/conversion/931b4e8f-5445-427c-bd82-b473530390cc-medium.we…",
"url": "https://kick.com/xqc"
},
{
"id": 66401232,
"slug": "xqcow-waiting-room-x",
"username": "xQcOW_waiting_room_X",
"followers": 653,
"live": true,
"verified": false,
"profile_picture": "https://files.kick.com/images/user/67553903/profile_image/conversion/752135e0-8198-4d61-aab5-0e8c7629b3f6-medi…",
"url": "https://kick.com/xqcow-waiting-room-x"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/kick.searchChannelsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | kick.SearchChannelsResponse | No | ||||
| data.channels | array | No | ChannelHit record, 8 fields: followers, id, live, profile_picture, slug, url, username, verified. Described under List Kick's top channels API. | |||
| data.query | string | 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/search-channels?query=xqc&live=true&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"