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.
Headers
Get your API keyAPI key (`sfk_...`)
Event ULID or slug (e.g. `nopixel-v`).
min 1 chars · max 128 chars · pattern: ^[A-Za-z0-9._:~-]+$
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)
Return the featured events instead of the browse list.
Endpoint-specific response payload.
`not_found` when the requested event id or slug does not resolve.
one of: found, not_found
True when this is the featured list.
Browse or featured events; null in detail mode.
Event id.
Event slug.
Event title.
Event description.
Phase, e.g. `live`.
Event artwork.
Banner image URL.
Promo banner URL.
Promo poster URL.
Thumbnail image URL.
Background image URL.
Event category.
Category id.
Category name.
Category slug.
Banner image URL.
Category image URL.
Default language code.
Language codes.
Drop campaigns attached to the event.
When the event starts. ISO 8601 UTC; null when the date is not available.
When the event ends. ISO 8601 UTC; null when the date is not available.
Live streams taking part.
Participants; null in browse and featured lists, set on the event detail.
Event views.
Who runs the event.
Role, e.g. `organiser`.
The organiser's channel.
Channel id.
Channel slug.
Whether it is verified.
The organiser's user.
User id.
Display name.
Avatar URL.
The event in detail mode; null otherwise.
Event id.
Event slug.
Event title.
Event description.
Phase, e.g. `live`.
Event artwork.
Banner image URL.
Promo banner URL.
Promo poster URL.
Thumbnail image URL.
Background image URL.
Event category.
Category id.
Category name.
Category slug.
Banner image URL.
Category image URL.
Default language code.
Language codes.
Drop campaigns attached to the event.
When the event starts. ISO 8601 UTC; null when the date is not available.
When the event ends. ISO 8601 UTC; null when the date is not available.
Live streams taking part.
Participants; null in browse and featured lists, set on the event detail.
Event views.
Who runs the event.
Role, e.g. `organiser`.
The organiser's channel.
Channel id.
Channel slug.
Whether it is verified.
The organiser's user.
User id.
Display name.
Avatar URL.
The event's live streams when `include=streams`.
The channel streaming.
Channel id.
Channel slug.
Whether it is verified.
The live stream.
Stream id.
Stream title.
Language code.
Whether it is mature.
Whether Kick makes the viewer count public; when false, `viewers` is null.
Thumbnail URL.
Viewer count; null when Kick hides it.
The user streaming.
User id.
Display name.
Avatar URL.
The event's clips when `include=clips`.
Clip id.
The stream session the clip came from.
Clip title.
Public HLS playlist; null when absent.
Thumbnail image URL.
Clip duration in seconds.
Views.
Likes; null when the record does not include them.
When the clip was created. ISO 8601 UTC; null when the date is not available.
When the clipped moment started; null when the time is not available. ISO 8601 UTC; null when the date is not available.
Whether it is mature.
Clip category.
Category id.
Category name.
Category slug.
Top-level group; null when any of its id, name or slug is missing.
Top-level group id.
Group name, e.g. `Games`.
Group slug, e.g. `games`.
Group emoji.
Tags Kick assigns.
Description; null for most categories.
Whether Kick marks it mature.
Current viewers.
Banner image URL.
Followers; only the category detail carries it.
Who created the clip.
User id.
Display name.
Channel-form slug.
Avatar URL.
The channel it was clipped from.
Channel id.
Channel slug.
Display name.
Avatar URL.
Whether it is verified; null when the record does not include it.
Whether it is live; null when the record does not include it.
Follower count; null when the record does not include it.
Position of the clip in the source VOD.
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.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
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.