# Changelog of Kwai & Kuaishou Scraper (`sian.agency/kwai-kuaishou-scraper`) Actor

- **URL**: https://apify.com/sian.agency/kwai-kuaishou-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/kwai-kuaishou-scraper.md

## Changelog

All notable changes to **Kwai & Kuaishou Scraper** will be documented in this file.

### \[2026-09-12]

#### 🔑 API runs now need a paid Apify plan

- **The Console stays free** — running this Actor from the Apify Console is unchanged, and so is starting it from an AI agent over MCP. Free plans keep their daily allowance and their result limit exactly as before.
- **Starting a run through the Apify API now requires a paid plan** — free-plan API runs stop immediately with a message explaining why, before anything is fetched or billed. Nothing is charged for a run that stops this way.
- **Why** — scripted free-plan API traffic was consuming the capacity paying customers rely on. Keeping it out protects run speed and availability for everyone on a paid plan.
- **If this affects you** — add credits or a payment method in Apify Console → Billing, and your existing API calls work again with no change to your input.

### \[2026-09-04]

- 💬 **A run that finds nothing now says so.** Looking up a video, profile or keyword that isn't in the index used to finish with an empty dataset and no explanation. Every operation now returns one unbilled row naming what to check.
- 🔎 **Creator search now reports its real state.** Search Users answered "temporarily unavailable, please retry" for a source that has returned nothing since mid-August. It now says so plainly and points to Search Videos, whose rows carry each creator's `userId` for use with User Profile. The operation is still attempted every run, so it resumes when results come back.
- 🌎 **Coverage stated up front.** The Video ID field and the FAQ now say that IDs from the international Kwai app (`kwai.com`) are not in the kuaishou.com index.

### \[2026-06-20]

- 🧯 **Graceful gateway-error handling.** Temporary upstream error pages are now retried and routed cleanly instead of surfacing as confusing parsing failures.

### \[2026-05-11]

#### 🎉 Kwai & Kuaishou Scraper — Launch!

- **Six Scrapers in One Actor** — extract Kwai & Kuaishou video data, profiles, user video catalogs, comments, and run keyword searches across videos and creators — pick the operation, paste the input, one clean dataset per run.
- **Video Detail Extraction** — full Kuaishou video payload by ID: caption, view/like/share/comment/collect counts, no-watermark Kuaishou video downloader URLs, cover, creator info, duration, timestamps.
- **User Profile Scraping** — full Kwai/Kuaishou creator profile by user ID: fan count, follow count, photo count, bio, verification badge, location, full avatar set, banner — ideal for KOL discovery.
- **User Video Catalog Mapping** — paginated history of any creator's posts (~10 videos/page) with engagement metrics for KOL audit & content-strategy reverse engineering.
- **Video Comment Mining** — paginated comments with author, area, like count, hot-comment flag, and top-5 reply sample per thread — feed your sentiment models with structured comment data.
- **Search Videos by Keyword** — surface trending Kwai/Kuaishou videos in any niche (Chinese · English · mixed queries supported), ~20 results/page.
- **Search Creators by Keyword** — discover Chinese-market KOLs by keyword with handle, fans, verification, bio — ~30 results/page.
- **BigInt-Safe 19-Digit IDs** — Kuaishou photo and user IDs are preserved at full precision (most scrapers silently corrupt them and break cross-operation joins).
- **HTTPS-Normalized Media URLs** — every video URL, cover, avatar, and banner is delivered ready to embed.
- **Pcursor Pagination + Safety Cap** — stream up to 50 pages per run with a single input parameter; auto-stop on last page.
- **Curated camelCase Aliases + Raw Fields** — clean `videoId` · `viewCount` · `userName` · `caption` aliases for everyday users, plus all raw upstream fields spread alongside for power users.
- **HTML Run Report** — every run produces an HTML summary (success rate, errors, duration, inputs) saved to the key-value store.
- **Four Predefined Dataset Views** — Overview / Videos / Users / Comments — open the right table layout from the Apify Console with one click.

#### 💎 User Benefits

- **Save hours per KOL shortlist** — search Kuaishou creators by keyword and rank by fans in 5 minutes instead of 5 hours of manual scrolling.
- **No API key, no setup, no proxies** — paste a video ID, user ID, or keyword and run. Production-ready from the first click.
- **Pay-per-result pricing** — only charged for successful extractions; never billed for empty pages or upstream errors.
- **Bulletproof data shape** — flat structure with both camelCase aliases and raw fields means every downstream tool (BigQuery, Notion, Airtable, Slack) just works.
- **Cross-operation joins that actually work** — bigint-safe IDs let you pivot from search results → video detail → comments without losing a single character of precision.
- **GDPR-friendly defaults** — extracts only publicly shared data; no private user info, no email or phone scraping.

#### 🎯 Use Cases

- **KOL Agency** building a Kuaishou shortlist for a brand campaign — runs Search Users + User Profile across 10 keywords in 30 minutes.
- **Market Intelligence Analyst** at a global FMCG brand monitoring China short-video trends before launching a new SKU — schedules daily Search Videos runs across product-category keywords.
- **Brand Manager** at a luxury label tracking counterfeit & gray-market mentions on Kwai/Kuaishou — hourly Search Videos with brand keyword + Slack alerts on high-engagement matches.
- **NLP Researcher** building a Chinese-language sentiment dataset — pulls Video Comments across hundreds of viral videos in one weekend.
- **Influencer-Marketing Agency** doing due diligence on a creator before signing — runs User Videos across 20 pages to audit posting cadence, engagement drift, and content quality.
- **Content Strategist** at a media agency tracking viral video patterns weekly — scheduled Search Videos run feeds a trend dashboard with view-velocity rankings.
- **Video Editor / Content Creator** archiving public Kwai videos for legal commentary, education, or research — runs Video Detail by ID to grab no-watermark stream URLs.
