# Kuaishou Scraper (快手): Hot List, Videos & Comments, No Login (`bossless/kuaishou-scraper`) Actor

Scrape Kuaishou (快手) without login: the live hot list (热榜) with heat, video details (views, likes, comments, shares, caption, hashtags, duration) with the author's follower count, and comments. Optional own cookie for keyword search and creator videos (beta).

- **URL**: https://apify.com/bossless/kuaishou-scraper.md
- **Developed by:** [Alexander Daskalov](https://apify.com/bossless) (community)
- **Categories:** Social media, Videos
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 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 (快手): Hot List, Video Stats & Comments, No Login

**Scrape Kuaishou (快手), China's second-largest short-video app, without an account:**

- **the live hot list (快手热榜)**: rank, topic, heat ("1248.1万" and as a number) and the topic's videos;
- **video details**: views, likes, comments, shares, caption, hashtags, duration, upload time, cover and video file;
- **the creator of every video**: name, verified badge, **follower count (粉丝)**, following and number of videos;
- **comments**: text, likes, time and the commenter's region.

Optionally, add **your own Kuaishou cookie** to also get keyword search results and creator video lists (beta).

Use it to track what's trending in China, monitor creators and brands on Kuaishou, research KOLs by follower count, collect comments for sentiment analysis, or feed AI agents with Chinese short-video data.

### What data can you scrape from Kuaishou?

A video record. Real output from a run on 2026-10-14; long URLs shortened:

```json
{
  "id": "3xqf2nbqfikruck",
  "url": "https://www.kuaishou.com/short-video/3xqf2nbqfikruck",
  "caption": "#媒体原创  2027国考开始报名！好运锦鲤祝你梦想成真，成功上岸❤️",
  "hashtags": ["媒体原创"],
  "views": 58868,
  "likes": 1531,
  "comments": 18,
  "shares": 0,
  "durationSec": 7.8,
  "publishedAt": "2026-10-13T16:00:17+00:00",
  "coverUrl": "https://p23.a.yximgs.com/upic/…jpg",
  "videoUrl": "https://txmov2.a.kwimgs.com/upic/…mp4",
  "authorName": "人民网",
  "authorId": "3xnaukdq7fa8hx2",
  "authorUrl": "https://www.kuaishou.com/profile/3xnaukdq7fa8hx2",
  "authorVerified": true,
  "authorFollowers": 45146016,
  "authorFollowing": 9,
  "authorVideoCount": 29769,
  "hotTopic": "2027国考报名开启",
  "hotRank": 2,
  "source": "hot"
}
```

A hot-list topic (Topics dataset):

```json
{
  "rank": 2,
  "title": "2027国考报名开启",
  "heat": 12481000,
  "heatText": "1248.1万",
  "tag": "新",
  "tagEnglish": "new",
  "isPinned": false,
  "searchUrl": "https://www.kuaishou.com/search/video?searchKey=2027%E5%9B%BD%E8%80%83…",
  "videoIds": ["3xqf2nbqfikruck", "3xdgus35ka8bgru", "3xwhzaj7m8ggy5m"]
}
```

A comment (Comments dataset):

```json
{
  "videoId": "3xqszahw6awfh7g",
  "commentId": "1186092554498",
  "text": "[玫瑰][玫瑰][玫瑰]",
  "likes": 0,
  "publishedAt": "2026-10-14T01:32:10+00:00",
  "authorName": "大海65091",
  "authorArea": "山西"
}
```

| Dataset | Fields |
|---|---|
| **Videos** (default) | `id`, `photoId`, `url`, `caption`, `hashtags`, `views`, `likes`, `comments`, `shares`, `durationSec`, `publishedAt`, `mediaType`, `width`, `height`, `coverUrl`, `videoUrl`, `authorName`, `authorId`, `authorNumericId`, `authorUrl`, `authorAvatar`, `authorVerified`, `authorFollowers`, `authorFollowing`, `authorVideoCount`, `hotTopic`, `hotRank`, `source` |
| **Topics** | `rank`, `title`, `heat`, `heatText`, `tag`, `tagEnglish`, `isPinned`, `posterUrl`, `searchUrl`, `videoIds` |
| **Comments** | `videoId`, `commentId`, `text`, `likes`, `publishedAt`, `authorName`, `authorNumericId`, `authorArea`, `authorAvatar` (top-level comments; replies aren't included) |

`videoUrl` is a signed CDN link that expires after a while, so download the file soon if you need it.

### How much does it cost to scrape Kuaishou?

You pay per record, and there's no monthly fee.

| Event | Price (FREE/BRONZE) | Lower on paid plans |
|---|---|---|
| Video (all fields above, with the author's followers) | **$0.002** ($2 per 1,000) | down to $0.0016 |
| Hot topic | **$0.0005** ($0.50 per 1,000) | down to $0.0004 |
| Comment | **$0.0005** ($0.50 per 1,000) | down to $0.0004 |
| Actor start | $0.00005 per run | — |

Some examples:

- The whole hot list (about 50 topics) with one video each costs **$0.125**.
- The hot list alone costs **$0.025**.
- 1,000 comments cost **$0.50**.

Apify's maximum cost per run caps what you pay, and the actor stops cleanly when that limit is reached.

### How fast is it?

On the Apify platform:

- 10 hot topics, 10 videos and 42 comments took **48 seconds**;
- 3 topics, 4 videos and 12 comments took 30 seconds.

Videos are fetched 6 at a time. The data is light, about 10 KB per video.

### How to scrape Kuaishou

**The hot list and its videos** (the default):

```json
{"hotList": true, "maxTopics": 50, "videosPerTopic": 1}
```

**Specific videos, with comments.** Paste kuaishou.com/short-video/… links, v.kuaishou.com share links, m.gifshow.com/fw/photo/… links, or video IDs. When you give video links, keywords or creators, the hot list is off unless you set `hotList: true`:

```json
{"hotList": false, "videoUrls": ["https://www.kuaishou.com/short-video/3xqf2nbqfikruck"], "commentsPerVideo": 100}
```

**Hot topics only** (cheapest trend tracking; schedule it hourly or daily):

```json
{"hotList": true, "maxTopics": 50, "videosPerTopic": 0}
```

A deleted or private video doesn't fail the run. It is skipped, and the run's status message says how many weren't found.

### Search and creator videos with your own cookie (beta)

Kuaishou shows keyword search and creator video lists only to logged-in users; logged-out visitors get a captcha. This actor never solves or bypasses captchas. Instead, you can let it use **your own** logged-in session:

1. Log in to kuaishou.com in your browser.
2. Open the developer tools (F12) and go to **Network**. Reload the page, click any request to `www.kuaishou.com`, and copy the whole **Cookie** request header.
3. Paste it into **Your Kuaishou cookie**. It's stored as secret input and used only for your run.
4. Add **Search keywords** (for example `美食`) and/or **Creator profiles** (`https://www.kuaishou.com/profile/3x…`).

```json
{"hotList": false, "kuaishouCookie": "<your cookie>", "searchKeywords": ["美食"], "creatorUrls": ["https://www.kuaishou.com/profile/3xnaukdq7fa8hx2"], "maxVideosPerSource": 20}
```

The cookie is only used to list the video IDs. Every video is then read through the same no-login route as above, so you get the full record.

**Beta:** this part hasn't been tested with a real account yet. If Kuaishou asks your account for a captcha or rejects the cookie, the run still delivers everything else, and its status message tells you what to do (usually: open kuaishou.com, pass the check, and copy a fresh cookie). Use an account you're comfortable using for this.

### Use Kuaishou Scraper with AI agents (MCP)

```
https://mcp.apify.com?tools=bossless/kuaishou-scraper
```

Ask your assistant *"what's trending on Kuaishou right now, and who posted the top videos?"*. It runs this actor and reads back the hot list with each video's views and the creator's follower count.

### Use the Kuaishou API from code

```bash
curl -X POST "https://api.apify.com/v2/acts/bossless~kuaishou-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"hotList": true, "maxTopics": 20, "videosPerTopic": 1}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("bossless/kuaishou-scraper").call(run_input={"hotList": True, "maxTopics": 20, "videosPerTopic": 1})
for v in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(v["hotRank"], v["views"], v["authorName"], v["authorFollowers"], v["url"])
topics = client.dataset(run["storageIds"]["datasets"]["topics"]).list_items().items   # the hot list itself
```

### FAQ

**Do I need a Kuaishou account?** No, not for the hot list, video details or comments. Search and creator video lists need your own cookie (see above).

**Does it solve captchas?** No. It uses only what Kuaishou serves without a captcha. The cookie features use your own logged-in session.

**What is the heat number?** Kuaishou's own popularity score for a hot topic, shown like "1248.1万" (12.48 million). `heat` is the same value as a number; the pinned #1 topic has none.

**Is Kwai the same as Kuaishou?** Kwai is Kuaishou's international app (Brazil, Latin America, the Middle East), with separate content. This actor covers the Chinese app, Kuaishou (快手).

**Why is a video missing?** Deleted, private or under-review videos are skipped and counted in the status message as "not found".

**Is this an official Kuaishou product?** No. This is an independent tool and is not affiliated with or endorsed by Kuaishou or Kwai.

**Is it legal?** It reads publicly visible data. You are responsible for how you use it and for following Kuaishou's terms and the data-protection laws that apply to you, especially for commenters' data.

### More China data scrapers

- [Bilibili Scraper (B站 / 哔哩哔哩)](https://apify.com/bossless/bilibili-scraper): videos, danmaku, comments, trending and creators.
- [Weibo Scraper (微博)](https://apify.com/bossless/weibo-scraper): hot search, profiles, post search and timelines.
- [Zhihu Scraper (知乎)](https://apify.com/bossless/zhihu-scraper): Zhihu hot list, hot searches, column articles, answers and search.
- [Chinese Video Transcriber](https://apify.com/bossless/chinese-video-transcriber): Bilibili videos to text, English subtitles and SRT with AI.
- [China Hot Search in English](https://apify.com/bossless/china-hot-search): Weibo, Douyin, Baidu, Zhihu and Bilibili trending topics with English summaries.

***

#### 快手数据采集器（快手爬虫 / 快手热榜 API）

无需登录即可采集快手数据：

- **快手热榜**：排名、话题、热度及相关视频；
- **视频详情**：播放、点赞、评论、分享、标题、话题标签、时长、发布时间；
- **作者信息**：粉丝数、关注数、作品数、认证；
- **视频评论**：内容、点赞、时间、地区。

如需关键词搜索和博主作品列表，可填写您自己的快手 Cookie（测试版）。

按条计费：视频 $0.002，热榜话题与评论各 $0.0005。支持导出 JSON、CSV、Excel，也可通过 API 和 MCP 调用。

# Actor input Schema

## `hotList` (type: `boolean`):

Get Kuaishou's live hot list: rank, topic, heat and its videos. Goes to the Topics dataset. When left out, it is on only if no video links, keywords or creators are given.

## `maxTopics` (type: `integer`):

How many hot-list topics, from the top (up to ~50).

## `videosPerTopic` (type: `integer`):

Video details for each topic's videos (a topic has up to ~8). 0 = topics only.

## `videoUrls` (type: `array`):

Kuaishou videos to scrape: kuaishou.com/short-video/… links, v.kuaishou.com share links, m.gifshow.com/fw/photo/… links, or video ids (3x… or the long number).

## `commentsPerVideo` (type: `integer`):

Also get up to this many comments of every video. Goes to the Comments dataset. 0 = none.

## `kuaishouCookie` (type: `string`):

Paste the Cookie header from your own logged-in kuaishou.com browser session to unlock keyword search and creator videos. Leave empty to use only the guest features. You supply and own this cookie; it is stored as secret input. Beta: not yet tested with a real account.

## `searchKeywords` (type: `array`):

Videos for these search terms, e.g. 美食. Needs your cookie above.

## `creatorUrls` (type: `array`):

Latest videos of these creators: kuaishou.com/profile/… links or ids (3x…). Needs your cookie.

## `maxVideosPerSource` (type: `integer`):

How many videos to get for each search keyword and each creator.

## Actor input object example

```json
{
  "hotList": true,
  "maxTopics": 10,
  "videosPerTopic": 1,
  "commentsPerVideo": 0,
  "maxVideosPerSource": 20
}
```

# Actor output Schema

## `videos` (type: `string`):

No description

## `topics` (type: `string`):

No description

## `comments` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "hotList": true,
    "maxTopics": 10,
    "videosPerTopic": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("bossless/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "hotList": True,
    "maxTopics": 10,
    "videosPerTopic": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("bossless/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 '{
  "hotList": true,
  "maxTopics": 10,
  "videosPerTopic": 1
}' |
apify call bossless/kuaishou-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bossless/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 <APIFY_API_TOKEN>` 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/TncdXdvTTjQ9WjmiB/builds/0cL7NlakwkSBbTjgx/openapi.json