Social Fetch
Start for freeStart free
Kick hub

Kick VOD API

One video by its UUID, with duration, views, categories and channel, and a typed restricted state for subscriber-only VODs.

GET /v1/kick/videos/{videoId}

1 credit Failed requests are free Found, empty and not-found answers are all charged

Try in playgroundFull API docs

About this endpoint

GET /v1/kick/videos/{videoId} takes the VOD UUID and returns data.video with id, title, url, views, durationSeconds, startedAt, isLive, isMature, isPrivate, isPruned, status, isSubscriberOnly, playbackUrl, thumbnailUrl, categories and a channel summary.

The lookup status has three values. found means a public VOD. restricted means the VOD exists but is subscriber-only; its metadata is returned and playbackUrl is null. not_found means the UUID does not resolve and video is null. thumbnailUrl is the public thumbnail image, null when the VOD is restricted or none is available.

Kick VOD API FAQ

How do I get a Kick VOD by id?

Call GET /v1/kick/videos/{videoId} with the UUID, for example 5b15049f-26ec-4ebe-9c65-c1719760b933. The response is data.video on found, with data.lookupStatus telling you which state you got.

What does lookupStatus: restricted mean?

The VOD exists but only the channel's subscribers can watch it. Social Fetch returns its public metadata, sets isSubscriberOnly to true and leaves playbackUrl null. It is not a failure.

How do I get a VOD thumbnail?

thumbnailUrl is the VOD's public thumbnail image. It is null only when the VOD is restricted or no thumbnail is available.

How many credits does a VOD lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Kick endpoints