# Kuaishou 快手 Scraper (`parsebird/kuaishou-scraper`) Actor Scrape Kuaishou 快手 videos from video links, IDs and share links, plus Kuaishou's recommended feed. Get captions, views, likes, comment counts, MP4 play URLs in every quality, music and creator follower counts. No login. Export JSON, CSV, Excel or use the API. - **URL**: https://apify.com/parsebird/kuaishou-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.79 / 1,000 videos 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### Kuaishou 快手 Scraper **Kuaishou Scraper** extracts public video data from [Kuaishou (快手)](https://www.kuaishou.com/), the Chinese short-video app that is known as Kwai outside China. Paste Kuaishou video links, mobile share links or video IDs. Each video comes back with its caption, hashtags, views, likes, comment count, cover, MP4 play URLs in every quality, the music track and the creator's follower, following and video counts. You can also collect more videos from the recommended feed Kuaishou shows under each video. You don't need a Kuaishou account, a cookie or an API key.
One row per Kuaishou video with 30+ fields: caption, hashtags, post time, cover, duration, resolution, views, likes, comments and shares, every MP4 and HLS rendition with its quality and bitrate, the music or original sound with its audio file, and the creator's name, IDs, gender, followers, following, video count and collections.
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` Apify Actor: parsebird/kuaishou-scraper. Scrapes public Kuaishou (kuaishou.com, 快手) videos without login. Call via ApifyClient: client.actor("parsebird/kuaishou-scraper").call(run_input={"startUrls": ["https://www.kuaishou.com/short-video/3x23t55n9xbd2ac"], "maxRecommendedVideos": 20}). Inputs: startUrls (string[]: Kuaishou video URLs like https://www.kuaishou.com/short-video/3x23t55n9xbd2ac, share links like https://v.kuaishou.com/XXXX, m.gifshow.com/fw/photo/ID or v.m.chenzhongtech.com/fw/photo/ID links, or bare video IDs such as 3x23t55n9xbd2ac or 5193776400231988498), maxRecommendedVideos (integer, default 0, 0-1000: extra videos per input video from Kuaishou's recommended feed, a broad mix of popular videos), maxItems (integer, default 0 = no ceiling: total videos per run), proxyConfiguration (optional). Profile, hashtag and search URLs and comments are not supported because Kuaishou requires a login for them. Output: one row per video: id (numeric), shortId, text (caption), createTime (ms), createTimeISO, createDate (DD/MM/YYYY), url, photoType, thumb, cover, duration (s), durationMs, width, height, playUrl (MP4), allPlayUrls [{url, format, qualityType, qualityLabel, videoCodec, avgBitrate, width, height, fileSize}], images, likeCount, commentCount, viewCount, forwardCount, hashtags, authorMeta {id, name, username, verified, avatar, gender, followersCount, followingCount, photoCount, collectionCount, url}, musicMeta {id, name, artist, type, hasCopyright, loudness, isOriginal, audioUrl, coverUrl, usageCount}, inputUrl, recommendedFrom. Pricing: pay per video saved. Full API spec: https://apify.com/parsebird/kuaishou-scraper/api. Get your token: https://console.apify.com/settings/integrations. ``` ### What is Kuaishou Scraper? **Kuaishou Scraper** turns Kuaishou video pages into structured data. Paste one or many Kuaishou video links and click **Start**. The output is clean rows of Kuaishou video data: captions, view counts, likes, comment counts, direct MP4 links in every available quality, music details and creator statistics. You can download it as **JSON, CSV or Excel** or read it through the API. It works as a **Kuaishou API alternative**. Kuaishou has no public data API, so the Actor reads the same public video pages a logged-out visitor opens from a share link. You never have to sign in or scan a QR code. ### What can Kuaishou Scraper do? - 🎬 **Scrape Kuaishou videos by URL.** Paste desktop links (`www.kuaishou.com/short-video/...`), app share links (`v.kuaishou.com/...`), mobile links (`m.gifshow.com/fw/photo/...`, `v.m.chenzhongtech.com/fw/photo/...`) or bare video IDs, and get one detailed row per video. - 🔥 **Collect popular Kuaishou videos.** Set **Recommended videos per video** to also save videos from the recommended feed Kuaishou shows under each of your videos. - 🎞️ **Get every video file.** `playUrl` is a direct MP4 link, and `allPlayUrls` lists each rendition Kuaishou offers with its format, quality, codec and bitrate. - 🎵 **Get the music.** `musicMeta` names the song or original sound (原声) and links its audio file. - 👤 **Get creator stats.** Every row includes the creator's followers, following, video count and collections. - 📅 **Schedule and monitor.** Re-run the same video list daily or hourly with [Apify Schedules](https://docs.apify.com/platform/schedules) to track how views, likes and comments grow. - 🔌 **API and integrations.** Use the [Apify API](https://docs.apify.com/api/v2), or send results to Google Sheets, Zapier, Make, Slack or webhooks with [Apify integrations](https://docs.apify.com/platform/integrations). Export as JSON, CSV, Excel, XML or HTML. ### What data can you extract from Kuaishou? | Field | Description | |-------|-------------| | `id` | Numeric Kuaishou video ID, for example `5193776400231988498` | | `shortId` | The short video ID used in kuaishou.com links, for example `3x23t55n9xbd2ac` | | `text` | The video's caption | | `hashtags` | Hashtags found in the caption | | `createTime` · `createTimeISO` · `createDate` | When the video was posted: Unix milliseconds, ISO 8601 (UTC) and DD/MM/YYYY | | `url` | Video page on kuaishou.com | | `thumb` · `cover` | Cover image URL | | `duration` · `durationMs` · `width` · `height` | Length in seconds and milliseconds, and resolution in pixels | | `playUrl` | Direct MP4 link, H.264 when available | | `allPlayUrls` | Every rendition: `url`, `format` (mp4 or hls), `qualityType` (e.g. 720p), `qualityLabel`, `videoCodec`, `avgBitrate`, `width`, `height`, `fileSize` | | `viewCount` · `likeCount` · `commentCount` · `forwardCount` | Engagement counts | | `authorMeta` | Creator: `id`, `name`, `username`, `verified`, `avatar`, `gender`, `followersCount`, `followingCount`, `photoCount`, `collectionCount`, `url` | | `musicMeta` | Music or original sound: `id`, `name`, `artist`, `type`, `hasCopyright`, `loudness`, `isOriginal`, `audioUrl`, `coverUrl`, `usageCount`. `null` when the video has no music | | `photoType` · `images` | Post type, and the image URLs of a photo post | | `inputUrl` · `recommendedFrom` | Which of your inputs produced the row, and for recommended videos the video they were found under | ### How to scrape Kuaishou videos 1. Open [Kuaishou Scraper](https://apify.com/parsebird/kuaishou-scraper) on Apify Store and click **Try for free**. 2. In **Video URLs**, paste Kuaishou video links, share links or video IDs, one per line. To get a link from the Kuaishou app, tap **Share** and then **Copy link**. 3. Optionally set **Recommended videos per video** to also save videos from Kuaishou's recommended feed. Leave it at `0` to scrape only your own links. 4. Click **Start**. When the run finishes, open the **Output** tab and download your Kuaishou data as JSON, CSV, Excel, XML or HTML, or read it with the API. #### Scrape specific Kuaishou videos ```json { "startUrls": [ "https://www.kuaishou.com/short-video/3x23t55n9xbd2ac", "https://v.m.chenzhongtech.com/fw/photo/3xtczn8ezuyxzfa", "5237405097205858899" ] } ``` Each link or ID returns one row. The same video given in two forms, for example its short ID and its numeric ID, is saved and charged once. #### Collect popular Kuaishou videos from the recommended feed ```json { "startUrls": ["https://www.kuaishou.com/short-video/3x23t55n9xbd2ac"], "maxRecommendedVideos": 100 } ``` This saves the video plus up to 100 videos from the feed Kuaishou recommends under it. Kuaishou shows logged-out visitors a broad mix of popular videos there, not only videos on the same topic, so treat it as a sample of what's popular on Kuaishou right now. Each recommended row has `recommendedFrom` set to the video it came from. ### Input parameters See the [Input tab](https://apify.com/parsebird/kuaishou-scraper/input-schema) for the full form. | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | string\[] | — | Kuaishou video URLs, share links or bare video IDs | | `maxRecommendedVideos` | integer | `0` | Videos to add per input video from Kuaishou's recommended feed, 0–1,000 | | `maxItems` | integer | `0` | Ceiling on total videos per run, including recommended videos. `0` means no ceiling | | `proxyConfiguration` | object | none | Not needed for normal use | ⚠️ **Accepted inputs.** A video is `https://www.kuaishou.com/short-video/ID`, a `v.kuaishou.com/...` or `kuaishou.com/f/...` share link, an `m.gifshow.com/fw/photo/ID` or `v.m.chenzhongtech.com/fw/photo/ID` link, or a bare ID (`3x...` or a 19-digit number). Profile, hashtag and search URLs are skipped with a warning and not charged, because Kuaishou only shows those pages to logged-in users. Duplicate inputs are merged. ### Output example Each video is one row. This is a real row, shortened only in the long URLs and the list of play URLs. ```json { "id": "5209257597142189348", "shortId": "3x23t55n9xbd2ac", "text": "你那个喜欢Spider Man的朋友 #蜘蛛侠 #铁粉 #蜘蛛侠单手撑地挑战 #TOP登陆少年组合重演唱会", "createTime": 1786336090843, "createTimeISO": "2026-08-10T04:28:10.000Z", "createDate": "10/08/2026", "url": "https://www.kuaishou.com/short-video/3x23t55n9xbd2ac", "photoType": "VIDEO", "thumb": "https://p2.a.yximgs.com/upic/2026/08/10/12/BMjAyNjA4MTAxMjI3NT...", "cover": "https://p2.a.yximgs.com/upic/2026/08/10/12/BMjAyNjA4MTAxMjI3NT...", "duration": 10, "durationMs": 10000, "width": 720, "height": 1280, "playUrl": "https://v23-3.kwaicdn.com/upic/2026/08/10/12/BMjAyNjA4MTAxMjI3...", "allPlayUrls": [ { "url": "https://v23-3.kwaicdn.com/upic/2026/08/10/12/BMjAyNjA4MTAxMjI3...", "format": "mp4", "qualityType": "720p", "qualityLabel": "高清", "videoCodec": "avc", "avgBitrate": 1486, "width": 720, "height": 1280, "fileSize": 1858694 } ], "images": [], "likeCount": 170311, "commentCount": 9328, "viewCount": 2928980, "forwardCount": 0, "hashtags": [ "蜘蛛侠", "铁粉", "蜘蛛侠单手撑地挑战", "TOP登陆少年组合重演唱会" ], "authorMeta": { "id": "5143886592", "name": "TOP登陆少年-左航", "username": "3x7vjxm6p58hb7e", "verified": true, "avatar": "https://p22.a.yximgs.com/uhead/AB/2025/11/14/19/BMjAyNTExMTQxO...", "gender": "unknown", "followersCount": 626104, "followingCount": 0, "photoCount": 46, "collectionCount": 10936, "url": "https://www.kuaishou.com/profile/3x7vjxm6p58hb7e" }, "musicMeta": { "id": "30261128268", "name": "TOP登陆少年-左航的作品原声", "artist": "TOP登陆少年-左航", "type": 9, "hasCopyright": true, "loudness": -15, "isOriginal": true, "audioUrl": "https://tx2.a.yximgs.com/bs2/ost/MjA0ODg0Mjc3Mjc4XzUxNDM4ODY1OTI.m4a", "coverUrl": "https://tx2.a.yximgs.com/bs2/ost/MjA0ODg0Mjc3Mjc4XzUxNDM4ODY1OTI.jpg", "usageCount": 2 }, "inputUrl": "https://www.kuaishou.com/short-video/3x23t55n9xbd2ac" } ``` ### How much does it cost to scrape Kuaishou? Kuaishou Scraper uses **pay-per-event** pricing. You pay for each video saved to your dataset, plus Apify's standard Actor start fee of $0.005 per run (per GB of memory; the default 256 MB counts as one). Compute and proxy costs are included in the price. Inputs that return nothing, such as a deleted video, an invalid link or an unsupported profile URL, are free. | Event | Free | Bronze | Silver | Gold | |-------|------|--------|--------|------| | Video (per 1,000) | $3.99 | $3.49 | $2.99 | $2.79 | On the Free plan, 1,000 Kuaishou videos cost $3.99, so 100 videos cost about $0.40. A run costs the price × (your input videos + recommended videos). Use **Max videos per run** or a maximum cost per run in Apify Console to cap it. The Actor stops cleanly when it reaches either limit. ### Use the Kuaishou API from Python or JavaScript Get your API token from [Apify Console](https://console.apify.com/settings/integrations), then call the Actor with the [Apify API client](https://docs.apify.com/api/client/python). **Python** ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("parsebird/kuaishou-scraper").call(run_input={ "startUrls": ["https://www.kuaishou.com/short-video/3x23t55n9xbd2ac"], "maxRecommendedVideos": 50, }) for video in client.dataset(run["defaultDatasetId"]).iterate_items(): print(video["text"], video["viewCount"], video["likeCount"], video["playUrl"]) ``` **JavaScript** ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('parsebird/kuaishou-scraper').call({ startUrls: ['https://www.kuaishou.com/short-video/3x23t55n9xbd2ac'], }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0].authorMeta.followersCount, items[0].allPlayUrls); ``` The full endpoint reference, including synchronous runs that return the dataset in one call, is on the [API tab](https://apify.com/parsebird/kuaishou-scraper/api). ### Use cases - **Influencer research.** Check a Kuaishou creator's followers, video count and the views and likes on their videos before you reach out. - **Campaign tracking.** Schedule runs on your campaign's video links and watch views, likes and comment counts grow day by day. - **Trend sampling.** Collect a few hundred videos from the recommended feed to see which captions, hashtags and sounds are popular on Kuaishou. - **Media archiving.** Save MP4 links, covers and audio files for the videos you track. - **Chinese-language research.** Collect captions and hashtags for NLP or sentiment analysis. ### How it works 1. Each input is recognised as a Kuaishou video. Share links are opened to find the video they point to, and duplicates are merged. 2. The Actor opens each video's public share page, the same page someone sees when a friend sends them a Kuaishou link, and reads the video data embedded in it. 3. If you asked for recommended videos, it reads the recommended feed kuaishou.com shows under the video and scrapes each of those videos the same way. 4. Rows are saved and charged as they come in. A run that Apify moves to another server resumes without duplicates. ### FAQ **Do I need a Kuaishou account, cookie or API key?** No. The Actor reads public data the way a logged-out visitor sees it. **Can it scrape a Kuaishou profile, hashtag or search results?** No. As of November 2026, Kuaishou shows profile video lists, hashtag pages and search results only to logged-in users. Logged-out visitors get a login prompt or a slider captcha instead. We tested this on the desktop site, the mobile site and live.kuaishou.com, from China, Hong Kong, Singapore, the US and Malaysia. This Actor doesn't log in or solve captchas, so those URLs are skipped and not charged. **Does it scrape Kuaishou comments?** No. Kuaishou asks logged-out visitors to solve a captcha before it shows comments, so this Actor doesn't offer comment text. Every row still includes `commentCount`. **Are the recommended videos related to my video?** Not necessarily. They come from the "recommended" feed Kuaishou shows under a video. For logged-out visitors that feed is a broad mix of popular videos, so a boxing video can bring back food, news and travel videos. Use it to sample popular Kuaishou content, not to find videos on one topic. **Can I download the videos?** Yes. `playUrl` is a direct MP4 link. Some links carry a signature from Kuaishou's video servers, so download them soon after the run rather than keeping the link for months. `allPlayUrls` lists the other renditions, including HLS (`.m3u8`) streams for players that support them. **Why is `musicMeta` empty for some videos?** Some videos have no music or original sound attached on Kuaishou. Then `musicMeta` is `null`. **Why did a video return nothing?** The video was deleted, made private or the link is wrong. The log lists it as "not found", and it isn't charged. **Can I schedule recurring runs?** Yes. Use [Apify Schedules](https://docs.apify.com/platform/schedules) to run hourly, daily or weekly. **Can I use it with Make, Zapier, Google Sheets or an AI agent?** Yes, through [Apify integrations](https://docs.apify.com/platform/integrations) and the [Apify API](https://docs.apify.com/api/v2). The Actor is also available to AI agents through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). **Something doesn't work. What should I do?** Open an issue on the [Issues tab](https://apify.com/parsebird/kuaishou-scraper/issues) with your run link. We read every report. ### Is it legal to scrape Kuaishou? This Actor only collects publicly available data that any logged-out visitor can see on a Kuaishou share page. It doesn't log in, solve captchas or access private content. Videos and creator profiles can still include personal data, which is protected by laws such as China's Personal Information Protection Law (PIPL) and the EU's GDPR. Don't scrape personal data unless you have a legitimate reason, and check Kuaishou's terms of service before you use the data. If you're unsure, consult a lawyer. Read more in Apify's guide: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) ### Related Actors | Actor | What it does | |-------|--------------| | [Kwai Scraper](https://apify.com/parsebird/kwai-scraper) | Kwai videos from profiles, playlists, links and keyword search, with transcripts and creator stats | | [Bilibili 哔哩哔哩 Scraper](https://apify.com/parsebird/bilibili-scraper) | Bilibili videos, comments, danmaku and UP主 profiles | | [TikTok Trends Scraper](https://apify.com/parsebird/tiktok-trends-scraper) | Trending hashtags and top videos from TikTok Creative Center, plus sounds, creators and videos from TikTok Explore by country | | [TikTok Sound Scraper](https://apify.com/parsebird/tiktok-sound-scraper) | TikTok sounds with usage counts, plus every video using the sound | | [TikTok Video Downloader](https://apify.com/parsebird/tiktok-video-downloader) | TikTok videos as MP4 from post URLs or short links | | [Instagram Reels Search & Trend Discovery](https://apify.com/parsebird/instagram-reels-search-scraper) | Instagram Reels by keyword with plays, likes, comments and captions | | [YouTube Shorts Downloader](https://apify.com/parsebird/youtube-shorts-downloader) | Direct media links and stats for YouTube Shorts | | [Video & Audio Transcriber](https://apify.com/parsebird/video-audio-transcriber) | Whisper transcripts and subtitles for video and audio from 1,800+ sites | # Changelog This Actor's version history is a separate document: https://apify.com/parsebird/kuaishou-scraper/changelog.md # Actor input Schema ## `startUrls` (type: `array`): Add Kuaishou video links, one per line, such as https://www.kuaishou.com/short-video/3x23t55n9xbd2ac. Mobile share links (v.kuaishou.com/…, m.gifshow.com/fw/photo/…, v.m.chenzhongtech.com/fw/photo/…) and bare video IDs (3x23t55n9xbd2ac or 5193776400231988498) also work. ## `maxRecommendedVideos` (type: `integer`): Set how many videos to add from the recommended feed Kuaishou shows under each input video. For logged-out visitors this feed is a broad mix of popular videos, not only the same topic, so use it to collect trending Kuaishou content. 0 scrapes only the videos you pasted. ## `maxItems` (type: `integer`): Set a ceiling on the total number of videos saved in this run, including recommended videos. Use 0 for no ceiling. ## `proxyConfiguration` (type: `object`): Not needed for normal use. Only set a proxy if Kuaishou starts refusing your runs. ## Actor input object example ```json { "startUrls": [ "https://www.kuaishou.com/short-video/3x23t55n9xbd2ac" ], "maxRecommendedVideos": 10, "maxItems": 0 } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 = { "startUrls": [ "https://www.kuaishou.com/short-video/3x23t55n9xbd2ac" ], "maxRecommendedVideos": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/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 = { "startUrls": ["https://www.kuaishou.com/short-video/3x23t55n9xbd2ac"], "maxRecommendedVideos": 10, } # Run the Actor and wait for it to finish run = client.actor("parsebird/kuaishou-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.kuaishou.com/short-video/3x23t55n9xbd2ac" ], "maxRecommendedVideos": 10 }' | apify call parsebird/kuaishou-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/kuaishou-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/THOzf2aXyvkMtH2mM/builds/MrVOeU85mKOkI6kaM/openapi.json