# Kuaishou Trending Tracker — 快手热榜 Hot Board API (`nexgendata/kuaishou-trending-tracker`) Actor

Track the Kuaishou hot board (快手热榜) — China's #2 short-video platform, where lower-tier-city consumer culture surfaces first. ~48 trending topics with rank, hot value, view count, category, hashtags & best-effort English. China short-video trend API for brand & consumer research. No login.

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

## Pricing

from $50.00 / 1,000 trending videos

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## 🇨🇳 Kuaishou Trending Tracker — 快手热榜 Hot Board API

Pull the Kuaishou hot board (快手热榜) — the live trending-topic rank for China's second-largest short-video platform, where lower-tier-city and rural consumer culture surfaces first. Each run returns roughly 48 trending topics with rank, hot value, view count, an auto-classified category, extracted hashtags, cover image and a direct video link, plus a best-effort English gloss. It's the short-video counterpart to Weibo hot search for teams tracking what's going viral beyond the Tier-1-city Douyin/Xiaohongshu bubble.

No login, no Chinese phone number, no Kuaishou API key — keyword-free hot board in, clean ranked rows out.

### 📊 Sample Output

[![Kuaishou Trending Tracker sample output — China short-video hot board with rank, hot value, view count and category for consumer-trend research](https://api.apify.com/v2/key-value-stores/8gLgXMBveEI1tTz1z/records/kuaishou-trending-tracker-sample)](https://apify.com/nexgendata/kuaishou-trending-tracker)

Real trending topics returned by this actor for **`mode: trending`** — every row below comes straight from a live run on the Chinese-language Kuaishou hot board (快手热榜):

| # | Trending Title (热榜) | Hot Value | Category |
|---|---|---|---|
| 1 | 传承弘扬遵义会议精神 | — | political |
| 2 | 荷兰2比2遭日本两度追平 | 1,327.5万 | social |
| 3 | 无偿献血证被倒卖牟利 | 1,257.0万 | social |
| 4 | "赛事+"激发消费活力 | 1,230.1万 | sports |
| 5 | 2026高考查分时间汇总 | 1,203.3万 | education |

> Each topic also carries a `view_count`, a `cover_image` thumbnail, a direct `video_url`, an English `title_english_translation`, a `rank_tag`, extracted `hashtags`, and `photo_ids` — ready for trend dashboards, social-listening pipelines, or Chinese-language RAG.

### What you get

The two modes return different shapes — read this before you wire up a pipeline.

**Trending mode (`mode: "trending"`, the reliable default)** pulls Kuaishou's `visionHotRank` board (~48 topics). Per topic you get:

- **Ranking** — `rank`, `rank_tag`, `hot_value` (numeric heat score), `hot_value_raw`
- **Topic** — `title` (Chinese), `title_english_translation`, `category` (social / sports / education / political / food …)
- **Reach** — `view_count`
- **Media** — `cover_image` (thumbnail URL), `video_url` (direct Kuaishou link), `photo_ids[]`
- **Context** — `hashtags[]`, `mode`, `data_source`, `as_of_timestamp`

> **Important — engagement & creator fields are NULL in trending mode.** The hot board does **not** expose per-video `like_count`, `comment_count`, `share_count`, `play_count`, or creator fields (`creator_name`, `creator_id`, `caption`, `duration`, `published_at`) — they are returned as `null`. Those fields are only populated by **search mode**, which queries individual videos. We never fabricate fields the source doesn't return.

**Search mode (`mode: "search"`, best-effort)** queries individual videos for a keyword and is the only mode that can populate `like_count`, `comment_count`, `share_count`, `play_count` and creator fields. Note Kuaishou frequently walls search behind browser security tokens, so it may return no results — trending is the dependable path.

### Sample input

```json
{
  "mode": "trending",
  "maxItems": 30,
  "includeTranslation": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

### 📊 Sample Output (JSON)

One representative trending-mode record — note the engagement/creator fields are `null` (only search mode fills them):

```json
{
  "mode": "trending",
  "rank": 1,
  "title": "某综艺名场面",
  "title_english_translation": "Variety show highlight",
  "caption": null,
  "category": "entertainment",
  "creator_name": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "play_count": null,
  "view_count": 12570000,
  "hot_value": 11200000,
  "hot_value_raw": "1120.0万",
  "video_url": "https://www.kuaishou.com/short-video/3xa567c9ykdb9be",
  "cover_image": "http://ws2.a.kwimgs.com/upic/2026/06/14/...",
  "hashtags": [],
  "photo_ids": ["3xa567c9ykdb9be"],
  "rank_tag": "hot",
  "data_source": "kuaishou.com/graphql visionHotRank",
  "as_of_timestamp": "2026-06-29T08:00:00Z"
}
```

### Input

| Input | Type | Description |
|---|---|---|
| `mode` | enum | `trending` (reliable hot board) or `search` (best-effort keyword video search; frequently walled). |
| `query` | string | Keyword/hashtag for `mode=search` (e.g. 美食, 旅游). Ignored in trending mode. |
| `maxItems` | integer | Hard cap on records returned (1–200). Hot board surfaces ~48 topics. |
| `includeTranslation` | boolean | Add `title_english_translation` (best-effort offline gloss). |
| `proxyConfiguration` | proxy | Apify proxy. RESIDENTIAL recommended. |

### How it works

Kuaishou (快手) serves its hot board through a GraphQL endpoint (`visionHotRank`) that rate-limits datacenter IPs. This actor routes through Apify residential proxy and reads the board directly — no brittle DOM scraping, no headless rendering. The `maxItems` cap is a hard ceiling. If every path is blocked the actor returns a single graceful maintenance-stub record so downstream pipelines never crash.

### 💰 Pricing example

Pay-Per-Event — you only pay for topics that land in your dataset:

- **Actor start:** $0.01
- **Per item:** $0.15

A 50-topic trend pull = $0.01 + (50 × $0.15) = **$7.51**. A quick 12-topic board check = **$1.81**. No monthly minimum, no seats.

### Use cases

- **Brand & marketing** — spot viral hashtags and challenges on the Kuaishou board to ride before peak.
- **Consumer research** — read lower-tier-city and rural consumer culture that Douyin and Xiaohongshu under-represent.
- **Social listening** — schedule the board for a daily trending time-series.
- **Creator/influencer marketing** — surface rising topics for KOL briefs.

### ❓ FAQ

**Does it need login?** No — the hot board path is public. A residential proxy is recommended.

**How many trending topics?** Around 48 per run, ranked by hot value.

**Can I search Kuaishou by keyword?** A best-effort search mode exists but is frequently walled by browser security tokens; trending is dependable.

**Does it return like/comment counts per video?** Only in (best-effort) search mode. The trending hot board returns rank, hot value, view count, category and hashtags — engagement and creator fields are `null` there.

**Kuaishou vs Douyin trending?** Kuaishou skews lower-tier-city and rural; pair it with the Douyin tracker for full coverage.

### 🔗 Related actors — China social

- [Weibo Hot Search Tracker](https://apify.com/nexgendata/weibo-hot-search-tracker) — the live Weibo 热搜 leaderboard as structured data
- [Douyin Trending Tracker](https://apify.com/nexgendata/douyin-trending-tracker) — the Tier-1-city short-video hot board
- [Bilibili Video Search](https://apify.com/nexgendata/bilibili-video-search) — search and rank Bilibili videos
- [China Trends Tracker](https://apify.com/nexgendata/china-trends-tracker) — trending across China's biggest platforms in one feed
- [RedNote (Xiaohongshu) Scraper](https://apify.com/nexgendata/rednote-scraper) — China's lifestyle/discovery platform

***

**Get free Apify credits & save 30% on platform fees:** <https://apify.com/nexgendata>

# Actor input Schema

## `mode` (type: `string`):

Which Kuaishou surface to pull. 'trending' (default) returns the live Kuaishou hot board (快手热榜 / visionHotRank) — ~48 trending topics with hot value, rank, cover image and rank tag. This is the reliable, low-cost path. 'search' attempts a keyword video search (visionSearchPhoto) returning individual videos with creator + engagement metrics; note Kuaishou frequently walls search behind browser security tokens (returns no results), so 'trending' is the dependable mode.

## `query` (type: `string`):

Keyword / hashtag to search Kuaishou videos for when mode='search'. Chinese keywords work best (e.g. 美食 for food, 旅游 for travel, 搞笑 for comedy). Ignored when mode='trending'. If mode='search' is selected but this is empty, the actor falls back to the trending hot board.

## `maxItems` (type: `integer`):

Maximum number of Kuaishou records to return per run. Each returned record is billed once (pay-per-result). The hot board surfaces ~48 trending topics; pulling all of them is typical for a daily China short-video monitoring run. Use a lower value for quick health checks.

## `includeTranslation` (type: `boolean`):

When true, adds a 'title\_english\_translation' field with a best-effort English rendering of each Chinese topic/caption (heuristic offline brand + common-phrase lookup, not full machine translation). Useful for non-Mandarin analysts who need a quick gist. Set false for minimal payloads.

## `proxyConfiguration` (type: `object`):

Apify proxy configuration. RESIDENTIAL is recommended — the hot board often works without a proxy, but Kuaishou search and proxy-gated retries are far more reliable from residential CN-egress IPs. If every path is blocked the actor returns a single graceful maintenance-stub record so downstream pipelines never crash.

## Actor input object example

```json
{
  "mode": "trending",
  "query": "美食",
  "maxItems": 15,
  "includeTranslation": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "mode": "trending",
    "query": "美食",
    "maxItems": 15,
    "includeTranslation": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/kuaishou-trending-tracker").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 = {
    "mode": "trending",
    "query": "美食",
    "maxItems": 15,
    "includeTranslation": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/kuaishou-trending-tracker").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 '{
  "mode": "trending",
  "query": "美食",
  "maxItems": 15,
  "includeTranslation": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call nexgendata/kuaishou-trending-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/kuaishou-trending-tracker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/FLfvZIyHMiZlWt9VS/builds/TpQCel0VpJg4XPP4p/openapi.json