Kick hub

Kick Live Directory API

Find what is live now: streams by viewer count or featured order, narrowed by language, category or directory group.

GET /v1/kick/livestreams

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

About this endpoint

GET /v1/kick/livestreams returns data.streams and data.page. Sort with sort=viewers or sort=featured, narrow with language, categoryId and groupId, and set limit from 1 to 100. Send page.nextCursor as cursor to continue.

The directory order moves while you walk it, so a stream can repeat across cursor pages. The cursor remembers the last 50 ids it saw, and you should still de-duplicate by data.streams[].id. Each stream carries id, title, viewers, showsViewerCount, thumbnailUrl, startedAt, channel, category, languageCode, isMature, tags and url. viewers is null when showsViewerCount is false. An empty directory is lookupStatus: found with an empty list. An unknown language is refused with HTTP 400 that names language and points at /v1/kick/livestreams/languages.

Kick Live Directory API FAQ

How do I sort the live directory?

Use sort=viewers for most watched or sort=featured for the featured order. The default is viewers. Add language, categoryId or groupId to narrow the list, and limit for the page size.

Why can a stream appear twice?

The directory order can change while you page. The cursor remembers the last 50 ids it saw, but a moving list can still repeat a row. De-duplicate by data.streams[].id in your own store.

What is in a directory stream?

Each stream has id, title, viewers, showsViewerCount, thumbnailUrl, startedAt, channel, category, languageCode, isMature, tags and url. viewers is null when showsViewerCount is false. id is also the VOD id once the stream ends.

How many credits does one directory page 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. Each paginated page is a separate billed request.