Kick Channel Discovery + Snapshot

Find Kick channels from four workflows and return clean channel snapshots: known usernames, keyword search, category browsing, or live stream discovery with filters.

Outputs channel snapshots only. Videos and clips are not scraped by this actor; their URLs are included as channel metadata for follow-up workflows.

What This Actor Does

• Find channels by keyword using Kick search
• Discover channels from one or more categories
• Discover currently live channels with sort, language, and tag filters
• Extract specific channels when you already know the Kick usernames
• Return profile, follower, verification, social link, live status, livestream, and provenance fields

Which Mode Should I Use?

Goal	Use mode	Fill in
I already know the Kick usernames	channels	channelSlugs
I want channels matching a keyword such as poker, gta, or casino	search	searchKeywords
I want channels from Kick categories such as just-chatting, slots, or minecraft	category	categorySlugs, optional category filters
I want currently live channels sorted or filtered by tags/languages	livestreams	optional livestreamSort, livestreamLanguages, livestreamTags

Pick one workflow and fill in the matching fields. If channels mode is selected without channel usernames, the actor can infer a discovery mode from clear search/category/livestream inputs and will log the correction.

Why This Actor Is Different

• More discovery paths: exact usernames, Kick search, categories, and live browse filters.
• Channel snapshot output: profile data, follower count, verification, social links, live status, and livestream metadata when available.
• Live discovery controls: sort by recommended or viewers, filter by language, and filter by Kick stream tags.
• Category research: browse multiple category slugs in one run.
• API-first snapshots: after discovery, channel profiles are fetched through Kick channel APIs where possible to reduce browser overhead.
• Provenance fields: sourceUrl and sourceQuery show which search, category, or browse page produced each result.
• PPR guardrails: maxItems is capped and paid dataset item limits are respected.
• Anti-block handling: session rotation, retry/backoff behavior, cookie persistence, and browser fallback where needed.

Typical Use Cases

• Influencer discovery and outreach
• Live channel monitoring by tag or language
• Category benchmarking and market sizing
• Competitive research and benchmarking
• Content and audience research
• Market mapping for agencies

Input

Field	Type	Description
mode	string	channels, livestreams, search, category
channelSlugs	array	Channel usernames (for channels mode)
searchKeywords	string	Search query (for search mode)
categorySlugs	array	Category slugs (for category mode)
livestreamSort	string	recommended, viewers_high_to_low, viewers_low_to_high
livestreamLanguages	array	Language codes (e.g., en, bg)
livestreamTags	array	Exact live stream tags with no spaces (e.g., gaming, casual, gta)
categorySort	string	recommended, viewers_high_to_low, viewers_low_to_high
categoryLanguages	array	Language codes (e.g., en, bg)
maxItems	number	Max results for discovery modes (default: 100, hard cap: 1000, also limited by paid-item cap). Ignored for channels mode.

Filter behavior: invalid values are ignored with a warning that names the bad values. Language filters and livestream tags reject empty values, spaces, and values longer than 20 characters. Kick live tags are exact single values such as gaming, casual, gta, or gambling. For phrases such as CS GO, use mode: "search" with searchKeywords instead of livestreamTags.

Search note: Kick search may return fewer channels than maxItems. maxItems is a cap, not a guarantee.

Examples

1) Extract Specific Channels

{
	"mode": "channels",
	"channelSlugs": ["xqc", "trainwreckstv", "adin"]
}

2) Discover Live Channels (Sorted + Filtered)

{
	"mode": "livestreams",
	"livestreamSort": "viewers_high_to_low",
	"livestreamLanguages": ["bg", "en"],
	"livestreamTags": ["gaming", "casual", "gta"],
	"maxItems": 100
}

3) Search Channels

{
	"mode": "search",
	"searchKeywords": "poker",
	"maxItems": 25
}

4) Browse Categories (Sorted + Filtered)

{
	"mode": "category",
	"categorySlugs": ["just-chatting", "irl"],
	"categorySort": "recommended",
	"categoryLanguages": ["en"],
	"maxItems": 50
}

Output

Each dataset item is a channel snapshot:

{
	"type": "channel",
	"channelId": 12345,
	"slug": "xqc",
	"displayName": "xQc",
	"bio": "Channel description...",
	"profileImage": "https://...",
	"bannerImage": "https://...",
	"verified": true,
	"followersCount": 1500000,
	"isLive": true,
	"livestream": {
		"id": 67890,
		"title": "Stream Title",
		"viewerCount": 45000,
		"startedAt": "2024-01-15T18:00:00Z",
		"category": { "name": "Just Chatting" }
	},
	"sourceUrl": "https://kick.com/category/just-chatting?sort=recommended&languages=en",
	"sourceQuery": "just-chatting",
	"socialLinks": [{ "platform": "twitter", "url": "https://twitter.com/..." }],
	"channelUrl": "https://kick.com/xqc",
	"videosUrl": "https://kick.com/xqc/videos",
	"clipsUrl": "https://kick.com/xqc/clips",
	"scrapedAt": "2026-01-01T00:30:00Z"
}

Provenance Fields

• sourceUrl: discovery URL that produced the item (search/category/browse). Always present.
• sourceQuery: present only for search (search term) and category (category slug). Omitted for channels and livestreams.

Pricing

PPR pricing is based on 1 dataset item = 1 channel snapshot (per 1,000 channel snapshots).

Support

For questions, feature requests, or bug reports, please open an issue on this actor's page.