Kick

Get Kick VOD

Get a Kick VOD by UUID with its stream, channel and categories.

GET/v1/kick/videos/{videoId}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
videoIdstringrequiredpath

VOD UUID, the id Kick pages use.

pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Response fields
49

Endpoint-specific response payload.

datalookupStatus
string

`restricted` when the video exists but is subscriber-only; its metadata is returned and `playbackUrl` is null.

one of: found, not_found, restricted

The VOD when found or restricted; otherwise null.

datavideoid
string

VOD UUID.

datavideolivestreamId
integernullable

The stream session the VOD was recorded from.

datavideochannelId
integernullable

Channel id.

datavideourl
stringnullable

Video page URL.

datavideotitle
stringnullable

Stream title.

datavideolanguage
stringnullable

Language name.

datavideoisLive
booleannullable

True for the stream in progress, listed first.

datavideoisMature
booleannullable

Whether it is mature.

datavideostartedAt
stringnullable

When the recording started. ISO 8601 UTC; null when the date is not available.

datavideodurationSeconds
integernullable

Duration in seconds.

datavideoviewers
integernullable

The stream's last viewer count.

datavideoviews
integernullable

VOD views.

datavideoisPrivate
booleannullable

Whether it is private.

datavideoisPruned
booleannullable

Whether Kick pruned it.

datavideostatus
stringnullable

Kick status, e.g. `public` or `subscriber_only`.

datavideoisSubscriberOnly
boolean

Whether the VOD is behind the subscription.

datavideoplaybackUrl
stringnullable

Public HLS master playlist; null when restricted.

datavideothumbnailUrl
stringnullable

Thumbnail image URL; null when no public thumbnail is available.

Categories the stream was in.

datavideocategories[]id
integer

Category id.

datavideocategories[]name
string

Category name.

datavideocategories[]slug
string

Category slug.

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

datavideocategories[]groupid
integernullable

Top-level group id.

datavideocategories[]groupname
stringnullable

Group name, e.g. `Games`.

datavideocategories[]groupslug
stringnullable

Group slug, e.g. `games`.

datavideocategories[]groupicon
stringnullable

Group emoji.

Tags Kick assigns.

datavideocategories[]tags[]
stringoptional
datavideocategories[]description
stringnullable

Description; null for most categories.

datavideocategories[]isMature
booleannullable

Whether Kick marks it mature.

datavideocategories[]viewers
integernullable

Current viewers.

datavideocategories[]bannerUrl
stringnullable

Banner image URL.

datavideocategories[]followers
integernullable

Followers; only the category detail carries it.

The channel summary on the detail route; null in lists.

datavideochannelid
integernullable

Channel id.

datavideochannelslug
stringnullable

Channel slug.

datavideochannelusername
stringnullable

Display name.

datavideochannelavatarUrl
stringnullable

Avatar URL.

datavideochannelisVerified
booleannullable

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

datavideochannelisLive
booleannullable

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

datavideochannelfollowers
integernullable

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

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/videos/5b15049f-26ec-4ebe-9c65-c1719760b933" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Kick video.