Kick

List Kick events, or read one event

List Kick events, the featured events, or one event by id or slug, its live streams or its clips.

GET/v1/kick/events
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
eventstringquery

Event ULID or slug (e.g. `nopixel-v`).

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

includearrayquery

When `event` is given: return its live streams or its clips instead of the event record. Send `streams` or `clips`, not both.

any of: streams, clips (comma-separated)

featuredbooleanquery

Return the featured events instead of the browse list.

Response fields
143

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the requested event id or slug does not resolve.

one of: found, not_found

datafeatured
boolean

True when this is the featured list.

Browse or featured events; null in detail mode.

dataevents[]id
string

Event id.

dataevents[]slug
stringnullable

Event slug.

dataevents[]title
stringnullable

Event title.

dataevents[]description
stringnullable

Event description.

dataevents[]phase
stringnullable

Phase, e.g. `live`.

Event artwork.

dataevents[]assetsbanner
stringnullable

Banner image URL.

dataevents[]assetspromoBanner
stringnullable

Promo banner URL.

dataevents[]assetspromoPoster
stringnullable

Promo poster URL.

dataevents[]assetsthumbnail
stringnullable

Thumbnail image URL.

dataevents[]assetsbackground
stringnullable

Background image URL.

Event category.

dataevents[]categoryid
integernullable

Category id.

dataevents[]categoryname
stringnullable

Category name.

dataevents[]categoryslug
stringnullable

Category slug.

dataevents[]categorybannerUrl
stringnullable

Banner image URL.

dataevents[]categoryimageUrl
stringnullable

Category image URL.

dataevents[]defaultLanguage
stringnullable

Default language code.

Language codes.

dataevents[]languages[]
stringoptional

Drop campaigns attached to the event.

dataevents[]dropCampaignIds[]
stringoptional
dataevents[]startsAt
stringnullable

When the event starts. ISO 8601 UTC; null when the date is not available.

dataevents[]endsAt
stringnullable

When the event ends. ISO 8601 UTC; null when the date is not available.

dataevents[]livestreamCount
integernullable

Live streams taking part.

dataevents[]totalParticipants
integernullable

Participants; null in browse and featured lists, set on the event detail.

dataevents[]viewCount
integernullable

Event views.

Who runs the event.

dataevents[]organiserrole
stringnullable

Role, e.g. `organiser`.

The organiser's channel.

dataevents[]organiserchannelid
integernullable

Channel id.

dataevents[]organiserchannelslug
stringnullable

Channel slug.

dataevents[]organiserchannelisVerified
booleannullable

Whether it is verified.

The organiser's user.

dataevents[]organiseruserid
integernullable

User id.

dataevents[]organiseruserusername
stringnullable

Display name.

dataevents[]organiseruseravatarUrl
stringnullable

Avatar URL.

The event in detail mode; null otherwise.

dataeventid
string

Event id.

dataeventslug
stringnullable

Event slug.

dataeventtitle
stringnullable

Event title.

dataeventdescription
stringnullable

Event description.

dataeventphase
stringnullable

Phase, e.g. `live`.

Event artwork.

dataeventassetsbanner
stringnullable

Banner image URL.

dataeventassetspromoBanner
stringnullable

Promo banner URL.

dataeventassetspromoPoster
stringnullable

Promo poster URL.

dataeventassetsthumbnail
stringnullable

Thumbnail image URL.

dataeventassetsbackground
stringnullable

Background image URL.

Event category.

dataeventcategoryid
integernullable

Category id.

dataeventcategoryname
stringnullable

Category name.

dataeventcategoryslug
stringnullable

Category slug.

dataeventcategorybannerUrl
stringnullable

Banner image URL.

dataeventcategoryimageUrl
stringnullable

Category image URL.

dataeventdefaultLanguage
stringnullable

Default language code.

Language codes.

dataeventlanguages[]
stringoptional

Drop campaigns attached to the event.

dataeventdropCampaignIds[]
stringoptional
dataeventstartsAt
stringnullable

When the event starts. ISO 8601 UTC; null when the date is not available.

dataeventendsAt
stringnullable

When the event ends. ISO 8601 UTC; null when the date is not available.

dataeventlivestreamCount
integernullable

Live streams taking part.

dataeventtotalParticipants
integernullable

Participants; null in browse and featured lists, set on the event detail.

dataeventviewCount
integernullable

Event views.

Who runs the event.

dataeventorganiserrole
stringnullable

Role, e.g. `organiser`.

The organiser's channel.

dataeventorganiserchannelid
integernullable

Channel id.

dataeventorganiserchannelslug
stringnullable

Channel slug.

dataeventorganiserchannelisVerified
booleannullable

Whether it is verified.

The organiser's user.

dataeventorganiseruserid
integernullable

User id.

dataeventorganiseruserusername
stringnullable

Display name.

dataeventorganiseruseravatarUrl
stringnullable

Avatar URL.

The event's live streams when `include=streams`.

The channel streaming.

datastreams[]channelid
integernullable

Channel id.

datastreams[]channelslug
stringnullable

Channel slug.

datastreams[]channelisVerified
booleannullable

Whether it is verified.

The live stream.

datastreams[]livestreamid
stringnullable

Stream id.

datastreams[]livestreamtitle
stringnullable

Stream title.

datastreams[]livestreamlanguage
stringnullable

Language code.

datastreams[]livestreamisMature
booleannullable

Whether it is mature.

datastreams[]livestreamshowsViewerCount
booleannullable

Whether Kick makes the viewer count public; when false, `viewers` is null.

datastreams[]livestreamthumbnailUrl
stringnullable

Thumbnail URL.

datastreams[]livestreamviewers
integernullable

Viewer count; null when Kick hides it.

The user streaming.

datastreams[]userid
integernullable

User id.

datastreams[]userusername
stringnullable

Display name.

datastreams[]useravatarUrl
stringnullable

Avatar URL.

The event's clips when `include=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.

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/events" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Kick events.