Appearance
Clip
GET /v1/kick/clip
Fetches detailed data for a Kick clip by URL, including video, metadata, and channel info. Returns clip id, title, clip_url, thumbnail_url, video_url, view_count, likes_count, duration, privacy status, and is_mature flag. Also includes category details (name, slug), creator info (username), and channel info (username, profile_picture).
Authentication
All requests require the x-api-key header. Get your key at scrapecreators.com.
Query Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
url | string | yes | Kick clip URL | https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892 |
Example Request
curl
bash
curl 'https://api.scrapecreators.com/v1/kick/clip?url=https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892' \
-H 'x-api-key: $SCRAPECREATORS_API_KEY'Node / TypeScript
js
const params = new URLSearchParams({ url: 'https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892' });
const res = await fetch(`https://api.scrapecreators.com/v1/kick/clip?${params}`, {
headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);Python
python
import os, requests
r = requests.get(
'https://api.scrapecreators.com/v1/kick/clip',
headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
params={'url': 'https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892'},
)
r.raise_for_status()
print(r.json())CLI
bash
scrapecreators kick clip --helpExample Response
json
{
"clip": {
"id": "clip_01JGJHB6CEVFCQRYTVPM8DW892",
"livestream_id": "45013036",
"category_id": "15",
"channel_id": 668,
"user_id": 13035177,
"title": "MonkaW",
"clip_url": "https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/playlist.m3u8",
"thumbnail_url": "https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/thumbnail.webp",
"privacy": "CLIP_PRIVACY_PUBLIC",
"likes": 0,
"liked": false,
"views": 11793,
"duration": 50,
"started_at": "2025-01-02T03:34:51.825Z",
"created_at": "2025-01-02T03:37:13.559618Z",
"is_mature": false,
"video_url": "https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/playlist.m3u8",
"view_count": 11793,
"likes_count": 0,
"vod": {
"id": "2ba60535-342e-4397-b16a-fb739ca96b21"
},
"category": {
"id": 15,
"name": "Just Chatting",
"slug": "just-chatting",
"responsive": "https://files.kick.com/images/subcategories/15/banner/b697a8a3-62db-4779-aa76-e4e47662af97",
"banner": "https://files.kick.com/images/subcategories/15/banner/b697a8a3-62db-4779-aa76-e4e47662af97",
"parent_category": "irl"
},
"creator": {
"id": 13035177,
"username": "cskorm",
"slug": "cskorm",
"profile_picture": null
},
"channel": {
"id": 668,
"username": "xQc",
"slug": "xqc",
"profile_picture": "https://files.kick.com/images/user/676/profile_image/conversion/931b4e8f-5445-427c-bd82-b473530390cc-thumb.webp"
}
}
}Credits
Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.
Errors
| Status | Meaning | Action |
|---|---|---|
| 200 | Success. | Use the JSON payload. |
| 400 | Invalid or missing parameter. | Verify required parameters and value format. |
| 401 | Missing or invalid x-api-key. | Pass a valid API key in the header. |
| 402 | Out of credits. | Top up at scrapecreators.com or wait for plan reset. |
| 404 | Resource not found or private. | Confirm the handle, URL, or id and that the resource is public. |
| 429 | Rate limited. | Backoff and retry with exponential delay. |
| 500 | Server error or upstream platform failure. | Retry with backoff; report persistent errors to support. |