Live streaming API

Kick

Live private service

Retrieve a public Kick clip with media URLs, counts, timestamps, category, creator, and channel details.

Get the complete public clip object in one authenticated request. Source types, aliases, optional fields, and nested attributes are preserved.

Base URLhttp://localhost:3011

Local development example. Replace with your service origin.

Get a Kick clip

GET/v1/kick/clip

Retrieve one public Kick clip from the public player metadata API for current counters. Media and thumbnail URLs are returned without downloading their contents. No channel discovery, clip listing, or video transcription is performed.

Query parameters

Field	Type	Description
url	string	Required HTTPS Kick clip URL. Canonical /<channel>/clips/<clip_id> and legacy /<channel>?clip=<clip_id> forms are supported. Duplicate/conflicting clip IDs are rejected.

Request cURL

export BASE_URL="http://localhost:3011"
export API_KEY="your-service-key"

curl --get "$BASE_URL/v1/kick/clip" \
  -H "x-api-key: $API_KEY" \
  --data-urlencode "url=https://kick.com/example/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892"

Response fields

Field	Type	Description
requestId	string	Operation identifier for correlation.
accounting	object	Upstream HTTP attempts, decoded response bytes and duration. DNS lookups are transport setup and are not counted as HTTP requests. Error response bodies are discarded.
success	boolean	True only when the complete supported clip object validates.
status	string	success on complete retrieval; failed or challenged with a failure object otherwise.
clip	object	Full public clip object, including source extensions and nested category, creator, channel and optional VOD metadata. Fields are not renamed or coerced.
sourceUrl	string	Canonical Kick clip page URL.
fetchedAt	string	UTC retrieval timestamp.
coverage	object	Complete validated public clip metadata. Missing required fields fail the request; no reduced-field success is returned.

Clip fields

Field	Type	Description
id	string	Kick clip ID; must match the requested clip.
livestream_id	string \| null	Source livestream ID as a string, or null.
category_id	string \| null	Source category ID as a string, or null; preserved separately from category.id.
channel_id	integer	Numeric owner channel ID, verified against channel.id.
user_id	integer \| null	Numeric clip creator ID, verified against creator.id when available. Null is preserved.
title	string	Original clip title, including empty strings.
clip_url	string \| null	Published media URL; may be an HLS playlist or direct media. Returned as data without downloading.
thumbnail_url	string \| null	Source thumbnail URL; never fetched.
privacy	string	Source public privacy representation, public or CLIP_PRIVACY_PUBLIC. Other privacy values are rejected.
likes	integer \| null	Source like count; explicit nulls are preserved.
liked	boolean	Upstream logged-out liked flag. No viewer session is supplied.
views	integer \| null	Source view count at retrieval time. Live counters can change between requests.
duration	number \| null	Source duration in seconds; fractional values and nulls are preserved.
started_at	string \| null	Source start timestamp string, with original precision, or null.
created_at	string \| null	Source creation timestamp string, with original precision, or null.
vod_starts_at	number \| null	Optional source VOD offset. Omitted when Kick omits it; explicit nulls are preserved.
is_mature	boolean	Published maturity metadata; no age/consent flow is performed.
video_url	string \| null	Source media alias. Preserved independently from clip_url.
view_count	integer \| null	Source view-count alias, preserved independently from views.
likes_count	integer \| null	Source likes alias, preserved independently from likes.
vod	object \| null	Optional VOD object with id and any public source extensions, or null. Not synthesized when absent; no VOD lookup or media fetch.
category	object \| null	Category id, name, slug, responsive, banner, parent_category and extensions, or null.
creator	object \| null	Clip creator: id, username, slug, profile_picture and extensions, or null.
channel	object	Owner channel: id, username, slug, profile_picture and extensions. The slug is checked against the requested channel.

Nested fields and every response variant are in the OpenAPI specification.

Response 200 · synthetic example

{
  "success": true,
  "status": "success",
  "clip": {
    "id": "clip_01JGJHB6CEVFCQRYTVPM8DW892",
    "livestream_id": "123",
    "category_id": "15",
    "channel_id": 10,
    "user_id": 20,
    "title": "Synthetic clip",
    "clip_url": "https://clips.kick.com/example/playlist.m3u8",
    "thumbnail_url": "https://clips.kick.com/example/thumbnail.webp",
    "privacy": "public",
    "likes": 0,
    "liked": false,
    "views": 42,
    "duration": 12.5,
    "started_at": "2026-09-10T00:00:00.123Z",
    "created_at": "2026-09-10T00:00:13.123456Z",
    "vod_starts_at": 15,
    "is_mature": false,
    "video_url": "https://clips.kick.com/example/playlist.m3u8",
    "view_count": 42,
    "likes_count": 0,
    "vod": {
      "id": "00000000-0000-4000-8000-000000000001"
    },
    "category": {
      "id": 15,
      "name": "Example category",
      "slug": "example-category",
      "responsive": "https://example.test/banner",
      "banner": "https://example.test/banner",
      "parent_category": "example"
    },
    "creator": {
      "id": 20,
      "username": "ExampleCreator",
      "slug": "examplecreator",
      "profile_picture": null
    },
    "channel": {
      "id": 10,
      "username": "Example",
      "slug": "example",
      "profile_picture": "https://example.test/avatar"
    }
  },
  "requestId": "00000000-0000-4000-8000-000000000099",
  "sourceUrl": "https://kick.com/example/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892",
  "fetchedAt": "2026-09-10T00:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 1500,
    "durationMs": 800
  }
}

Coverage & limits

One clip per request; four concurrent requests per worker. Saturation returns 503 busy.
15-second total deadline, at most two upstream HTTP attempts including one transient network/5xx retry. Rate limits, challenges, redirects, and missing clips are not retried.
2 MiB total decoded JSON, depth 16, and 5,000 examined nodes. Oversized or complex payloads fail explicitly.
Missing or malformed required fields and mismatched clip/channel/creator identity fail explicitly. Optional VOD fields retain source absence; known nulls and source extensions are preserved.
Private or access/consent-gated clips are rejected. No login, cookies, private tokens, or access-gate completion. A public maturity flag is returned as metadata.
No media, playlists, segments, thumbnail, VOD, or outbound destination downloads. No result cache, billing, shared database, or consuming-product dependency.
Views and likes are live source values and can change between requests. Comparison scripts check them strictly; counter differences never count as exact parity.
System DNS is the default. Operators can set KICK_DNS_SERVERS to one to three DNS server IP addresses for this worker only. HTTPS certificate verification remains enabled; no system DNS change or hardcoded Kick address is used.
Live acceptance returned all 23 current fields on two clips. Every field except the two live view-count aliases matched exactly. Strict full-response parity remains unpassed; no field is excluded from the comparator.

Errors & partial results

HTTP	Code / status	Meaning
400	invalid_request	Missing/unsafe clip URL, ambiguous clip IDs, duplicate URL or unsupported parameters.
401	unauthorized	Missing or invalid worker API key.
403	restricted_page	The clip is private or requires access/consent.
404	not_found	Kick reports a missing or deleted clip.
429	upstream_rate_limited	Kick rate limited the request; no automatic retry.
502	upstream_challenged	Kick rejected or challenged the request.
502	unsupported_page	Malformed, incomplete, unexpected, or mismatched clip metadata.
502	response_too_large / payload_too_complex	The JSON exceeded byte, depth or node limits.
502	unsafe_redirect / request_limit / upstream_error	The bounded request could not complete.
503	busy	All worker slots are in use.
504	timeout	The total retrieval deadline expired.