Kick

List Kick channel clips

List a Kick channel's clips filtered by views or date and by time window, with a cursor.

GET/v1/kick/channels/{slug}/clips
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
slugstringrequiredpath

Kick channel slug, case-insensitive. Most replace the username's underscores with hyphens (e.g. `alfalfa-kid`, not `alfalfa_kid`), but some keep an underscore (e.g. `pala_okey`).

min 1 chars · max 64 chars · pattern: ^[A-Za-z0-9_-]+$

sortstringoptionalquery

`view` (most viewed) or `date` (newest). Default: `view`.

one of: view, date

timestringoptionalquery

Time window. Default: `all`.

one of: all, month, week, day

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 4096 chars

Response fields
54

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the channel slug does not resolve.

one of: found, not_found

A page of clips.

dataclips[]id
string

Clip id.

dataclips[]livestreamId
integernullable

The stream session the clip came from.

dataclips[]title
stringnullable

Clip title.

dataclips[]playbackUrl
stringnullable

Public HLS playlist; null when absent.

dataclips[]thumbnailUrl
stringnullable

Thumbnail image URL.

dataclips[]durationSeconds
integernullable

Clip duration in seconds.

dataclips[]views
integernullable

Views.

dataclips[]likes
integernullable

Likes; null when the record does not include them.

dataclips[]createdAt
stringnullable

When the clip was created. ISO 8601 UTC; null when the date is not available.

dataclips[]startedAt
stringnullable

When the clipped moment started; null when the time is not available. ISO 8601 UTC; null when the date is not available.

dataclips[]isMature
booleannullable

Whether it is mature.

Clip category.

dataclips[]categoryid
integer

Category id.

dataclips[]categoryname
string

Category name.

dataclips[]categoryslug
string

Category slug.

Top-level group; null when any of its id, name or slug is missing.

dataclips[]categorygroupid
integernullable

Top-level group id.

dataclips[]categorygroupname
stringnullable

Group name, e.g. `Games`.

dataclips[]categorygroupslug
stringnullable

Group slug, e.g. `games`.

dataclips[]categorygroupicon
stringnullable

Group emoji.

Tags Kick assigns.

dataclips[]categorytags[]
stringoptional
dataclips[]categorydescription
stringnullable

Description; null for most categories.

dataclips[]categoryisMature
booleannullable

Whether Kick marks it mature.

dataclips[]categoryviewers
integernullable

Current viewers.

dataclips[]categorybannerUrl
stringnullable

Banner image URL.

dataclips[]categoryfollowers
integernullable

Followers; only the category detail carries it.

Who created the clip.

dataclips[]creatorid
integernullable

User id.

dataclips[]creatorusername
stringnullable

Display name.

dataclips[]creatorslug
stringnullable

Channel-form slug.

dataclips[]creatoravatarUrl
stringnullable

Avatar URL.

The channel it was clipped from.

dataclips[]channelid
integernullable

Channel id.

dataclips[]channelslug
stringnullable

Channel slug.

dataclips[]channelusername
stringnullable

Display name.

dataclips[]channelavatarUrl
stringnullable

Avatar URL.

dataclips[]channelisVerified
booleannullable

Whether it is verified; null when the record does not include it.

dataclips[]channelisLive
booleannullable

Whether it is live; null when the record does not include it.

dataclips[]channelfollowers
integernullable

Follower count; null when the record does not include it.

dataclips[]videoOffsetSeconds
integernullable

Position of the clip in the source VOD.

dataclips[]videoId
stringnullable

Source VOD id; null when the clip has no source VOD or the list does not include it.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagepage
integer

Page number of this response.

datapagelastPage
integernullable

Last available page; null when unknown.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/kick/channels/xqc/clips?sort=date&time=week" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Kick channel clips.