Kick

List live Kick streams

List the live Kick directory with sort, language, category, group and cursor filters.

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

API key (`sfk_...`)

Parameters
6
sortstringquery

`viewers` (most watched) or `featured`. Default: `viewers`.

one of: viewers, featured

languagestringquery

Language code (e.g. `en`, `es`, `ja`).

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

categoryIdintegerquery

Category id, 1 to 2147483647.

≥ 1 · ≤ 2147483647

groupIdintegerquery

Directory group id, 1 to 2147483647.

≥ 1 · ≤ 2147483647

limitintegerquery

Rows per page, 1 to 100. Default: 100.

≥ 1 · ≤ 100

cursorstringquery

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

min 1 chars · max 4096 chars

Response fields
47

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: an empty directory is an empty result, not a miss.

one of: found, not_found

A page of streams.

datastreams[]id
string

Stream id (also the VOD id once it ends).

datastreams[]title
stringnullable

Stream title.

datastreams[]viewers
integernullable

Viewer count; null when Kick hides it.

datastreams[]showsViewerCount
booleannullable

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

datastreams[]thumbnailUrl
stringnullable

Thumbnail URL.

datastreams[]startedAt
stringnullable

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

The channel streaming.

datastreams[]channelid
integernullable

Channel id.

datastreams[]channelslug
stringnullable

Channel slug.

datastreams[]channelusername
stringnullable

Display name.

datastreams[]channelavatarUrl
stringnullable

Avatar URL.

datastreams[]channelisVerified
booleannullable

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

datastreams[]channelisLive
booleannullable

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

datastreams[]channelfollowers
integernullable

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

The category.

datastreams[]categoryid
integer

Category id.

datastreams[]categoryname
string

Category name.

datastreams[]categoryslug
string

Category slug.

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

datastreams[]categorygroupid
integernullable

Top-level group id.

datastreams[]categorygroupname
stringnullable

Group name, e.g. `Games`.

datastreams[]categorygroupslug
stringnullable

Group slug, e.g. `games`.

datastreams[]categorygroupicon
stringnullable

Group emoji.

Tags Kick assigns.

datastreams[]categorytags[]
stringoptional
datastreams[]categorydescription
stringnullable

Description; null for most categories.

datastreams[]categoryisMature
booleannullable

Whether Kick marks it mature.

datastreams[]categoryviewers
integernullable

Current viewers.

datastreams[]categorybannerUrl
stringnullable

Banner image URL.

datastreams[]categoryfollowers
integernullable

Followers; only the category detail carries it.

datastreams[]languageCode
stringnullable

Language code.

datastreams[]isMature
booleannullable

Whether it is mature.

Stream tags.

datastreams[]tags[]
stringoptional
datastreams[]url
stringnullable

Channel page URL.

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/livestreams?sort=viewers&language=en&limit=50" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Kick live directory.