# Kwai & Kuaishou Scraper (`sian.agency/kwai-kuaishou-scraper`) Actor Kwai & Kuaishou scraper + Kuaishou video downloader โ€” extract video data, user profiles, comments, user posts, keyword search. KOL discovery, view counts, engagement metrics, creator analytics for China market research. Six operations, one clean dataset per run. No API key. - **URL**: https://apify.com/sian.agency/kwai-kuaishou-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** Social media, Videos, Automation - **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 video details This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Kwai & Kuaishou Scraper โ€” Videos, KOL, Comments, Search ๐ŸŽฅ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Kwai](https://img.shields.io/badge/Platform-Kwai-FF6E10)](https://apify.com/sian.agency/kwai-kuaishou-scraper?fpr=sian) [![Kuaishou](https://img.shields.io/badge/Platform-Kuaishou-FF4906)](https://apify.com/sian.agency/kwai-kuaishou-scraper?fpr=sian) #### ๐ŸŽ‰ Six scrapers in one โ€” extract video data, profiles, comments, user posts & keyword search from China's #2 short-video platform ##### Built for KOL agencies, China-market researchers, brand teams, and content strategists who need clean structured Kwai & Kuaishou data โ€” no API key, no setup, no scraping headaches --- ### ๐Ÿ“‹ Overview **Tired of brittle DIY scrapers that break every time Kwai/Kuaishou ships a UI tweak?** This actor delivers reliable, flat structured datasets from China's #2 short-video platform (450M+ DAU) โ€” one clean run per task, one tidy dataset out. **Why teams choose SIรN for Kwai & Kuaishou data:** - โœ… **Six operations, one actor**: video detail ยท user profile ยท user video catalog ยท comments ยท search videos ยท search users - โšก **20โ€“30 results per page** on search & user feeds โ€” paginate to 50 pages in a single run - ๐ŸŽฏ **Production-ready data shape**: curated camelCase aliases (videoId, viewCount, likeCount, caption, postedAtโ€ฆ) PLUS the raw upstream fields for power users - ๐Ÿ’ฐ **Pay-per-result pricing** โ€” only charged for successful extractions, never for empty pages or errors - ๐Ÿ’Ž **No API key, no setup, no proxies** โ€” paste a video ID, user ID, or keyword and run - โœจ **NEW**: 19-digit Kuaishou video IDs preserved at full precision (most scrapers silently corrupt them); HTTPS auto-normalized on every media URL --- ### โœจ Features - ๐ŸŽฅ **Video Detail**: caption, view/like/share/comment/collect counts, playable video URL, cover, creator info, duration, timestamps - ๐Ÿ‘ค **User Profile**: fan count, follow count, photo count, bio, verification badge, location, constellation, full avatar set, banner - ๐Ÿ“น **User Videos**: full creator video catalog with engagement metrics, paginated ~10 videos/page - ๐Ÿ’ฌ **Video Comments**: top + reply comments with author, area, like count, hot-comment flag, plus a top-5 reply sample per thread - ๐Ÿ” **Search Videos**: keyword search supporting Chinese, English, and mixed queries โ€” ~20 results/page - ๐Ÿ”Ž **Search Users**: discover creators by keyword with handle, fans, verification, bio โ€” ~30 results/page - ๐Ÿ–ผ๏ธ **HTTPS-normalized URLs**: every video URL, cover, avatar, and banner ready to embed - ๐Ÿ†” **BigInt-safe IDs**: 19-digit Kuaishou photo/user IDs preserved (no precision loss โ†’ no broken cross-operation joins) - ๐Ÿ“„ **Pcursor pagination**: stream through up to 50 pages per run with one input parameter - ๐Ÿ“Š **HTML run report**: saved automatically to key-value store with success rate, errors, duration, inputs --- ### ๐ŸŽฌ Quick Start Paste a keyword to search Kwai/Kuaishou trending videos โ€” no Kwai API or Kuaishou downloader software required. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~kwai-kuaishou-scraper/runs?token=YOUR_TOKEN \ -d '{"operation":"searchVideo","keyword":"funny","maxPages":3}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Pick an operation Choose what you want to extract: Search Videos, Search Users, Video Detail, User Profile, User Videos, or Video Comments. #### Step 2: Enter the input A keyword (search), a video ID (detail/comments), or a user ID (profile/videos). #### Step 3: Click "Start" Results stream into the Apify dataset as they come back. Download as JSON, CSV, or Excel directly from the Console. **That's it! In under 60 seconds, you'll have:** - A flat, structured dataset (no nested CDN JSON to parse) - Curated camelCase fields plus the raw response for power users - An HTML report summarizing the run - Ready-to-embed HTTPS media URLs (videos, covers, avatars) *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | `operation` | string (enum) | Yes | One of: `videoDetail` ยท `userDetail` ยท `userVideos` ยท `videoComments` ยท `searchVideo` ยท `searchUser` | | `videoId` | string | If operation is `videoDetail` or `videoComments` | Kuaishou numeric video ID (also called `photo_id`). Find it in any Kuaishou video URL after `/short-video/`. | | `userId` | string | If operation is `userDetail` or `userVideos` | Kuaishou numeric user ID. Find it in any profile URL after `/profile/` or in any result row's `user_id` field. | | `keyword` | string | If operation is `searchVideo` or `searchUser` | Search query (Chinese, English, or mixed โ€” e.g. `funny`, `็พŽ้ฃŸ`, `dance challenge`) | | `maxPages` | integer | No | Pages to fetch for paginated operations (default 5, max 50) | **Example โ€” Search trending Kwai/Kuaishou videos:** ```json { "operation": "searchVideo", "keyword": "็พŽ้ฃŸ", "maxPages": 3 } ``` **Example โ€” Pull a creator's full video catalog (Kuaishou video downloader workflow):** ```json { "operation": "userVideos", "userId": "2542916559", "maxPages": 10 } ``` **Example โ€” Get full video details by ID:** ```json { "operation": "videoDetail", "videoId": "5241627202658372579" } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **40+ curated fields** plus all raw upstream fields. Filter by `_operation` to split modes; four predefined dataset views ready to open in Apify Console (Overview / Videos / Users / Comments). | Field | Type | Description | |-------|------|-------------| | `videoId` | string | Kuaishou video ID (19-digit, precision preserved) | | `videoPageUrl` | string | Direct link to the video on Kuaishou | | `caption` | string | Video caption (Chinese / English / mixed) | | `videoUrl` | string | Playable video stream URL (no watermark) | | `videoUrlList` | array | All quality variants of the stream | | `coverUrl` | string | Primary video thumbnail | | `durationMs` | integer | Video length in milliseconds | | `viewCount` | integer | Total plays | | `likeCount` | integer | Likes | | `shareCount` | integer | Shares | | `commentCount` | integer | Comments | | `collectCount` | integer | Saves/bookmarks | | `postedAt` | string | Upload timestamp (human-readable) | | `userId` | string | Creator's Kuaishou user ID | | `userName` | string | Creator's display name | | `kwaiId` | string | Creator's Kwai handle (e.g. `Mr_pasang`) | | `userVerified` | boolean | Verified badge | | `userPageUrl` | string | Direct link to the creator's profile | | `avatarUrl` | string | Creator's profile picture (HTTPS) | | `fanCount` | integer | Fans / followers (profile rows) | | `followCount` | integer | Following count (profile rows) | | `photoCount` | integer | Total posts (profile rows) | | `userBio` | string | Profile description (profile rows) | | `commentId` | string | Comment ID (comment rows) | | `content` | string | Comment text | | `likedCount` | integer | Likes on the comment | | `authorArea` | string | Commenter's region (e.g. `ๆฒณๅŒ—`) | | `subCommentSample` | array | Top 5 replies per thread | **Example dataset row (search video):** ```json { "_operation": "searchVideo", "_sourceKeyword": "funny", "videoId": "5241908663322906194", "userId": "2542916559", "userName": "Pasangๅคงๅซ๐Ÿ‡ณ๐Ÿ‡ต", "kwaiId": "Mr_pasang", "caption": "Windows7 ๐Ÿคฃ๐Ÿคฃ๐Ÿคฃ #funnyvideo #prank #fyp", "viewCount": 5993, "likeCount": 51, "shareCount": 461, "commentCount": 4, "videoUrl": "https://tymov2.a.kwimgs.com/upic/...", "coverUrl": "https://p66-plat.wsukwai.com/upic/...", "videoPageUrl": "https://www.kuaishou.com/short-video/5241908663322906194", "userPageUrl": "https://www.kuaishou.com/profile/2542916559", "postedAt": "2025-08-19 21:08:15", "status": "success" } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. KOL & Creator Discovery for China-Market Brands **Influencer marketing teams** at Western brands shortlisting Kuaishou KOLs for product seeding and brand partnerships. **Input:** Search Users with keyword "็พŽ้ฃŸ" (food) or "ๆ—ถๅฐš" (fashion) **Output:** 30 creators per page with fan counts, verification, bio, avatar **Use:** Build a ranked KOL shortlist in 5 minutes instead of 5 hours of manual scrolling. #### 2. China Market-Entry Research **Market intelligence analysts** monitoring short-video trends before launching a brand in China. **Input:** Search Videos with industry keyword across 10 pages **Output:** 200 videos with engagement metrics, captions, hashtags, posting times **Use:** Spot trending themes, viral content patterns, and competitor activity weeks before launch. #### 3. Content Trend Tracking **Content strategists** at agencies tracking viral videos, breakout creators, and emerging hashtags daily. **Input:** Scheduled Search Videos run with niche keyword **Output:** Time-series of trending content + engagement velocity **Use:** Feed a trend dashboard or alert system; spot virality 24โ€“48 hours before mainstream. #### 4. Comment Sentiment Mining **NLP / brand-perception teams** analyzing reactions on competitor videos or branded-content collaborations. **Input:** Video Comments operation on competitor video IDs **Output:** All top comments + reply samples with author, area, like counts **Use:** Pipe to a sentiment model to gauge audience reaction; identify advocacy & detractor patterns. #### 5. Creator Catalog Mapping (KOL Audit) **Influencer-marketing agencies** doing due diligence on a creator before signing them. **Input:** User Videos operation across 10โ€“20 pages for the creator's user ID **Output:** Full posting history with view/like/share counts and timestamps **Use:** Audit posting cadence, engagement drift, fake-fan red flags, and content quality at scale. #### 6. Brand Monitoring on Chinese Short Video **Brand managers** tracking unauthorized mentions, branded-content performance, and counterfeits. **Input:** Search Videos with brand or product keyword scheduled hourly **Output:** Every new mention with creator + engagement **Use:** React to viral mentions in near real-time; flag counterfeits & PR risks. #### 7. Kuaishou Video Downloader for Content Re-purposing **Editors & creators** archiving public Kwai/Kuaishou videos for legal commentary, education, or research. **Input:** Video Detail by ID **Output:** HTTPS-ready `videoUrl` + alternative quality variants **Use:** Bulk archive, repurpose, or analyze video content without manual right-click-save. *** ### ๐Ÿ”— Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/kwai-kuaishou-scraper').call({ operation: 'searchVideo', keyword: 'funny', maxPages: 3, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/kwai-kuaishou-scraper').call( run_input={'operation': 'userVideos', 'userId': '2542916559', 'maxPages': 5} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~kwai-kuaishou-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"operation":"videoDetail","videoId":"5241627202658372579"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: schedule daily or webhook from a brief-creator 2. **HTTP Request**: call the actor's run-sync endpoint with `operation` + input 3. **Process**: filter by `_operation` and pivot on `videoId` / `userId` / `commentId` 4. **Action**: push to BigQuery, Notion, Airtable, or a Slack alert *** ### ๐Ÿ“Š Performance & Pricing #### FREE Tier (Try It Now) - **Full feature access** โ€” every operation, every field, no quality compromise - No credit card required - Perfect for evaluating data depth before you commit #### PAID Tier (Production Ready) - **Unlimited** results per run - Faster processing โ€” no FREE-tier throttling - Pay-per-result: only charged for successful rows, never for errors or empty pages - Volume discounts up to 50% off at GOLD/PLATINUM/DIAMOND Apify tiers ๐Ÿ’ฐ **Best price on the market for premium Kwai/Kuaishou data** โ€” see pricing tab for the full per-event ladder. Single-row operations (Video Detail, User Profile) carry richer payloads at premium pricing; bulk operations (Search, User Videos, Comments) are priced to scale with you. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/kwai-kuaishou-scraper?fpr=sian) *** ### โ“ Frequently Asked Questions **Q: How many videos / users / comments can I extract per run?** A: FREE tier: full feature access for evaluation. PAID tier: unlimited โ€” capped only by `maxPages` (default 5, max 50) and platform-side data availability. **Q: Does it work with private profiles or shadow-banned accounts?** A: No โ€” only publicly accessible Kwai/Kuaishou content is supported. Private accounts and banned users return empty or error rows. **Q: What output formats are available?** A: JSON, CSV, Excel, RSS, HTML, XML โ€” export directly from the Apify dataset UI or via API. **Q: Are video URLs permanent?** A: Kuaishou CDN URLs typically expire after a few hours. Use `videoUrlList` for fallback mirrors, or re-run Video Detail when you need a fresh URL. **Q: Why are Kuaishou video IDs 19 digits โ€” does the dataset preserve them?** A: Yes. We use a bigint-safe JSON parser so 19-digit IDs (`photo_id`, `user_id`, `comment_id`) round-trip without precision loss. Most scrapers silently corrupt these and break cross-operation joins. **Q: Can I search in Chinese?** A: Absolutely. Chinese, English, and mixed queries all work โ€” Chinese tends to surface more native creators; English surfaces more international Kwai users. **Q: Is this legal?** A: Yes โ€” we only extract publicly available data. See the [Legal section](#-is-it-legal-to-scrape-data) below. **Q: How long does processing take?** A: ~3โ€“10 seconds per page for paginated operations; ~2โ€“5 seconds for single-row operations. *** ### ๐Ÿ› Troubleshooting **Page returned no rows / empty dataset** - Verify the input is correct: video ID has 18โ€“19 digits, user ID is numeric, keyword is non-empty - Check that the video/user still exists on Kuaishou (try opening `videoPageUrl` or `userPageUrl` from a result row) - For comments: not every video has comments โ€” try a different video ID **HTTP errors / "Data source temporarily unavailable" rows** - The actor auto-retries transient failures up to 4 times with backoff. If you still see error rows, the upstream is rate-limited or down โ€” retry the run after a few minutes. **19-digit video IDs look truncated in spreadsheet exports** - Spreadsheet apps (Excel, Google Sheets) auto-cast long integers to scientific notation. The actor preserves them as strings in JSON; in CSV exports, format the `videoId` column as Text before opening. **Pagination ends earlier than `maxPages` requested** - That means the platform served the last page. Check `_page` on the last row โ€” `isLastPage` was true. Not all creators or keywords have 50 pages of content. *** ### โš ๏ธ Trademark Disclaimer This actor is an **independent scraping tool** and is not affiliated with, endorsed by, or sponsored by Kuaishou Technology Co., Ltd. or any of its subsidiaries. "Kwai" and "Kuaishou" are used solely in a descriptive sense to identify the public data source the actor reads from. **Kwaiยฎ** and **Kuaishouยฎ** are trademarks of their respective owners. All other trademarks are the property of their respective owners. *** ### โš–๏ธ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### โœจ More by SIรN Agency Part of the SIรN Agency Apify portfolio โ€” production-grade scrapers and AI tools used by agencies, research teams, and brands. A few that pair well with Kwai & Kuaishou: **China & E-commerce** - [Taobao & Tmall Product Scraper](https://apify.com/sian.agency/taobao-tmall-product-scraper?fpr=sian) โ€” China's #1 marketplace: products, search, shop catalogs, reviews - [Uber Eats Menu Scraper](https://apify.com/sian.agency/uber-eats-menu-scraper?fpr=sian) โ€” restaurant menus + prices **Short-Video & Social Media** - [Best TikTok AI Transcript Extractor](https://apify.com/sian.agency/best-tiktok-ai-transcript-extractor?fpr=sian) โ€” TikTok video โ†’ text with metadata - [Instagram AI Transcript Extractor](https://apify.com/sian.agency/instagram-ai-transcript-extractor?fpr=sian) โ€” Reels & Stories transcription - [Facebook AI Transcript Extractor](https://apify.com/sian.agency/facebook-ai-transcript-extractor?fpr=sian) โ€” Facebook video โ†’ text - [YouTube Shorts AI Transcript & Metadata Extractor](https://apify.com/sian.agency/youtube-shorts-ai-transcript-and-metadata-extractor?fpr=sian) โ€” Shorts data + transcripts **Real Estate (Global)** - [Zillow Property Scraper](https://apify.com/sian.agency/zillow-property-scraper?fpr=sian) ยท [Airbnb Scraper](https://apify.com/sian.agency/airbnb-property-scraper?fpr=sian) ยท [Bayut (Dubai)](https://apify.com/sian.agency/bayut-property-scraper?fpr=sian) ยท [Redfin](https://apify.com/sian.agency/redfin-property-scraper?fpr=sian) ยท [StreetEasy (NYC)](https://apify.com/sian.agency/streeteasy-property-scraper?fpr=sian) ยท [Zoopla (UK)](https://apify.com/sian.agency/zoopla-property-scraper?fpr=sian) ยท [Realtor.com](https://apify.com/sian.agency/realtor-property-scraper?fpr=sian) [Browse all SIรN actors โ†’](https://apify.com/sian.agency?fpr=sian) *** ### โญ Leave a 5-Star Review Love this actor? **[Leave a 5-star review here](https://apify.com/sian.agency/kwai-kuaishou-scraper/reviews)** โ€” it helps us build more features for you and lets other teams find it. *** ### ๐Ÿค Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's Apify Console Issues tab - ๐Ÿ“ง *** **Built by [SIรN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `operation` (type: `string`): ๐ŸŽฏ **PICK ONE OPERATION PER RUN.** Each run produces one clean dataset matching the chosen mode. - **๐ŸŽฅ Video Detail** โ€” deep scrape of a single video by ID (caption, view/like/share/comment counts, video URL, cover, creator info, timestamps) - **๐Ÿ‘ค User Profile** โ€” full profile by user ID (fan count, follow count, photo count, bio, verification, location, avatar, banner) - **๐Ÿ“น User Videos** โ€” paginated list of a creator's full video history (~10 videos/page) - **๐Ÿ’ฌ Video Comments** โ€” paginated comments on a single video, with reply samples (~9 comments/page) - **๐Ÿ” Search Videos** โ€” keyword search across Kwai/Kuaishou videos, paginated (~20 results/page) - **๐Ÿ”Ž Search Users** โ€” keyword search across Kwai/Kuaishou creators, paginated (~30 results/page) ๐Ÿ’ก **TIP:** To combine operations, run the actor multiple times with different configurations. ## `videoId` (type: `string`): ๐ŸŽฅ **Required for `Video Detail` and `Video Comments` operations.** The numeric Kuaishou video ID (also called `photo_id`). You can find it: - In any Kuaishou video URL: `https://www.kuaishou.com/short-video/{ID}` โ†’ the trailing segment - In the `videoId` / `photo_id` field of any search or user-videos result row ๐Ÿ’ก **TIP:** To analyze a batch of videos, run a `Search Videos` operation first, copy the `videoId` from the result rows, then run `Video Detail` per ID. โš ๏ธ **Ignored** for User Profile, User Videos, and Search operations. ## `userId` (type: `string`): ๐Ÿ‘ค **Required for `User Profile` and `User Videos` operations.** The numeric Kuaishou user ID. You can find it: - In the `userId` / `user_id` field of any video, search, or comment result row - In a creator's profile URL: `https://www.kuaishou.com/profile/{ID}` ๐Ÿ’ก **TIP:** To build a list of creators in a niche, run `Search Users` with a keyword first, then use the top `userId` values to drill into individual profiles or video catalogs. โš ๏ธ **Ignored** for Video Detail, Video Comments, and Search operations. ## `keyword` (type: `string`): ๐Ÿ” **Required for `Search Videos` and `Search Users` operations.** Any Kwai/Kuaishou search query. Supports Chinese, English, and mixed queries: - `funny` - `ๆž็ฌ‘่ง†้ข‘` (funny videos) - `็พŽ้ฃŸ` (food) - `dance challenge` ๐Ÿ’ก **TIP:** Specific niches return higher-relevance results. Chinese-language queries surface more native creators; English queries surface international Kwai creators. ## `maxPages` (type: `integer`): ๐Ÿ“„ **Applies to paginated operations** (User Videos, Video Comments, Search Videos, Search Users). Ignored for single-record operations (Video Detail, User Profile). - **User Videos:** ~10 videos per page - **Video Comments:** ~9 comments per page - **Search Videos:** ~20 results per page - **Search Users:** ~30 results per page ๐Ÿ’ก **TIP:** Start small (1โ€“3 pages) to preview results before scaling up. โš ๏ธ Hard cap: 50 pages to prevent runaway runs. ## Actor input object example ```json { "operation": "searchVideo", "videoId": "5241627202658372579", "userId": "2542916559", "keyword": "funny", "maxPages": 5 } ``` # Actor output Schema ## `output` (type: `string`): Videos, profiles, comments, or search results โ€” one flat row per upstream item with curated camelCase aliases (videoId, userId, viewCount, likeCount, caption, postedAt, videoUrl, coverUrl, avatarUrl, โ€ฆ) plus the raw upstream fields spread alongside. ## `report` (type: `string`): HTML report with run status, success/error row counts, success rate, pages fetched, duration, and the inputs used โ€” written even on fatal crash. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "videoId": "5241627202658372579", "userId": "2542916559", "keyword": "funny" }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/kwai-kuaishou-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "videoId": "5241627202658372579", "userId": "2542916559", "keyword": "funny", } # Run the Actor and wait for it to finish run = client.actor("sian.agency/kwai-kuaishou-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "videoId": "5241627202658372579", "userId": "2542916559", "keyword": "funny" }' | apify call sian.agency/kwai-kuaishou-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/kwai-kuaishou-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kwai & Kuaishou Scraper", "description": "Kwai & Kuaishou scraper + Kuaishou video downloader โ€” extract video data, user profiles, comments, user posts, keyword search. KOL discovery, view counts, engagement metrics, creator analytics for China market research. Six operations, one clean dataset per run. No API key.", "version": "1.0", "x-build-id": "WCbF4kI31HrEAb0Jf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~kwai-kuaishou-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-kwai-kuaishou-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~kwai-kuaishou-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-kwai-kuaishou-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~kwai-kuaishou-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-kwai-kuaishou-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "operation" ], "properties": { "operation": { "title": "๐ŸŽฏ Operation โ€” what do you want to scrape?", "enum": [ "videoDetail", "userDetail", "userVideos", "videoComments", "searchVideo", "searchUser" ], "type": "string", "description": "๐ŸŽฏ **PICK ONE OPERATION PER RUN.** Each run produces one clean dataset matching the chosen mode.\n\n- **๐ŸŽฅ Video Detail** โ€” deep scrape of a single video by ID (caption, view/like/share/comment counts, video URL, cover, creator info, timestamps)\n- **๐Ÿ‘ค User Profile** โ€” full profile by user ID (fan count, follow count, photo count, bio, verification, location, avatar, banner)\n- **๐Ÿ“น User Videos** โ€” paginated list of a creator's full video history (~10 videos/page)\n- **๐Ÿ’ฌ Video Comments** โ€” paginated comments on a single video, with reply samples (~9 comments/page)\n- **๐Ÿ” Search Videos** โ€” keyword search across Kwai/Kuaishou videos, paginated (~20 results/page)\n- **๐Ÿ”Ž Search Users** โ€” keyword search across Kwai/Kuaishou creators, paginated (~30 results/page)\n\n๐Ÿ’ก **TIP:** To combine operations, run the actor multiple times with different configurations.", "default": "searchVideo" }, "videoId": { "title": "๐ŸŽฅ Video ID (for Video Detail / Video Comments)", "type": "string", "description": "๐ŸŽฅ **Required for `Video Detail` and `Video Comments` operations.**\n\nThe numeric Kuaishou video ID (also called `photo_id`). You can find it:\n- In any Kuaishou video URL: `https://www.kuaishou.com/short-video/{ID}` โ†’ the trailing segment\n- In the `videoId` / `photo_id` field of any search or user-videos result row\n\n๐Ÿ’ก **TIP:** To analyze a batch of videos, run a `Search Videos` operation first, copy the `videoId` from the result rows, then run `Video Detail` per ID.\n\nโš ๏ธ **Ignored** for User Profile, User Videos, and Search operations." }, "userId": { "title": "๐Ÿ‘ค User ID (for User Profile / User Videos)", "type": "string", "description": "๐Ÿ‘ค **Required for `User Profile` and `User Videos` operations.**\n\nThe numeric Kuaishou user ID. You can find it:\n- In the `userId` / `user_id` field of any video, search, or comment result row\n- In a creator's profile URL: `https://www.kuaishou.com/profile/{ID}`\n\n๐Ÿ’ก **TIP:** To build a list of creators in a niche, run `Search Users` with a keyword first, then use the top `userId` values to drill into individual profiles or video catalogs.\n\nโš ๏ธ **Ignored** for Video Detail, Video Comments, and Search operations." }, "keyword": { "title": "๐Ÿ” Search Keyword (for Search Videos / Search Users)", "type": "string", "description": "๐Ÿ” **Required for `Search Videos` and `Search Users` operations.**\n\nAny Kwai/Kuaishou search query. Supports Chinese, English, and mixed queries:\n- `funny`\n- `ๆž็ฌ‘่ง†้ข‘` (funny videos)\n- `็พŽ้ฃŸ` (food)\n- `dance challenge`\n\n๐Ÿ’ก **TIP:** Specific niches return higher-relevance results. Chinese-language queries surface more native creators; English queries surface international Kwai creators." }, "maxPages": { "title": "๐Ÿ“„ Max pages to fetch", "minimum": 1, "maximum": 50, "type": "integer", "description": "๐Ÿ“„ **Applies to paginated operations** (User Videos, Video Comments, Search Videos, Search Users). Ignored for single-record operations (Video Detail, User Profile).\n\n- **User Videos:** ~10 videos per page\n- **Video Comments:** ~9 comments per page\n- **Search Videos:** ~20 results per page\n- **Search Users:** ~30 results per page\n\n๐Ÿ’ก **TIP:** Start small (1โ€“3 pages) to preview results before scaling up.\n\nโš ๏ธ Hard cap: 50 pages to prevent runaway runs.", "default": 5 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```