Kick Streamer Intelligence Monitor

Kick’s public API exposes useful creator and livestream signals, but a raw directory dump is not a monitoring workflow. This Actor turns a watchlist, Kick search, or category scan into deterministic channel and stream records, with optional VOD and clip records for watched channels.

Use monitorMode: "changes" with the same explicit stateKey on a schedule to receive NEW, UPDATED, STATUS_CHANGED, REAPPEARED, EXPIRED, and (when requested) UNCHANGED events. Viewer count, follower count, title, category, live status, and ranking are compared between complete runs. Failed or truncated runs emit explicit failure rows and do not mark missing records expired.

Scope and inputs

Input	Description
mode	watchlist, search, or category.
watchlist	Channel slugs or { "channel": "slug", "inputId": "your-id" } objects. channelNames remains a legacy alias.
query	Search text for search mode.
category	Kick category slug for category mode.
recordTypes	channel, stream, vod, and/or clip. Watchlists default to channels and live streams; category/search default to streams.
maxResults	Deterministic output cap after filters and sorting.
minFollowers, minViewers	Numeric thresholds. Missing source values do not pass a threshold.
language, tags, verified, affiliate, mature	Exact or case-insensitive source filters. Set mature: false (or legacy excludeMature: true) to exclude mature records.
sortBy, sortOrder	Stable sorting by recordType, followers, viewers, rank, title, category, retrievedAt, or stableId, with stable ID tie-breaking.
monitorMode	snapshot or changes.
stateKey	Explicit stable key for a changes baseline. Required in changes mode.
includeUnchanged	Include UNCHANGED rows in changes mode.

Example watchlist monitor:

{
  "mode": "watchlist",
  "watchlist": [
    { "channel": "xqc", "inputId": "xqc-main" },
    "amouranth"
  ],
  "recordTypes": ["channel", "stream"],
  "minFollowers": 100000,
  "mature": false,
  "sortBy": "followers",
  "sortOrder": "desc",
  "monitorMode": "changes",
  "stateKey": "brand-watchlist-01"
}

Output contract

Every successful row has a canonical recordType (channel, stream, vod, or clip), a stable stableId, sourceUrl, inputId, retrievedAt, and status: "success". Monitor fields are stateKey, changeType, changedFields, firstSeenAt, and lastSeenAt.

Failure rows use recordType: "failure", status: "error", a source inputId, retrievedAt, and an errorCode such as HTTP_403, HTTP_404, HTTP_429, EMPTY_RESULT, PARSE_ERROR, or REQUEST_FAILED. Missing platform fields are omitted rather than filled with placeholders. Public profile fields such as chatroom, subscription, social, VOD, clip, mature, language, and tag values are included only when Kick supplies them.

Examples of stable records:

{
  "recordType": "stream",
  "stableId": "stream:01JPM733EGW4MHA5S5BWFATP3Q",
  "channelName": "spreen",
  "followersCount": 234567,
  "currentViewers": 18429,
  "streamTitle": "HOLA CHAT",
  "category": "Just Chatting",
  "rank": 1,
  "sourceUrl": "https://api.kick.com/private/v1/categories/just-chatting/livestreams?limit=25",
  "inputId": "category:just-chatting",
  "retrievedAt": "2026-08-02T08:00:00.000Z",
  "status": "success",
  "changeType": "UPDATED",
  "changedFields": ["currentViewers", "rank"]
}

API and limitations

The Actor uses Kick’s public API routes over HTTP and does not start a standby server or browser. Category and search results are ranked windows; an output cap or source failure makes the scan incomplete, so the Actor will not infer expirations from that run. Kick’s search response shape and private API availability can change; such failures are surfaced as dataset rows instead of being hidden.

The Actor does not download media, access authenticated chat, or fabricate unavailable follower, viewer, language, tag, affiliate, or ranking values.